EcoBack - Simple & Reliable Vault Economy Backups

EcoBack is a lightweight, open-source Minecraft plugin designed to backup, restore, and manage player balances for any economy plugin hooked into Vault. 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 BalSync (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 EcoBack as a standalone, lightweight, and database-free alternative. It provides the same peace of mind for single-server setups and small networks alike.

✨ Features

• 💾 On-Demand Backups: Create an instant snapshot of every player's balance using /ecoback backup.
• ⏱️ Automatic Scheduling: Configure automated backups at custom intervals (minutes or hours) to run seamlessly in the background.
• 📂 Local YAML Storage: Backups are saved in plugins/EcoBack/backups/ as clean, human-readable .yml files. No external database connection required.
• 🔄 Instant Rollback: Effortlessly restore all player balances to a previous state with /ecoback rollback <filename>.
• 🌍 Multi-Language Support: Fully localized messages. Currently supports:
  • English (en)
  • German (de)
• 🔔 Update Checker: Integrated update notifications alert administrators (with the appropriate permission) when a new version is available on GitHub Releases.
• 🔒 Granular Permissions: Control exactly who can backup, rollback, reload configs, and receive update alerts.
• ⚡ Asynchronous Processing: Backup creation and rollback operations run asynchronously, ensuring zero server lag during intensive file writes.
• 📋 In-Game Management: 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 Modrinth 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)

# 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 German 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

• GitHub Repository: https://github.com/deutschich/EcoBack
• Issue Tracker: Report a Bug or Request a Feature

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