eEconomy
High-performance multi-currency economy engine with interactive GUIs for Paper & Folia.
440обновлён 16 сент. 2026 г.
ЭкономикаУправлениеУтилиты
Описание
💰 eEconomy
The Modern, High-Performance Multi-Currency Economy Engine for Paper & Folia
Overview • Features • GUI Showcase • Commands • Placeholders • Installation • Donate
🌟 Overview
eEconomy is a state-of-the-art multi-currency economy engine engineered from the ground up for modern Paper, Purpur, and multi-threaded Folia servers.
Tired of clunky single-currency plugins, database lockups, and economy duplication bugs? eEconomy provides an enterprise-grade solution featuring unlimited independent currencies, dynamic command generation, interactive chest GUIs with audio feedback (SFX), and cross-server Redis synchronization.
Whether you run an SMP, Survival, Skyblock, Prison, or multi-server Network, eEconomy delivers bank-grade reliability with atomic database transactions and anti-deadlock concurrency controls.
🚀 Key Features
🪙 Unlimited Dynamic Multi-Currencies
- Create any number of isolated or interconnected currencies (
Coins,Gems,Event Tokens,Crystals, etc.) simply by adding a.ymlfile incurrencies/. - Configure per-currency properties: display names, symbols, decimal precision, min/max transaction limits, starting balance, transfer permissions, and transfer taxes.
⚡ Auto-Generated Per-Currency Commands
- When you add a currency like
gems.yml, the plugin automatically registers a full command tree at startup:/gems— Check personal gem balance./gems balance <player>— Inspect another player's gems./gems pay <player> <amount>— Send gems with transfer validation and taxes./gems top [page]— View gem leaderboard rankings./gems give|take|set <player> <amount>— Dedicated administrative management.
🏆 Interactive Baltop Matrix GUI & Wallet
- Rich Baltop GUI (
/baltop): 6-row chest menu complete with category tabs for switching currencies, pagination, player head skins with lore, rank badges, and responsive SFX. - Unified Wallet GUI (
/wallet): An intuitive inventory overview displaying all registered currencies and balances owned by the player.
🔊 Dynamic Audio Feedback (SFX)
- Elevate the player experience with satisfying audio cues:
- Upbeat chime upon sending/receiving payments.
- Page-turn rustle when navigating leaderboard pages.
- Subtle click feedback when toggling currency tabs.
- Distinct error buzz when funds are insufficient or transactions fail.
🔒 Bank-Grade Anti-Dupe & Concurrency Protection
- Anti-Deadlock Ordered Locking: Dual-player transfers acquire locks based on UUID lexicographical ordering, eliminating circular wait conditions (Dining Philosophers problem).
- Atomic Transactions: Zero race conditions during rapid spam transactions or network spikes.
- Safe Asynchronous I/O: Balance changes are processed in memory with atomic guarantees, while database logs and balance flushes run off the main thread.
🗄️ Enterprise Multi-Database & Redis Network Sync
- Powered by shaded HikariCP 6.2.0 connection pooling.
- Supports SQLite (out-of-the-box zero setup), MySQL, MariaDB, PostgreSQL, and H2.
- Redis Pub/Sub Synchronization: Instantly invalidates and synchronizes player balance caches across Velocity / BungeeCord proxy networks.
🧩 Seamless Ecosystem Integration
- Vault API: Acts as the primary Vault economy provider out-of-the-box.
- PlaceholderAPI (PAPI): Extensive placeholders for balance display, formatted currencies, compact numbers (
1.5k,10M), and top rank placements. - Bedrock Edition Friendly: Compatible with Geyser & Floodgate, automatically sanitizing typography for Bedrock mobile/console clients.
🎮 Interactive GUI Showcase
📊 Baltop Leaderboard GUI (/baltop)
- Category Navigation (Top Row): Click currency icons (
Coins,Gems,Tokens) to instantly switch leaderboards. - Player Head Placement (Rows 2–5): Top 10 richest players displayed as real player skulls with custom rank tags and formatted balances.
- Page Controls (Bottom Row): Previous Page, Refresh Leaderboard, and Next Page navigation with sound effects.
💼 Wallet GUI (/wallet)
- Centralized dashboard displaying all server currencies in designated slots with custom materials and live balance formatting.
⌨️ Commands & Permissions
👤 Player Commands
| Command | Aliases | Permission | Description |
|---|---|---|---|
/balance [player] | /bal, /money | eeconomy.command.balance | Check your balance or another player's primary balance |
/pay <player> <amount> | — | eeconomy.command.pay | Transfer primary currency to another player |
/paytoggle | — | eeconomy.command.paytoggle | Toggle incoming payment requests on or off |
/baltop [page] [currency] | /topbalance | eeconomy.command.baltop | Open the Baltop leaderboard GUI or view chat list |
/wallet | — | eeconomy.command.wallet | Open the multi-currency personal wallet GUI |
/<currency> <subcommand> | — | eeconomy.currency.<id> | Dedicated command suite for each custom currency |
🛠️ Admin Commands
| Command | Permission | Description |
|---|---|---|
/eco give <player> <amount> [currency] | eeconomy.admin | Give currency to a player |
/eco take <player> <amount> [currency] | eeconomy.admin | Deduct currency from a player |
/eco set <player> <amount> [currency] | eeconomy.admin | Set a player's balance to an exact amount |
/eco reset <player> [currency] | eeconomy.admin | Reset balance back to starting default |
/eco purge <days> | eeconomy.admin | Purge transaction audit logs older than specified days |
/eco reload | eeconomy.admin | Hot-reload all configuration files and currencies |
🧩 PlaceholderAPI Placeholders
| Placeholder | Description | Example Output |
|---|---|---|
%eeconomy_balance% | Raw primary currency balance | 12500.50 |
%eeconomy_balance_formatted% | Primary balance with symbol & separators | $12,500.50 |
%eeconomy_balance_compact% | Primary balance with compact suffix | 12.5k |
%eeconomy_balance_<currency>% | Raw balance for custom currency | 50 |
%eeconomy_balance_formatted_<currency>% | Formatted balance for custom currency | 50 💎 |
%eeconomy_top_name_<currency>_<pos>% | Username at rank position | epromite |
%eeconomy_top_balance_<currency>_<pos>% | Balance at rank position | $1,000,000 |
📥 Installation
- Download
eEconomy-0.0.1.jarfrom Modrinth. - Place the jar file into your server's
plugins/folder. - (Optional) Install Vault and PlaceholderAPI for economy hooks.
- Restart your server.
- Customize default currencies in
plugins/eEconomy/currencies/and adjust messages inplugins/eEconomy/messages/.
💖 Support the Developer
If you love eEconomy and want to support continued development:
- 🇮🇩 Trakteer (IDR): https://trakteer.id/epromite/tip
- 🌎 Ko-fi (USD): https://ko-fi.com/epromite/tip
- ⭐ Star the Project on GitHub & Modrinth!
Последние версии
Все версии →release
eEconomy 0.0.1
0.0.116 сент. 2026 г.44Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2bukkit, folia, paper, spigot
Что нового
# 🚀 eEconomy v0.0.1-RELEASE — Initial Release
Welcome to the first official release of **eEconomy** for Paper, Purpur, and Folia (1.21+)!
### ✨ Highlights
* **Dynamic Multi-Currency Engine:** Create unlimited independent currencies (`Coins`, `Gems`, `Event Tokens`, etc.) by simply dropping `.yml` files into the `currencies/` folder.
* **Auto-Registered Currency Commands:** Each registered currency automatically gets dedicated commands at runtime (e.g. `/gems balance`, `/gems pay`, `/gems top`, `/gems give`, `/gems take`, `/gems set`).
* **Rich Chest GUI System:**
* **Baltop Matrix GUI:** 6-row interactive leaderboard featuring category tabs for switching currencies, pagination, player head skins, rank placements, and custom decorations.
* **Wallet GUI (`/wallet`):** Instant overview of all player-owned balances in a unified, beautifully styled inventory.
* **Dynamic Audio Feedback (SFX):** Satisfying sound effects for payments, incoming transfers, balance checks, rank pagination, and transaction errors.
* **Enterprise Multi-Storage:** High-performance database layer powered by shaded **HikariCP 6.2.0** supporting **SQLite** (zero-setup default), **MySQL**, **MariaDB**, **PostgreSQL**, and **H2**.
* **Cross-Server Redis Sync:** Native Redis Pub/Sub support for instant balance cache synchronization across multi-proxy Bungee/Velocity networks.
* **Native Folia Multi-Threading:** Complete thread safety using asynchronous I/O and synchronous Bukkit/Folia event dispatching with zero main-thread stalls.
* **Bank-Grade Anti-Dupe & Concurrency Protection:** Anti-deadlock ordered UUID locking on transfers, atomic balance updates, and strict double-spend guards.
* **Seamless Integrations:** Full support for **Vault API**, **PlaceholderAPI** (`%eeconomy_balance%`, `%eeconomy_top_*%`), and **Geyser/Floodgate** Bedrock player sanitization.
* **Modern MiniMessage Aesthetics:** Vibrant gradient formatting, compact number abbreviations (`1k`, `1.5M`, `2.4B`), and clean formatting.
---
### 🔗 Links
* 📖 **Documentation:** [https://epromc.gitbook.io/eeconomy](https://epromc.gitbook.io/eeconomy)
* 🐛 **Issues & Feedback:** [GitHub Issues](https://github.com/epromc/eEconomy/issues)
* 💖 **Donate:** [Trakteer](https://trakteer.id/epromite/tip) • [Ko-fi](https://ko-fi.com/epromite/tip)