Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!

ClipsEZEconomy

A modern emerald-based economy with GUI banking, player balances, baltop, admin tools, and full customization.

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