promotional bannermobile promotional banner
premium banner

Economy

An economy system for Hytale that adds player wallets, balance checking, and secure money transfers.

Description

đź’° 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.

 

Yigit

 

đź“ś 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: Yigit