Economy

💰 Economía

La economía es un sistema de moneda esencial para Hytale, diseñado para ofrecer estabilidad y rendimiento. Ya sea que estés gestionando un SMP de supervivencia o una compleja red de minijuegos, este mod proporciona las herramientas fundamentales necesarias para administrar una economía virtual robusta.

✨ Características

• Bolsas Persistentes: Cada jugador recibe una bolsa personal que se guarda automáticamente en sus datos de jugador.
• Inicialización Perezosa: No se requiere configuración—las bolsas se crean al instante cuando un jugador interactúa por primera vez con la economía.
• Transacciones Seguras: Las transferencias entre jugadores incluyen controles estrictos para prevenir sobregiros y asegurar la integridad de los datos.
• Herramientas Avanzadas para Administradores: Empodera a los operadores del servidor para dar, quitar o establecer balances directamente desde el chat.
• Alta Compatibilidad: Utiliza una capa de reflexión especializada (HytaleUtils) para asegurar que el mod siga siendo funcional a través de diferentes instantáneas de la API de Hytale.

📜 Comandos

Comandos de Jugador

Comando	Alias	Descripción
/balance	/bal, /money, /wallet	Ver tu saldo actual de monedas.
/pay <jugador> <cantidad>	N/A	Enviar monedas de forma segura a otro jugador.

Comandos de Administrador (Solo Creativo)

Comando	Descripción
/ecoadmin give <jugador> <cantidad>	Añadir monedas a la bolsa de un jugador.
/ecoadmin take <jugador> <cantidad>	Eliminar monedas de la bolsa de un jugador.
/ecoadmin set <jugador> <cantidad>	Sustituir el saldo de un jugador por un valor específico.

⚙️ Cómo Funciona

El mod utiliza el Sistema de Componentes de Entidad (ECS) nativo de Hytale al adjuntar un MoneyComponent a las entidades de los jugadores.

• Argumentos Posicionales: Al implementar el patrón RequiredArg y ArgTypes, el mod define explícitamente sus requisitos de parámetros para el motor de Hytale, resolviendo errores de validación anteriores.
• Seguridad de Datos: Los saldos se almacenan como valores long para soportar economías de gran escala, mientras que la entrada se valida a través de argumentos Integer para máxima compatibilidad con la API.
• Ejecutación Sincronizada: Las operaciones se envuelven en runSync para asegurar la seguridad de los hilos durante transacciones de alto tráfico.

Desarrollado por: Ryukazan • Yigit