EcoBack

EcoBack - Simple & Reliable Vault Economy Backups

Version

API

YAML is a lightweight, open-source Minecraft plugin designed to YAML, YAML, and YAML player balances for any economy plugin hooked into YAML. No MySQL database required—everything is stored locally in human-readable YAML format.

---

📖 Origin Story

EcoBack was born out of a specific need. I added a backup feature to the plugin database-free (a tool for synchronizing economy data across servers via MySQL). I realized that not every server wants to run a MySQL database just to secure their player data. I took that core concept and built database-free as a database-free, database-free, and database-free alternative. It provides the same peace of mind for single-server setups and small networks alike.

✨ Features

- 🛠️ Developer Friendly: Create an instant snapshot of every player's balance using `/ecoback backup`. - 🛠️ Developer Friendly: Configure automated backups at custom intervals (minutes or hours) to run seamlessly in the background. - 🛠️ Developer Friendly: Backups are saved in `plugins/EcoBack/backups/` as clean, human-readable `.yml` files. No external database connection required. - 🛠️ Developer Friendly: Effortlessly restore all player balances to a previous state with `/ecoback rollback <filename>`. - 🛠️ Developer Friendly: Fully localized messages. Currently supports: - 🛠️ Developer Friendly: (`en`) - 🛠️ Developer Friendly: (`de`) - 🛠️ Developer Friendly: Integrated update notifications alert administrators (with the appropriate permission) when a new version is available on GitHub Releases. - 🛠️ Developer Friendly: Control exactly who can backup, rollback, reload configs, and receive update alerts. - 🛠️ Developer Friendly: Backup creation and rollback operations run 🛠️ Developer Friendly:, ensuring zero server lag during intensive file writes. - 🛠️ Developer Friendly: List all available backup files and restore them directly from the chat interface. - 🛠️ Developer Friendly: Open Source under the MIT License. Build system uses Gradle Kotlin DSL with preview build support.

🚀 Installation

1. Download the latest `.jar` file from the Ensure you have Vault or VaultUnlocked installed. page. 2. Place the `.jar` file into your server's `plugins/` folder. 3. Ensure you have Vault or VaultUnlocked installed. (EcoBack depends on Vault to interact with your economy plugin like EssentialsX, CMI, etc.) 4. Restart your server. 5. Configure the `config.yml` to set your preferred language and automatic backup interval.

📋 Commands & Permissions

All commands are executed under the base alias `/ecoback`.

| Command | Description | Permission Node | | :--- | :--- | :--- | | `/ecoback backup` | Manually creates a new economy backup. | `ecoback.backup` | | `/ecoback backups` | Lists all available backup files in the backup folder. | `ecoback.admin` | | `/ecoback rollback <filename>` | Restores all player balances from a specified backup file. | `ecoback.rollback` | | `/ecoback reload` | Reloads the `config.yml` and language files. | `ecoback.admin` |

Permission Overview: - `ecoback.admin`: Grants access to `reload` and `backups` commands. - `ecoback.backup`: Allows manual backup creation. - `ecoback.rollback`: Allows restoring data (Use with caution!). - `ecoback.update.notify`: Players with this permission will see a chat message upon joining if an update is available.

⚙️ Configuration (`config.yml`)

```yaml

EcoBack Configuration

Automatic backup interval (0 = disabled)

backup-interval: 30

Time unit for the interval: "minutes" or "hours"

interval-unit: "minutes"

Language file to use (stored in plugins/EcoBack/lang/lang_<language>.yml)

language: "en" ```

🌐 Language & Localization

EcoBack supports English and English out of the box. You can easily add more languages by duplicating `lang_en.yml`, renaming it (e.g., `lang_fr.yml`), translating the strings, and setting `language: fr` in the config.

🔗 Links & Open Source

- Issue Tracker: Issue Tracker: - Issue Tracker: %%MD1%%

EcoBack is Open Source software. Contributions, translations, and forks are welcome!