⚡ EconomyProvider ⚡

A modern, fully configurable economy provider for Vault

---

💬 Clean Messages

Pay, receive, admin commands — all color-coded and configurable.

🏆 Baltop GUI

Leaderboard with player heads, ranks, and balance info.

💰 Banknotes

Physical money items — withdraw, trade, and right-click to redeem.

---

✨ What's Included

Core Economy

• Vault Provider — Registers as a Vault economy, works with every plugin that uses Vault
• Balance & Pay — /balance, /pay, /baltop — all the essentials, clean and fast
• Banknotes — Physical money items players can withdraw, trade, and deposit with right-click
• Baltop GUI — Leaderboard with player heads, ranks, and pagination
• Transaction Logging — Every balance change recorded to database with timestamps
• Anti-Dupe Banknotes — Every banknote has a unique ID verified on redemption — no duplication possible

For Server Owners

• Fully Configurable Currency — Name, symbol, position, decimals, thousands separator, format pattern
• Modular — Toggle pay, baltop, banknotes, transaction logging, and pay tax individually
• SQLite / MySQL / MariaDB — SQLite out of the box, switch to MySQL whenever
• LuckPerms Integration — Per-group starting balance, max balance, and pay limits
• PlaceholderAPI — Placeholders for scoreboards, tab lists, and holograms
• Discord Webhooks — Alerts for admin commands, large transactions, and banknote activity
• Migration Tool — Import from EssentialsX, CMI, and GemsEconomy
• Everything is Configurable — Every message, sound, GUI, icon, and color can be changed
• Folia Support — Works on Folia out of the box
• Anti-Exploit — Creative mode blocking, self-pay prevention, pay cooldowns, rate limiting

---

🔗 Part of the ilius Economy Ecosystem

EconomyProvider is the foundation of the ilius economy stack. Pair it with:

• AuctionHouse — Player-to-player marketplace with buy orders, price history, and container preview
• EconomyShop — Server shop with dynamic pricing, chest shops, and categories

All three plugins integrate seamlessly — same config style, same database support, same Discord. Use one or all three.

---

⌨️ Commands

Player

Command	Description
/balance [player]	Check your or another player's balance
/pay <player> <amount>	Send money to another player
/baltop	View the richest players (GUI)
/withdraw <amount>	Create a banknote item
/deposit	Right-click a banknote to redeem it

Admin

Command	Description
/eco give <player> <amount>	Give money
/eco take <player> <amount>	Take money
/eco set <player> <amount>	Set balance
/eco reset <player>	Reset to starting balance
/eco reload	Reload config and messages
/eco migrate <source>	Import from another economy plugin

---

🔑 Permissions

Permission	Description	Default
economyprovider.balance	Check balance	true
economyprovider.balance.others	Check others' balance	true
economyprovider.pay	Pay players	true
economyprovider.baltop	View leaderboard	true
economyprovider.withdraw	Create banknotes	true
economyprovider.deposit	Redeem banknotes	true
economyprovider.admin	All admin commands	op

---

📥 Setup

1. Drop the jar in plugins/ (requires Vault)
2. Restart
3. Edit plugins/EconomyProvider/config.yml if you want
4. /eco reload and you're good

Want MySQL instead of SQLite? Open config.yml, set storage.type to mysql, then fill in host, port, database, username, and password under the storage.mysql section. Restart and you're done.

---

📦 Requirements

• Paper 1.21+ (or Purpur, Folia)
• Vault
• Optional: LuckPerms, PlaceholderAPI, EconomyShop, AuctionHouse

---

💬 Need Help?

Join the Discord or open an issue.

---

🚀 Pro Edition — Coming Soon

Everything above, plus:

• Admin Dashboard with live economy stats and module toggles
• Transaction History GUI with filtering and pagination
• Multi-Currency support (Tokens, Gems, custom currencies)
• Economy Snapshots — daily tracking of total money supply and average balance
• Balance Change Alerts — Discord webhook when a player's balance spikes suspiciously
• Auto-Purge Scheduler for old transactions

Part of the ilius economy ecosystem. Built for servers that take their economy seriously.