P E R F E C T ECONOMY
The Complete Economy System for Hytale Servers
// WHY PERFECTECONOMY?
// FEATURES
- PLAYER BALANCE SYSTEM
Every player gets a balance with configurable starting amount, currency name, and currency symbol.
Thread-safe, UUID-based, persisted to JSON -- survives restarts.
Check your balance anytime with /balance. - PLAYER-TO-PLAYER TRANSFERS
Send money to any online player with /pay <player> <amount>.
The receiver gets a toast notification instantly.
Protection against self-pay, negative amounts, and insufficient funds. - CONFIGURABLE SHOP
Full in-game shop with dark flat UI:
- Categories -- organize items by group (Weapons, Armor, Food, etc.)
- Buy & Sell prices -- set independently per item
- Daily stock limits -- optional per-player daily purchase cap that resets every 24h
- Quantity selector -- [MIN] [-10] [-] qty [+] [+10] [MAX]
- Live balance -- see your money update in real-time
- Toast notifications -- confirmation on every purchase and sale
- ADMIN SHOP EDITOR
Full admin UI to configure the shop without touching config files:
- Create/delete categories with custom names
- Add items via multi-select item picker with search
- Edit prices inline -- buy price, sell price, daily stock per item
- Delete items from categories
- Save All -- persist everything to disk with one click
- ADMIN COMMANDS
Full control over player balances:
/eco give <player> <amount> -- Add money
/eco take <player> <amount> -- Remove money
/eco set <player> <amount> -- Set exact balance
/eco reset <player> -- Reset to starting balance
/eco reload -- Reload all config files - CROSS-PLUGIN API & PLACEHOLDERS
Any other plugin can use PerfectEconomy as its money backend:
Java API (direct or via reflection -- no compile dependency needed):
EconomyAPI.getBalance(uuid)
EconomyAPI.deposit(uuid, amount)
EconomyAPI.withdraw(uuid, amount)
EconomyAPI.getSellPrice(itemId) -- shop sell price lookup
EconomyAPI.format(amount) -- "$1,234"
Placeholders -- resolve in any string:
{eco_balance} -- 1234.50Perfect for scoreboards, holograms, chat plugins, or any mod that needs money.
{eco_balance_formatted} -- $1,234
{eco_balance_short} -- $1.2K
{eco_currency} -- Coins
{eco_symbol} -- $
{eco_top_1_name} -- richest player
{eco_top_1_balance} -- their balance
... up to top 10
Compatible plugins: PerfectSellChest (auto-sell chests pull prices directly from your shop) - 6 LANGUAGES
Every command, message, button, and toast fully translated:
English Francais Espanol Italiano Deutsch Portugues
Change in-game with /eco setlang <lang> - PERMISSIONS
Fine-grained access control:
perfecteconomy.command -- /balance access
perfecteconomy.pay -- /pay access
perfecteconomy.shop -- /shop access
perfecteconomy.admin -- /eco give/take/set/reset/reload
perfecteconomy.admin.shop -- /eco shop (admin editor)
// COMMANDS
/balance -- Show your balance
/pay <player> <amount> -- Send money to a player
/shop -- Open the shop
/eco give|take|set|reset <player> <amount> -- Admin balance management
/eco shop -- Open the shop admin editor
/eco reload -- Reload configuration
/eco setlang <EN|FR|ES|IT|DE|PT> -- Change language
// HOW IT WORKS
1. Drop the JAR into your server's Mods/ folder
2. Start your server -- config files are generated automatically
3. Players use /shop to buy and sell items
4. Admins use /eco shop to configure categories, items, and prices
5. Other plugins can hook in via the API or placeholders
All data is stored as JSON -- no database required.
WORK IN PROGRESS
This plugin is actively being developed!
PerfectEconomy is in active development. By purchasing now, you get:
All current features -- fully functional and tested
All future updates -- for free, forever
Priority support -- your feedback shapes the roadmap
Coming Soon:
- Leaderboard UI -- In-game rich list with flat UI
- NPC Shop Keepers -- Assign shops to NPCs (PerfectNPC integration)
- Transaction History -- Log of all purchases, sales, and transfers
- Taxes & Fees -- Configurable transaction tax on /pay
- And much more... -- New features added regularly!
// TECHNICAL DETAILS
- Platform: Hytale Dedicated Server
- Java: 21+
- Storage: JSON files (no database required)
- Performance: Thread-safe, lightweight, instant operations
- Compatibility: Works standalone or alongside any other plugin
- API: Static Java API + {eco_*} placeholder system
// CHANGELOG
- NEW EconomyAPI.getSellPrice(itemId) -- returns sell price for any shop item, enabling cross-plugin price lookup
- NEW PerfectSellChest compatibility -- sell chests now pull prices directly from your shop config
- NEW Player balance system -- UUID-based, configurable currency, starting balance
- NEW /balance, /pay -- Check balance and transfer money with toast notifications
- NEW /eco admin commands -- give, take, set, reset, reload, setlang
- NEW Player shop UI -- Dark flat design, categories, buy/sell, quantity selector, daily stock
- NEW Admin shop editor -- Create categories, add items via multi-select picker, edit prices inline
- NEW Cross-plugin API -- EconomyAPI static class + {eco_*} placeholder system
- NEW 6 languages -- EN, FR, ES, IT, DE, PT -- fully translated
- NEW Daily stock system -- Per-player purchase limits with automatic 24h reset
Developed by KatsuyaTV
If you encounter any issues or have feature requests,
don't hesitate to reach out via DM or the discussion tab.
// LINKS
