💰 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