💰 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 .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

Download eEconomy-0.0.1.jar from 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 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!

No gallery available for this project.

Version	Minecraft	Loader	Download
eEconomy 0.0.1 0.0.1	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.2	bukkit, folia, paper, spigot	Download