ClipsEZEconomy

!(https://cdn.modrinth.com/data/cached_images/6c144ecb073a615f7c50582e3b06cc98d0e1939e_0.webp) ## 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 ` UUID-based economy (offline-safe) No virtual currency — real emeralds only

## 🔧 Admin Economy Tools Manage player balances directly: `/eco set ` `/eco add ` `/eco take `

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 semi-vanilla survival Players use physical emeralds, not virtual money Clean & beautiful GUI Extremely customizable Lightweight and efficient Automatic data safety features No dependencies required Folia-compatible Perfect for SMPs, community servers, or minimalistic economies

## 📚 Commands `/bank` — Opens the banking GUI Permission: `clipsezeconomy.bank` `/balance ` — 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.