HyEconomy

HyEconomy 💰

HyEconomy es un plugin de implementación económica robusto y seguro para servidores de Hytale.

Está construido directamente sobre el estándar EcoAPI para proporcionar un sistema financiero completamente funcional. Mientras EcoAPI actúa como el puente para los desarrolladores, HyEconomy es el “banco” que gestiona el almacenamiento de datos, la lógica de transacciones y los saldos de los jugadores.

✨ Características

Almacenamiento Robusto: Gestiona de forma segura los saldos de los jugadores con la integridad de los datos en mente.
Nativo de EcoAPI: Potencia sin problemas cualquier otro plugin (Tiendas, Trabajos, Reclamaciones) que dependa del estándar EcoAPI.
Alto Rendimiento: Optimizado para manejar transacciones frecuentes sin afectar el rendimiento del servidor.
Completamente Configurable: Personaliza los nombres de las monedas, símbolos y saldos iniciales para adaptarlos al tema de tu servidor.

⚠️ Requisitos Previos

Para ejecutar HyEconomy, debes tener lo siguiente:

Servidor de Hytale (Acceso al directorio raíz).
EcoAPI: Este plugin depende de los métodos abstractos definidos en EcoAPI. No se cargará sin él.

📥 Guía de Instalación

Sigue estos sencillos pasos para instalar el sistema económico:

1. Descargar

Descarga la última versión de HyEconomy.
Descarga la última versión de EcoAPI.

2. Instalar

Navega hasta el directorio raíz de tu servidor y localiza la carpeta mods.

📂 Ruta: ./TuServidor/mods/

Arrastra y suelta AMBOS archivos .jar (HyEconomy y EcoAPI) en esta carpeta.

3. Reiniciar

Reinicia tu servidor de Hytale para cargar los nuevos mods.

# Consola del Servidor
> stop

4. Verificar

Revisa la consola del servidor durante el inicio. Deberías ver EcoAPI cargándose primero, seguido de HyEconomy conectándose exitosamente a la API.

⚙️ Configuración

Después del primer reinicio, se generará un archivo de configuración en ./Servidor/HyEconomy/.

Ajustes Comunes:

currency: Establece tu moneda (por ejemplo, $, €, Monedas).
starting: La cantidad de dinero que reciben los nuevos jugadores al unirse.

🎮 Comandos

Comandos de Usuario

/balance o /bal o /money – Consulta tu saldo actual de la cartera.
/pay <jugador> <cantidad> – Envía dinero a otro jugador.

Comandos de Administrador

/eco add <jugador> <cantidad> – Añade fondos a la cuenta de un jugador.
/eco remove <jugador> <cantidad> – Elimina fondos de la cuenta de un jugador.
/eco set <jugador> <cantidad> – Establece forzosamente el saldo de un jugador a una cantidad específica.

🤝 Para Desarrolladores

Si estás desarrollando un plugin (como un sistema de Tienda o Trabajo), no dependas de HyEconomy directamente. En su lugar, depende de EcoAPI. HyEconomy es simplemente la implementación que funciona en segundo plano.