EzEconomy

**EzEconomy** is a modern, fast, and flexible Vault economy provider for Minecraft servers. Supports YML, MySQL, SQLite, MongoDB, and custom storage. Multi-currency, async caching, and robust permissions for any server size. Proven to be to 50x faster then other populair economy plugins. !(https://i.ibb.co/jvx09srX/ez-economy-plugin-header.png) **Available languages**: English, Español, Nederlands, 中国人, Français (https://i.ibb.co/dskCvgLP/documentation-button-1.png)](https://github.com/ez-plugins/EzEconomy/blob/main/README.md) (https://i.ibb.co/Wpy2w1cH/support-button-1.png)](https://discord.gg/yWP95XfmBS) --- ## ★ Our key economy features EzEconomy is built for performance, flexibility, and ease of use. Highlights include: - **Vault API compatible**: Works with any Vault-based plugin - **YML, MySQL, SQLite, MongoDB, or custom storage**: Flexible, production-ready storage options - **Thread-safe**: Robust error handling and concurrency - **Multi-currency support**: Optional, per-player, fully configurable - **Async caching**: Optimized for large servers - **Comprehensive commands**: `/balance`, `/eco`, `/baltop`, `/bank`, `/pay`, `/currency` - **Granular permissions**: Per-command and per-bank action --- ## ⚡ Commands - **/balance**: View your balance - **/balance <player>**: View another player's balance (`ezeconomy.balance.others`) - **/eco <give|take|set> <player> <amount>**: Admin control (`ezeconomy.eco`) - **/eco gui**: Show balance GUI - **/baltop **: Show top balances - **/bank <create|delete|balance|deposit|withdraw|addmember|removemember|info> ...**: Bank management (`ezeconomy.bank.*`) - **/pay <player> <amount>**: Pay another player (`ezeconomy.pay`) - **/currency **: Set or view your preferred currency (`ezeconomy.currency`) - **/ezeconomy cleanup**: Remove orphaned player data (`ezeconomy.admin`) - **/ezeconomy daily reset**: Reset all daily rewards (`ezeconomy.admin`) - **/ezeconomy reload**: Reload plugin configuration (`ezeconomy.admin`) - **/ezeconomy reload messages**: Reload only the message file (`ezeconomy.admin`) - **/ezeconomy database info**: Show database connection info (`ezeconomy.admin`) - **/ezeconomy database test**: Test the database connection (`ezeconomy.admin`) - **/ezeconomy database reset**: Reset all database tables (DANGEROUS) (`ezeconomy.admin`) - **/tax**: Removed — tax functionality moved to EzTax (https://modrinth.com/plugin/eztax) --- ## 🛡️ Permissions - `ezeconomy.balance.others`: View other players' balances - `ezeconomy.eco`: Use /eco admin command - `ezeconomy.pay`: Use /pay command - `ezeconomy.currency`: Use /currency command - `ezeconomy.admin`: Use /ezeconomy admin commands (cleanup, reload, database, daily reset) - **Bank Permissions**: - `ezeconomy.bank.create`: Create a new bank - `ezeconomy.bank.delete`: Delete a bank - `ezeconomy.bank.balance`: View bank balance - `ezeconomy.bank.deposit`: Deposit to a bank - `ezeconomy.bank.withdraw`: Withdraw from a bank - `ezeconomy.bank.addmember`: Add a member to a bank - `ezeconomy.bank.removemember`: Remove a member from a bank - `ezeconomy.bank.info`: View bank info - `ezeconomy.bank.admin`: All bank admin actions --- ## ⚙️ Configuration Example ### `config.yml` (Only global settings): ```yaml storage: yml multi-currency: enabled: false default: "dollar" currencies: dollar: display: "Dollar" symbol: "$" decimals: 2 euro: display: "Euro" symbol: "€" decimals: 2 # Tax configuration has been removed from EzEconomy and moved to EzTax. # EzTax on Modrinth: https://modrinth.com/plugin/eztax conversion: dollar: euro: 0.95 gem: 0.01 euro: dollar: 1.05 gem: 0.012 gem: dollar: 100 euro: 80 ``` ### `config-yml.yml` (YML storage settings): ```yaml yml: file: balances.yml per-player-file-naming: uuid data-folder: data ``` ### `config-mysql.yml` (MySQL storage settings): ```yaml mysql: host: localhost port: 3306 database: ezeconomy username: root password: password table: balances ``` ### `config-sqlite.yml` (SQLite storage settings): ```yaml sqlite: file: ezeconomy.db table: balances banksTable: banks ``` ### `config-mongodb.yml` (MongoDB storage settings): ```yaml mongodb: uri: mongodb://localhost:27017 database: ezeconomy collection: balances banksCollection: banks ``` --- ## ⬇️ Installation 1. Place `EzEconomy.jar` in your plugins folder 2. Configure `config.yml` and the appropriate `config-*.yml` file for your storage type 3. Restart your server --- ## 🔗 Integration - EzEconomy automatically registers as a Vault provider - No extra setup required for Vault-compatible plugins - **PlaceholderAPI support**: - Use placeholders in chat, scoreboard, and other plugins: - `%ezeconomy_balance%` – Your balance - `%ezeconomy_bala