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:

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 [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.