# ⚡ EconomyProvider ⚡ **A modern, fully configurable economy provider for Vault** ![Minecraft](https://img.shields.io/badge/Minecraft-1.21+-brightgreen?style=for-the-badge) ![Paper](https://img.shields.io/badge/Paper-Supported-blue?style=for-the-badge) ![Folia](https://img.shields.io/badge/Folia-Compatible-purple?style=for-the-badge) ![Database](https://img.shields.io/badge/SQLite%20%7C%20MySQL%20%7C%20MariaDB-orange?style=for-the-badge) --- ### 💬 Clean Messages Pay, receive, admin commands — all color-coded and configurable. ![Messages](https://i.imgur.com/rvzoAA9.jpeg) ### 🏆 Baltop GUI Leaderboard with player heads, ranks, and balance info. ![Baltop](https://i.imgur.com/2LGQlx2.jpeg) ### 💰 Banknotes Physical money items — withdraw, trade, and right-click to redeem. ![Banknote](https://i.imgur.com/KWHS2e0.jpeg) --- ## ✨ 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**](https://modrinth.com/plugin/auctionhouse-by-ilius) — Player-to-player marketplace with buy orders, price history, and container preview - [**EconomyShop**](https://modrinth.com/plugin/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 ` | Send money to another player | | `/baltop` | View the richest players (GUI) | | `/withdraw ` | Create a banknote item | | `/deposit` | Right-click a banknote to redeem it | **Admin** | Command | Description | |---|---| | `/eco give ` | Give money | | `/eco take ` | Take money | | `/eco set ` | Set balance | | `/eco reset ` | Reset to starting balance | | `/eco reload` | Reload config and messages | | `/eco migrate ` | 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](https://modrinth.com/plugin/economyshop), [AuctionHouse](https://modrinth.com/plugin/auctionhouse-by-ilius) --- ## 💬 Need Help? Join the [Discord](https://discord.gg/ns3q9ejGwR) 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.*

iliusIsOk