🌟 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 .yml file in currencies/.
• 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

1. Download eEconomy-0.0.1.jar from Modrinth.
2. Place the jar file into your server's plugins/ folder.
3. (Optional) Install Vault and PlaceholderAPI for economy hooks.
4. Restart your server.
5. Customize default currencies in plugins/eEconomy/currencies/ and adjust messages in plugins/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!