TopHyconomy

💰 TopHyconomy – Modular, Scalable & Thread-Safe Economy System for Hytale

TopHyconomy is an advanced, high-performance, developer-oriented economy plugin designed to act as the central economic core of a Hytale server and as a standardized API for other plugins.

It is built for production environments, supporting multi-instance infrastructures, high concurrency, and safe money operations.

For support, bugs or feature requests join our support discord!

🚀 Key Features

• ✅ Player-based account system with persistent balances
• ✅ Clean and extensible public API for plugin integration
• ✅ MongoDB persistence support
• ✅ Redis distributed cache (optional)
• ✅ High-performance local cache using Caffeine
• ✅ Multi-instance ready
• ✅ Thread-safe economy operations
• ✅ Deadlock and race-condition protection
• ✅ Hot-reloadable configuration and language files
• ✅ Fully customizable language system
• ✅ Optimized memory usage to prevent RAM overload

⚡ Data Architecture & Performance

TopHyconomy uses a multi-layer data architecture to achieve the best balance between speed, consistency, and scalability.

🗄️ MongoDB

• Primary persistent data storage
• Secure and reliable balance saving
• Designed for large-scale servers

🚀 Redis (Optional)

• Distributed cache for multi-instance setups
• Keeps player balances synchronized across servers
• Enables faster and safer money transfers

⚙️ Caffeine Cache

• High-performance in-memory local cache
• Reduces unnecessary MongoDB and Redis access
• Configurable TTL to avoid excessive RAM usage

This architecture allows fast economic operations, even under heavy server load, without compromising data integrity.

🔐 Concurrency & Safety

• Fully thread-safe account operations
• Controlled concurrent access to player balances
• Protection against deadlocks
• Prevention of race conditions during simultaneous transfers
• Safe for asynchronous tasks and distributed environments

Player balances remain consistent and secure at all times.

🔧 Developer API

AccountManager

• getAccount(playerId)
• createAccount(playerId, playerName, initialBalance)
• deleteAccount(playerId)
• accountExists(playerId)
• transfer(from, to, amount)
• saveAll()

Account

• give(amount)
• withdraw(amount)
• take(amount)
• getBalance()

Designed to integrate seamlessly with shops, jobs, minigames, rewards, auctions, and custom systems.

🧑‍💼 Administrative Commands

• /eco give <player> <amount>
• /eco take <player> <amount>
• /eco set <player> <amount>
• /eco info <player>
• /eco reset <player>
• /eco reload

👤 Player Commands

• /bal – View your current balance
• /pay <player> <amount> – Send money to another player

⚙️ Flexible Configuration

• Configurable starting balance
• Debug mode
• Enable or disable MongoDB and Redis
• Cache TTL configuration
• Fully editable language files
• Hot reload without server restart

📦 Built for Serious Servers

• Medium and large servers
• Multi-instance infrastructures
• Developers requiring a reliable economy API
• High-concurrency and high-load environments