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 &ndash; View your current balance

/pay <player> <amount> &ndash; 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