NovaEco

Descripción del Proyecto

NovaEco es un mod completo del sistema económico para servidores de Hytale, que proporciona gestión de múltiples monedas, transacciones entre jugadores, clasificaciones de riqueza y mucho más. Construido sobre la API del Plugin de Servidor de Hytale, utilizando Maven para la gestión de dependencias y compilado con Java 25+.

Características

💰 Sistema de Múltiples Monedas

Soporte para múltiples monedas (Monedas, Gemas, etc.)
Nombre de moneda, símbolo y saldo predeterminado personalizables
Cada moneda soporta símbolos de prefijo/sufijo independientes

👛 Billetera del Jugador

Cada jugador tiene una billetera independiente
Soporte para gestionar múltiples monedas simultáneamente
Gestión de datos a prueba de hilos (ConcurrentHashMap)

💸 Transacciones entre Jugadores

Funcionalidad de transferencia entre jugadores a través de /pay
Registro automático del historial de transacciones
Validación del monto de la transacción en tiempo real

📊 Clasificaciones de Riqueza

Ver la lista de ricos del servidor a través de /balancetop
Soporte para visualización paginada
Ordenar por moneda especificada

🔧 Administración

Conjunto completo de comandos de administración
Creación/eliminación dinámica de monedas
Recarga de configuración con un clic
Guardado manual de datos

💾 Persistencia de Datos

Guardado automático en formato JSON
Almacenamiento separado para la configuración de monedas y los datos de los jugadores
Guardado automático al apagar el servidor

Inicio Rápido

Comandos

Comandos de Jugador

Comando	Descripción	Alias
`/balance [moneda]`	Comprobar saldo actual	`bal`
`/pay <jugador> <cantidad>`	Transferir a jugador	`transfer`
`/balancetop [página]`	Ver clasificación de riqueza	`baltop`, `rich`
`/transaction [conteo]`	Ver historial de transacciones	`tx`, `history`

Comandos de Administración

Comando	Descripción	Alias
`/economy`	Menú de gestión económica	`eco`
`/economy info`	Ver estadísticas económicas	–
`/economy reload`	Recargar configuración	–
`/economy create <nombre> <símbolo> [predeterminado]`	Crear nueva moneda	–
`/economy delete <nombre>`	Eliminar moneda	–
`/economy save`	Guardar datos inmediatamente	–
`/givecoins <jugador> <cantidad>`	Dar moneda a jugador	`gc`, `addcoins`
`/takecoins <jugador> <cantidad>`	Quitar moneda de jugador	`tc`, `removecoins`
`/setcoins <jugador> <cantidad>`	Establecer saldo de jugador	`sc`, `setcoin`

Uso de la API

Operaciones Básicas

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

// Obtener saldo del jugador
double balance = EconomyAPI.getBalance(playerUUID, "coins");

// Añadir moneda
EconomyAPI.addCurrency(playerUUID, "coins", 100);

// Quitar moneda
boolean success = EconomyAPI.removeCurrency(playerUUID, "coins", 50);

// Establecer saldo
EconomyAPI.setBalance(playerUUID, "coins", 1000);

Operaciones de Transferencia

// Transferencia entre jugadores
boolean success = EconomyAPI.transfer(fromUUID, toUUID, "coins", 100);

// Comprobar saldo suficiente
if (EconomyAPI.hasEnough(playerUUID, "coins", 100)) {
    // Ejecutar operación
}

Gestión de Monedas

// Comprobar si la moneda existe
boolean exists = EconomyAPI.currencyExists("gems");

// Obtener todas las monedas
List<Currency> currencies = EconomyAPI.getAllCurrencies();

// Formatear cantidad
String formatted = EconomyAPI.format("coins", 1234.56);
// Salida: "1,234.56 Coins"

Agregar Nueva Moneda

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;

// Crear moneda
Currency gems = new Currency(
    "gems",                    // Nombre de la moneda
    new CurrencySymbol("💎", "", false),  // Símbolo de la moneda
    0.0,                       // Saldo predeterminado
    true,                      // Puede ser eliminada
    "Moneda del juego"         // Descripción
);

// Registrar moneda
NovaEcoEconomy.addCurrency(gems);

Estructura de Almacenamiento de Datos

NovaEco/
└── economy/
    ├── currencies.json       # Configuración de monedas
    └── players/
        └── {player_uuid}.json  # Datos de la billetera del jugador

Ejemplo de currencies.json

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

Ejemplo de Datos del Jugador

{
  "uuid": "player-uuid-here",
  "balances": {
    "coins": 1000.0,
    "gems": 50.0
  },
  "transactions": [
    {
      "type": "RECEIVE",
      "currency": "coins",
      "amount": 100.0,
      "from": "system",
      "reason": "Bonificación de nuevo jugador",
      "timestamp": 1704067200000
    }
  ]
}