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. 💼✨