MCEconomy

MCEconomy
Real-Time Economy Analytics Dashboard for Minecraft Servers
Track every transaction. Diagnose inflation. Monitor your economy — from your browser.

⸻ THE PROBLEM ⸻

You've been running your server for weeks. Players are complaining that everything is too expensive — or too cheap. Someone's sitting on a mountain of cash. Your Jobs payouts feel wrong but you don't know which ones. You have no idea where money is actually coming from or going.
Sound familiar?
Most server owners discover economy problems after the damage is done — a reset, a rollback, a frustrated community.
MCEconomy gives you the data to act before it gets there.

⸻ WHAT IT DOES ⸻

MCEconomy captures every single money transaction on your server and presents it through a built-in web dashboard — no external services, no Node.js, no database setup. It's all inside the plugin.
Every time money moves — a job payment, a shop purchase, a quest reward, a crate opening, a salary tick — MCEconomy captures it and shows you:

Which plugins inject or drain money (Jobs, Shops, Quests, Crates, Salary, Admin commands)
How much money enters vs leaves the economy over time
Which players earn and spend the most
Which items are the biggest money faucets and sinks
Whether your economy is healthy — inflation, deflation, wealth inequality

⸻ FEATURES ⸻

Live Web Dashboard
Password-protected dashboard accessible from any browser. No external setup — just open the configured port and log in. Filter by 24h, 7 days, 30 days, or full history.
Economy Diagnosis Tool
The most powerful feature. One click gives you a full health report:

Health score with overall sentiment (Healthy / Expanding / Inflationary / Fragile)
Wealth concentration — top 1%, 5%, and 10% player share
Plain-language key findings and actionable recommendations
Per-source breakdown with transaction counts
Top earners, top spenders, biggest money sinks and sources

Automatic Source Detection
Every transaction is tagged with its origin plugin. MCEconomy wraps the Vault Economy provider to intercept every deposit/withdrawal at the source level — even from plugins with no dedicated hook.
Price Audit
Detects pricing imbalances before they break your economy. Find items with extreme buy/sell disparities and the biggest money faucets.
Player Profiles
Click any player to see their full income/expense breakdown by source.
Trade Titans Leaderboard
Top earners, top spenders, and most balanced players. Spot outliers instantly.
Multi-language
English + French included. Add your own locale file for any language.
Fully Configurable
Colors, currency format, time ranges, ignored players, retention — everything in one config.yml.

⸻ SUPPORTED PLUGINS ⸻

Auto-detected when present on your server:

Jobs Reborn — Job payment amounts
ShopGUI+ — Item buys/sells with item names and quantities
QuickShop-Hikari — Chest shop transactions
EconomyShopGUI — Admin shop buys/sells
zAuctionHouseV3 — Auction purchases (buyer + seller)
BeautyQuests — Quest rewards and costs
EssentialsX — /pay transfers, /eco admin commands
+ Any Vault-compatible plugin — Salary, crates, vote rewards, and more

The Vault wrapper automatically captures everything that deposits or withdraws money through Vault — even plugins MCEconomy doesn't have a specific hook for.

⸻ SETUP (2 MINUTES) ⸻

Drop MCEconomy-1.0.0.jar into your plugins/ folder
Restart your server
Run /mce password YourPassword
Open http://your-server-ip:8080 in your browser
Done. Data starts flowing immediately.

⸻ COMMANDS ⸻

Code:

/mce status              — Show hook status, transaction count, and dashboard URL
/mce password <pass>     — Set/change the dashboard password
/mce port <port>         — Change the web dashboard port
/mce reload              — Reload config without restart

All commands require mceconomy.admin permission (op by default).

⸻ REQUIREMENTS ⸻

Spigot / Paper 1.20+
Java 17+
Vault + any economy provider (EssentialsX Economy, CMI, etc.)

⸻ FAQ ⸻

Q: Does this affect server performance?
A: Minimal. All database writes are asynchronous. The web server runs on a separate thread. Most servers see no measurable TPS impact.
Q: Does it work with [plugin X]?
A: If the plugin uses Vault for economy operations, MCEconomy will capture it automatically through the Vault wrapper. The specific hooks add extra detail like item names and quantities.
Q: Can I access the dashboard remotely?
A: Yes, if the configured port is open/forwarded. The dashboard is password-protected with bcrypt-hashed credentials.
Q: Is the data persistent across restarts?
A: Yes. Data is stored in SQLite at plugins/MCEconomy/economy.db. It survives restarts and JAR updates.
Q: Can I change the language?
A: Yes. Set language: "fr" in config.yml for French, or drop your own locale file into the locales folder.
Q: Can I ignore admin accounts?
A: Yes. Add player names or UUIDs to the ignored-players list in config.yml.
Q: How does it detect which plugin caused a transaction?
A: Stack trace analysis at the Vault provider level. Each deposit/withdrawal call is traced back to its calling plugin. Specific hooks for popular plugins add additional metadata.

⸻ SUPPORT ⸻

Discord: MCEconomy Discord
GitHub: Issue Tracker
Response time: Within 24 hours

MCEconomy v1.0

Overview History