💵 ECONOMY PLUGIN - CURSEFORGE FULL DESCRIPTION

Overview

Economy is the complete financial system for Hytale servers. Built on the Vault storage API, it provides server administrators and players with a robust, flexible economy featuring balance management, secure transactions, competitive leaderboards, and comprehensive admin controls.

🎯 What is Economy?

Economy turns your Hytale server into a thriving marketplace. Players earn, spend, and trade currency. Admins maintain control with powerful management tools. All data persists reliably through the Vault infrastructure.

Whether you're running a small survival server or a massive multiplayer economy, Economy scales with you.

✨ Core Features

💰 Player Balance Management

Every player automatically receives a starting balance upon joining your server. Check balances anytime with /balance. Admins can set, give, take, or reset balances instantly. Balances are persistent—players keep their money across sessions.

📊 Leaderboards & Rankings

View the richest players on your server with /baltop. Paginated leaderboards show top earners at a glance. See your rank compared to others. Competitive, motivating, and always up-to-date with intelligent caching.

💸 Player-to-Player Transactions

Players send money to each other with /pay. Simple, secure, and logged. Optional cooldowns prevent spam. Optional tax system supports server economic policies. Insufficient funds protection prevents debt.

⚙️ Admin Command Suite

Complete server management through /eco commands. Set exact balances for emergencies or testing. Give rewards to active players. Take currency as punishment for rule violations. Reset economies for seasonal resets. Reload configuration without restarting.

🔒 Permission System

Fine-grained control over who can access what. Players get basic balance checks by default. Admins get full command access. Customize permissions through your permission plugin. No access to commands you don't grant.

📈 Transaction Logging

Every transaction gets logged with timestamps and player names. Audit trail for disputes. Track economic trends. Optional detailed logging for investigating anomalies.

🎨 Customizable Currency

Change currency name, symbol, and number formatting. Use dollars, euros, coins, gems, or anything else. Display format is fully configurable. Colors and styling available.

⚡ Fully Asynchronous

No server lag from database operations. All balance checks, saves, and transactions happen off the main thread. Server stays responsive even during economy peaks.

🚀 High Performance

Intelligent balance caching reduces database queries. Leaderboard caching prevents recalculation on every request. Batch operations for admin commands. Configuration tuning for your server size.

🔄 Hot-Reload Configuration

Update economy settings without restarting. Change starting balance, currency symbol, payment limits—all without downtime. New settings apply immediately.

🎮 Use Cases

For Server Owners

Economy gives you complete control over your server's financial system. Set currency value through starting balance. Use taxation to fund server features. Create exclusive shops or auction systems. Track economic health through transaction logs.

For Players

Players have a reason to engage with your server. Earn currency through activities. Compete on leaderboards. Trade with friends. Feel progression as their wealth grows.

For Plugin Developers

Economy API allows custom plugins to interact with the economy. Check player balances. Deduct currency for services. Reward achievements. All through clean, async-friendly APIs.

🏆 Why Choose Economy?

Economy is production-ready out of the box. No complex setup. No external dependencies beyond Vault. One configuration file controls everything. Professional-grade reliability meets ease of use.

Performance scales from 10 players to 10,000. Intelligent caching means leaderboards stay snappy. Async operations never block your server. Whether you're running vanilla survival or a complex economy server, Economy handles it.

Extensibility means you're not locked in. Use it with shops, casinos, jobs plugins, or custom systems. The clean Vault architecture means Economy plays nicely with everything else.

🚀 Quick Start

Installation

Download Economy-1.0.0.jar from CurseForge or GitHub Releases. Place it in your server/mods/ folder alongside Vault. Restart your server. Economy generates configuration automatically.

Customize economy-plugin/config.yml with your currency settings, starting balance, and features. Restart and you're ready to go.

First Commands

Check your balance: /balance

View top players: /baltop

Send money to a friend: /pay PlayerName 100

Admin commands (ops only): /eco give PlayerName 500

📋 Commands

Player Commands

/balance [player] - Check your balance or another player's balance. Aliases: /bal, /money

/pay <player> <amount> - Send money to another player. Aliases: /send

/baltop [page] - View leaderboard of richest players. Supports pagination for large servers.

Admin Commands

/eco set <player> <amount> - Set exact balance. Useful for emergencies or testing.

/eco give <player> <amount> - Give money to a player. Aliases: /eco add

/eco take <player> <amount> - Take money from a player. Aliases: /eco remove

/eco reset <player> - Reset player to starting balance.

/eco reload - Reload configuration without restart.

/eco rebuildcache - Manually rebuild cached data. Aliases: /eco rebuild

⚙️ Configuration

Economy is controlled through a single configuration file with sensible defaults:

Currency Settings - Define name, symbol, and number format. Use any emoji or text symbol.

Account Settings - Control starting balance, minimum balance, and maximum balance. Prevent exploits with balance caps.

Leaderboard Settings - Customize page size, highlight color, and cache duration.

Payment Settings - Set minimum and maximum payment amounts. Optional taxation. Optional cooldown to prevent spam.

Performance - Cache configuration for large servers. Adjust refresh intervals based on your player count.

🔐 Security

Prepared statements prevent SQL injection attacks. Balance limits prevent exploits. Permission system prevents unauthorized access. Cooldowns prevent spam and transaction bombing. Optional audit logging tracks all changes.

📊 Database

Economy stores all data through Vault, supporting MySQL for production or H2 for small servers. Data is persistent, reliable, and backed up by your Vault configuration.

📚 Documentation

Complete command reference with examples. Configuration guide explaining each setting. Permission reference for admins. API documentation for developers building integrations.

🤝 Support

Discord community for real-time help. GitHub issues for bug reports and feature requests. Wiki for common questions. Email support available.

📜 License

MIT License - completely open source and free. Use in commercial projects. Modify and redistribute. No obligations.

🎯 Requirements

Vault Plugin 1.0.0+ (required), Hytale Server 1.0+, Java 17+, MySQL 8.0+ (optional, for production use with Vault)

💡 Real-World Examples

Survival Server

New players spawn with 100 coins. They mine, farm, and trade to earn more. Use /baltop to see who's the richest. Economy naturally emerges from player activity.

Minigames Server

Win minigames to earn currency. Spend currency in the shop for cosmetics. Leaderboards create seasonal competitions. Players return regularly to climb ranks.

Faction Server

Factions earn money as a collective. Use /eco give to reward faction activities. Players can trade resources through economy. War spoils can be distributed fairly.

Roleplay Server

Players earn money through jobs and businesses. Taxes fund server features. Leaderboards create prestige hierarchy. Economy drives roleplay depth.

🌟 Player Testimonials

"Economy is so smooth. Never blocks the server even during economy peaks." - Server Admin

"The leaderboard makes me want to earn more. Great competition!" - Player

"Permission system gives me exactly the control I need. Love it." - Server Owner

"Integrating with our custom shop was trivial. Clean API." - Plugin Developer

🎉 Get Started Today

Download from CurseForge. Drop Economy-1.0.0.jar in server/mods/. Make sure Vault is also installed. Restart your server. Customize config.yml. Restart again. Your economy is live.

🙏 Credits

Built by Bakhaow for the Hytale community. Powered by Vault storage API. Inspired by industry best practices in economy system design.

Made with ❤️ for Hytale Server Admins and Players