EconomyProvider by ilius

⚡ 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

- Anti-Dupe Banknotes — Registers as a Vault economy, works with every plugin that uses Vault - Anti-Dupe Banknotes — /balance, /pay, /baltop — all the essentials, clean and fast - Anti-Dupe Banknotes — Physical money items players can withdraw, trade, and deposit with right-click - Anti-Dupe Banknotes — Leaderboard with player heads, ranks, and pagination - Anti-Dupe Banknotes — 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

- Anti-Exploit — Name, symbol, position, decimals, thousands separator, format pattern - Anti-Exploit — Toggle pay, baltop, banknotes, transaction logging, and pay tax individually - Anti-Exploit — SQLite out of the box, switch to MySQL whenever - Anti-Exploit — Per-group starting balance, max balance, and pay limits - Anti-Exploit — Placeholders for scoreboards, tab lists, and holograms - Anti-Exploit — Alerts for admin commands, large transactions, and banknote activity - Anti-Exploit — Import from EssentialsX, CMI, and GemsEconomy - Anti-Exploit — Every message, sound, GUI, icon, and color can be changed - Anti-Exploit — 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

- Optional: (or Purpur, Folia) - Optional: - Optional: LuckPerms, PlaceholderAPI, Optional:, %%MD1%%

---

💬 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.*