# ElderVault 💎 A lightweight and feature-rich economy plugin for **Paper/Purpur/Spigot** servers, built around **two currencies**, smooth storage, clean commands, and deep integration with the Minecraft plugin ecosystem. ## ✨ What ElderVault gives you * **Two fully configurable currencies**: `Ether` and `Runites` * **Vault support** for the main economy currency * **PlaceholderAPI support** for balance and leaderboard placeholders * **Leaderboard GUI** for fast in-game economy tracking * **Player and admin commands** for complete money control * **Local database storage** with **H2** or **SQLite** * **Balance caching** and **leaderboard caching** for better performance * **Public API** for developers and addon plugins * **Cancellable balance change events** for advanced integrations ## 🪙 Currencies ElderVault is built around two independent currencies: * **Ether** — the main economy currency, also exposed through Vault * **Runites** — a second configurable currency for custom server systems, shops, rewards, or progression mechanics Each currency has its own: * display name * symbol * initial balance * max balance * decimal formatting * enable/disable toggle ## 🎮 Commands ### Player commands * `/balance [player]` — view Ether balance * `/runites [player]` — view Runites balance * `/pay <player> <amount> [currency]` — transfer money to another player * `/balancetop [currency] [page]` — view the leaderboard ### Admin commands * `/ec give <player> <currency> <amount> [reason...]` * `/ec take <player> <currency> <amount> [reason...]` * `/ec set <player> <currency> <amount> [reason...]` * `/ec reset <player> [currency] [reason...]` * `/ec reload` * `/ec purge confirm` * `/ec top` ## 🧩 Integrations ### Vault ElderVault exposes **Ether** through Vault so it can be used by other economy plugins, shops, and supported systems. ### PlaceholderAPI Use economy placeholders in scoreboards, chat, GUIs, and more. Examples: * `%ec_ether%` * `%ec_runites%` * `%ec_ether_formatted%` * `%ec_runites_formatted%` * `%ec_top_ether_1%` * `%ec_top_runites_1%` ## 🗄️ Storage Choose the database backend that fits your server: * **H2** for simple embedded storage * **SQLite** for compact file-based persistence ElderVault is designed to keep economy data stable and fast, with caching used to reduce unnecessary database access. ## 🖥️ Leaderboard GUI Open a clean in-game leaderboard interface to browse the richest players for each currency. * currency selection menu * paginated top list * refresh button support * player-head entries * optimized cached data display ## 🛠️ Developer API ElderVault includes a public API for advanced integrations. Use it to: * read balances * add or subtract funds * transfer currency * react to balance changes * build custom systems on top of the economy ## 🔧 Requirements * **Java 21** * **Paper 1.21.x** or a compatible server * **Vault** required * **PlaceholderAPI** optional ## 📦 Installation 1. Download `ElderVault.jar` 2. Put it into your server’s `plugins/` folder 3. Install **Vault** 4. Install **PlaceholderAPI** if you want placeholders 5. Start the server 6. Edit `config.yml` and `messages.yml` 7. Reload or restart the server ## 🌟 Why choose ElderVault? ElderVault is a strong choice if you want: * a **modern dual-currency economy** * **clean command handling** * **easy plugin integration** * **leaderboards and GUI support** * **fast, cached economy access** * a system that feels flexible without being bloated --- **ElderVault** keeps your economy organized, configurable, and ready for expansion. 💼✨