ClipsEZEconomy

Overview

ClipsEZEconomy is a modern emerald-based economy plugin designed for servers that want a clean, physical-item economy without virtual money.

It features a polished GUI banking system, safe emerald handling, fully customizable messages, admin economy tools, and a developer-friendly API — all while remaining lightweight and dependency-free.

Perfect for SMPs, community servers, and semi-vanilla survival.

---

💠 Features

🏦 GUI Bank System

* `/bank` opens an intuitive bank menu * Deposit emeralds from your inventory * Withdraw emeralds from your bank balance * Chat-based amount input (`number`, `all`, or `cancel`) * Inventory-safe withdrawals (prevents item loss) * Optional emerald dropping if inventory is full * Fully configurable GUI titles, names, and lore * Auto-reopen GUI after actions (toggleable)

---

💰 Player Balances

* Players can check their balance using: * `/bal` * `/balance` * Check another player's balance: * `/balance <player>` * UUID-based economy (offline-safe) * No virtual currency — real emeralds only

---

🔧 Admin Economy Tools

Manage player balances directly: * `/eco set <player> <amount>` * `/eco add <player> <amount>` * `/eco take <player> <amount>`

Useful for: * Rewarding players * Adjusting balances * Fixing errors * Running events

Requires permission: `clipsezeconomy.admin`

---

🏆 Baltop Leaderboard

* Show the richest players on the server: * `/baltop` * Displays the Top 5 players with the highest emerald balances * Works even if players are offline * Fully customizable formatting in `config.yml`

---

📝 Fully Customizable Messages

* Every message used by the plugin can be changed in `config.yml`, including: * Prefix * Chat prompts * Success / error messages * GUI text * Reload messages * Colors (supports HEX) * Default prefix uses a gold gradient for a premium feel

---

🗄 Persistent & Safe Storage

* Player balances stored in: * `plugins/ClipsEZEconomy/balances.yml` * Automatic periodic autosaving * Crash-safe saving strategy * No player progress loss on updates

---

⚙️ API for Developers

Other plugins can easily interact with the economy:

```java long balance = ClipsEZEconomyAPI.getBalance(player); ClipsEZEconomyAPI.deposit(player, 10); ClipsEZEconomyAPI.withdraw(player, 5); ```

* Clean internal economy service * No direct dependency on internal classes * Designed for future Vault support (Vault NOT required)

---

⚡ Why Choose ClipsEZEconomy?

* Built for Folia-compatible * Players use Folia-compatible, not virtual money * Clean & beautiful GUI * Extremely customizable * Lightweight and efficient * Automatic data safety features * Folia-compatible * Folia-compatible * Perfect for SMPs, community servers, or minimalistic economies

---

📚 Commands

* `/bank` — *Opens the banking GUI* Permission: `clipsezeconomy.bank` * `/balance [player]` — *Checks balance* Permission: `clipsezeconomy.balance` * `/baltop` — *Top 5 richest players* Permission: `clipsezeconomy.baltop` * `/eco set/add/take` — *Admin economy management* Permission: `clipsezeconomy.admin` * `/clipsezeconomy reload` — *Reloads plugin data* Permission: `clipsezeconomy.admin`

---

🔐 Permissions

* `clipsezeconomy.bank` — default: true * `clipsezeconomy.balance` — default: true * `clipsezeconomy.baltop` — default: true * `clipsezeconomy.admin` — default: op

---

⚙️ Installation

1. Drop the plugin JAR into the `/plugins` folder 2. Start the server 3. Configure `config.yml` to your liking 4. Restart or use `/clipsezeconomy reload` 5. Enjoy your new emerald-based economy!

---

❤️ Support & Feedback

* Have a suggestion? * Found a bug? * Want a new feature added?

Join the community Discord: https://discord.gg/Ycf7VmgsSF

---

🚀 ClipsEZEconomy — A safe, clean, and modern emerald economy for Paper servers.