Economy

💰 Economy

Economy is an essential currency system for Hytale, built for stability and performance. Whether you are running a survival SMP or a complex minigame network, this mod provides the foundational tools required to manage a robust virtual economy.

✨ Features

Persistent Wallets: Every player receives a personal wallet that saves automatically to their player data.

Lazy Initialization: Zero configuration required—wallets are created instantly when a player first interacts with the economy.

Safe Transactions: Player-to-player transfers include strict checks to prevent overdrafts and ensure data integrity.

Advanced Admin Tools: Empower server operators to give, take, or set balances directly from the chat.

High Compatibility: Uses a specialized Reflection layer (HytaleUtils) to ensure the mod remains functional across different Hytale API snapshots.

📜 Commands

Player Commands

Command Aliases Description

/balance /bal, /money, /wallet View your current coin balance.

/pay <player> <amount> N/A Securely send coins to another player.

Admin Commands (Creative Only)

Command Description

/ecoadmin give <player> <amount> Add coins to a player's wallet.

/ecoadmin take <player> <amount> Remove coins from a player's wallet.

/ecoadmin set <player> <amount> Overwrite a player's balance to a specific value.

⚙️ How it Works

The mod utilizes Hytale's native Entity Component System (ECS) by attaching a MoneyComponent to player entities.

Positional Arguments: By implementing the RequiredArg and ArgTypes pattern, the mod explicitly defines its parameter requirements to the Hytale engine, resolving previous validation errors.

Data Safety: Balances are stored as long values to support high-scale economies while input is validated via Integer arguments for maximum API compatibility.

Synchronized Execution: Operations are wrapped in runSync to ensure thread-safety during high-traffic transactions.

Developed by: Ryukazan &bull; Yigit