NovaEco - Hytale Economy System Mod

Project Overview

NovaEco is a complete economy system mod for Hytale servers, providing multi-currency management, player transactions, wealth rankings, and more. Built on the Hytale Server Plugin API, using Maven for dependency management, compiled with Java 25+.

Features

💰 Multi-Currency System

• Support for multiple currencies (Coins, Gems, etc.)
• Customizable currency name, symbol, and default balance
• Each currency supports independent prefix/suffix symbols

👛 Player Wallet

• Each player has an independent wallet
• Support for managing multiple currencies simultaneously
• Thread-safe data management (ConcurrentHashMap)

💸 Player Transactions

• Player-to-player transfer functionality via /pay
• Automatic transaction history recording
• Real-time transaction amount validation

📊 Wealth Rankings

• View server rich list via /balancetop
• Paginated viewing support
• Sort by specified currency

🔧 Administration

• Complete admin command set
• Dynamic currency creation/deletion
• One-click config reload
• Manual data save

💾 Data Persistence

• Automatic JSON format saving
• Separate storage for currency config and player data
• Auto-save on server shutdown

Quick Start

Commands

Player Commands

Admin Commands

API Usage

Basic Operations

import cmtn.hytale.mods.nova_eco.economy.api.EconomyAPI;
import java.util.UUID;

// Get player balance
double balance = EconomyAPI.getBalance(playerUUID, "coins");

// Add currency
EconomyAPI.addCurrency(playerUUID, "coins", 100);

// Remove currency
boolean success = EconomyAPI.removeCurrency(playerUUID, "coins", 50);

// Set balance
EconomyAPI.setBalance(playerUUID, "coins", 1000);

Transfer Operations

// Player-to-player transfer
boolean success = EconomyAPI.transfer(fromUUID, toUUID, "coins", 100);

// Check sufficient balance
if (EconomyAPI.hasEnough(playerUUID, "coins", 100)) {
    // Execute operation
}

Currency Management

// Check if currency exists
boolean exists = EconomyAPI.currencyExists("gems");

// Get all currencies
List<Currency> currencies = EconomyAPI.getAllCurrencies();

// Format amount
String formatted = EconomyAPI.format("coins", 1234.56);
// Output: "1,234.56 Coins"

Adding New Currency

import cmtn.hytale.mods.nova_eco.economy.NovaEcoEconomy;
import cmtn.hytale.mods.nova_eco.economy.currencies.Currency;
import cmtn.hytale.mods.nova_eco.economy.currencies.CurrencySymbol;

// Create currency
Currency gems = new Currency(
    "gems",                    // Currency name
    new CurrencySymbol("💎", "", false),  // Currency symbol
    0.0,                       // Default balance
    true,                      // Can be deleted
    "In-game currency"         // Description
);

// Register currency
NovaEcoEconomy.addCurrency(gems);

Configuration

Data Storage Structure

NovaEco/
└── economy/
    ├── currencies.json       # Currency configuration
    └── players/
        └── {player_uuid}.json  # Player wallet data

currencies.json Example

{
  "currencies": [
    {
      "name": "coins",
      "symbol": {
        "prefix": "",
        "suffix": " Coins",
        "useSymbolAsPrefix": false
      },
      "defaultBalance": 0.0,
      "canDelete": false,
      "description": "Default coins"
    }
  ]
}

Player Data Example

{
  "uuid": "player-uuid-here",
  "balances": {
    "coins": 1000.0,
    "gems": 50.0
  },
  "transactions": [
    {
      "type": "RECEIVE",
      "currency": "coins",
      "amount": 100.0,
      "from": "system",
      "reason": "New player bonus",
      "timestamp": 1704067200000
    }
  ]
}

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contact

• Author: cnlimiter
• Project: https://github.com/Nova-Committee/NovaEco