TheEconomy

EconomySystem – Plugin de Economía para Hytale

EconomySystem es un completo plugin de economía para servidores de Hytale, que cuenta con balances de jugadores persistentes, comandos de dinero, herramientas de administración, sistemas de recompensas (romper bloques + matar monstruos), una interfaz de tienda completa, tiendas entre jugadores, soporte de localización (EN/PT/ES/RU) y una API pública para una fácil integración con otros mods.

✅ Características Principales

• Balances Persistentes (JSON) guardados automáticamente cada 30 segundos
• Dinero Inicial: Los nuevos jugadores reciben un balance inicial configurable (config JSON)
• Seguro y Estable: Manejo de balances seguro con almacenamiento en disco protegido
• Sistema de Tienda: Tienda completa del servidor con GUI, soporte de compra/venta y carga de ítems en tiempo real
• Sistema de Tienda de Jugadores: Tiendas entre jugadores con GUI, gestión de stock y persistencia
• Traducciones: Soporte multilingüe (EN / PT / ES / RU)
• Formato Avanzado de Moneda: Símbolo personalizado, formato 1.000,00 y valores cortos (1k, 1kk, 1kkk)
• Sistema de Recompensas: Gana dinero al romper minerales/madera y matar monstruos
• Soporte de Consola: Los comandos de administrador funcionan desde la consola del servidor
• Nombres de Ítems Traducidos: Todos los nombres de ítems aparecen traducidos en mensajes y GUIs

💰 Comandos de Jugador

• /money → Muestra tu balance en un título en pantalla estilizado
  Permiso: theeconomy.player.money
• /money <jugador> → Ver el balance de otro jugador
  Permiso: theeconomy.player.money
• /money pay <jugador> <cantidad> → Enviar dinero a otro jugador
  Permiso: theeconomy.player.money.pay
• /money top → Muestra los 10 jugadores más ricos (colores especiales para los 3 primeros)
  Permiso: theeconomy.player.money.top
• /iteminfo o /ii o /item → Muestra información sobre el ítem en la mano
  Permiso: theeconomy.player.iteminfo

🛠 Comandos de Administrador

• /money set <jugador> <cantidad> → Establece el balance de un jugador
  Permiso: theeconomy.admin.money.set
• /money give <jugador> <cantidad> → Añade dinero a un jugador
  Permiso: theeconomy.admin.money.give
  ✅ ¡Funciona desde la consola!

🛒 Comandos y Sistema de Tienda del Servidor

• /shop o /loja → Abre la GUI de la Tienda
  Permiso: theeconomy.player.shop
• Navega por los ítems disponibles utilizando una interfaz limpia
• Compra y vende ítems con un diálogo de confirmación
• Campo de entrada de cantidad en la GUI de confirmación
• La tienda soporta nombres de ítems traducidos, tooltips y mensajes
• Las opciones de compra/venta se desactivan automáticamente si el precio del ítem está establecido en 0
• Muestra un mensaje de tienda vacía cuando no hay ítems disponibles
• Títulos traducidos dinámicamente según el idioma configurado

🛠 Comandos de Administrador de la Tienda del Servidor

• /shop manager → Te permite gestionar la Tienda de Administrador a través de la interfaz sin usar los comandos a continuación.
  Permiso: theeconomy.admin.shop.manager
• /shop add <itemid> <cantidad> <precioVenta> <precioCompra> → Añade un ítem a la tienda
  Permiso: theeconomy.admin.shop.add
• /shop tab add <nombreTab> → Añade una pestaña a la tienda
  Permiso: theeconomy.admin.shop.add
• /shop tab remove <nombreTab> → Elimina una pestaña de la tienda
  Permiso: theeconomy.admin.shop.remove
• /shop remove <uniqueid> → Elimina un ítem de la tienda
  Permiso: theeconomy.admin.shop.remove

🧑‍🤝‍🧑 Sistema de Tienda de Jugadores (Tiendas entre Jugadores)

Los jugadores pueden crear sus propias tiendas personales y comerciar con otros.

Comandos de Tienda de Jugadores

• /myshop manager → Te permite gestionar la Tienda de Jugadores a través de la interfaz sin usar los comandos a continuación.
  Permiso: theeconomy.player.myshop.manager
• /myshop open → Abre tu tienda.
  Permiso: theeconomy.player.myshop
• /myshop close → Cierra tu tienda
  Permiso: theeconomy.player.myshop
• /myshop add <precioCompra> <precioVenta> → Añade el ítem en la mano a tu tienda
  Permiso: theeconomy.player.myshop
• /myshop remove <uniqueid> → Elimina un ítem de tu tienda
  Permiso: theeconomy.player.myshop
• /myshop tab add <nombre> → Añade una pestaña a la tienda del jugador.
  Permiso: theeconomy.player.myshop
• /myshop rename <nombre> → Renombra la tienda.
  Permiso: theeconomy.player.myshop
• /playershop <nick> o /pshop <nick> → Abre la tienda de otro jugador
  Permiso: theeconomy.player.playershop
• /shops → Lista todas las tiendas de jugadores abiertas
  Permiso: theeconomy.player.shops

Características de la Tienda de Jugadores

• La tienda ahora tiene una interfaz de gestión de ítems y pestañas para una fácil edición.
• Configurable a través de EnablePlayerShop en EconomyConfig (por defecto: true)
• Los datos de la tienda persisten en JSON (UUID del propietario, apodo y estado abierto/cerrado)
• Los ítems permanecen listados incluso con 0 stock (pueden ser reabastecidos cuando los jugadores venden)
• Soporta precios de Compra y Venta separados por ítem
• Los propietarios de tiendas reciben notificaciones de transacciones cuando están en línea
• Datos organizados por jugador en un formato JSON estructurado
• Diálogo de confirmación al eliminar ítems de tu propia tienda
• Los ítems se devuelven automáticamente al inventario cuando se eliminan de la tienda
• Sistema de stock automático:
  • El stock disminuye cuando los jugadores compran
  • El stock aumenta cuando los jugadores venden

Características de la GUI de la Tienda de Jugadores

• Muestra precios: B: Valor S: Valor (traducido)
• Muestra stock: Stock: Cantidad (traducido)
• Los tooltips incluyen: ID único, stock, precios y durabilidad
• Previene la compra desde tu propia tienda
• Permite vender a tu propia tienda para reabastecer
• Ítems con 0 stock permanecen visibles pero no pueden ser comprados
• Actualizaciones de stock dinámicas después de las transacciones
• Títulos traducidos dinámicamente con los nombres de los jugadores
• Clic para eliminar ítems al ver tu propia tienda a través de /shops

⛏ Recompensas por Romper Bloques

Gana dinero automáticamente al romper bloques:

• Recompensas por Minerales
  • Completamente configurable por tipo de mineral
  • Pueden ser habilitadas/deshabilitadas en la configuración
• Recompensas por Madera
  • Los valores de recompensa pueden ser configurados por tipo de madera
  • Pueden ser habilitadas/deshabilitadas en la configuración

🐲 Recompensas por Matar Monstruos

Los jugadores pueden ganar dinero al derrotar monstruos:

• Sistema de recompensas simple (un valor configurable para todos los monstruos)
• Configurable a través de MonsterReward en EconomyConfig
• Registros de depuración opcionales

⚙ Opciones de Configuración

• Habilitar/deshabilitar Recompensas por Minerales
• Habilitar/deshabilitar Recompensas por Madera
• Configurar recompensas por minerales por tipo
• Configurar recompensas por madera por tipo
• Configurar Recompensa por Monstruo
• Habilitar/deshabilitar el sistema de Tienda de Jugadores (EnablePlayerShop)
• Habilitar/deshabilitar el sistema de Tienda de Administrador (EnableShop)
• Establecer el idioma por defecto (EN / PT / ES / RU)
• Personalizar el símbolo de la moneda

🌍 Sistema de Traducción / Localización

EconomySystem incluye soporte completo de idiomas:

• Language_EN.json (Inglés)
• Language_PT.json (Portugués)
• Language_ES.json (Español)
• Language_RU.json (Ruso) ✨ ¡Nuevo!

✅ Toda la interfaz de la tienda, mensajes, tooltips y textos son completamente traducibles
✅ Soporta marcadores de posición para valores dinámicos
✅ Títulos de tienda traducidos dinámicamente según el idioma
✅ Nombres de ítems traducidos en todos los mensajes y GUIs

Créditos de Traducción al Ruso: Lylex – ¡Gracias por la traducción al ruso!

🔌 API Pública (EconomyAPI)

EconomySystem incluye una API pública ubicada en:
com.economy.api.EconomyAPI

Métodos de API Disponibles

Consultas de Balance

• getBalance(UUID playerUUID)
• getBalance(String playerName)

Gestión de Balance

• setBalance(UUID playerUUID, double value)
• setBalance(String playerName, double value) (devuelve booleano)
• addBalance(UUID playerUUID, double value)
• addBalance(String playerName, double value) (devuelve booleano)
• removeBalance(UUID playerUUID, double value) (devuelve booleano)
• removeBalance(String playerName, double value) (devuelve booleano)

Comprobaciones de Balance

• hasBalance(UUID playerUUID, double value)
• hasBalance(String playerName, double value)

Ayudantes de Información del Jugador

• getPlayerName(UUID playerUUID)
• getPlayerUUID(String playerName)

Balance Formateado

• getFormattedBalance(UUID playerUUID)
• getFormattedBalance(String playerName)

Ejemplo de API

EconomyAPI api = EconomyAPI.getInstance();

double balance = api.getBalance(playerUUID);
api.addBalance(playerUUID, 100.0);

boolean success = api.removeBalance(playerUUID, 50.0);
String formatted = api.getFormattedBalance(playerUUID);

🔗 API de Marcadores de Posición

EconomySystem incluye una API pública de Marcadores de Posición para otros plugins:

com.economy.util.PlaceholderAPI

Marcadores de Posición Disponibles

• %balance% – Balance del jugador (valor numérico)
• %balance_formated% – Balance del jugador (formateado con símbolo de moneda)

Métodos de API de Marcadores de Posición

• PlaceholderAPI.getInstance().replacePlaceholders(UUID playerUUID, String text)
• PlaceholderAPI.getInstance().replacePlaceholders(String playerName, String text)
• PlaceholderAPI.getInstance().containsPlaceholders(String text)

Ejemplo de Marcador de Posición

PlaceholderAPI placeholderAPI = PlaceholderAPI.getInstance();

String text = "Tu balance es %balance_formated%";
String result = placeholderAPI.replacePlaceholders(playerUUID, text);
// Resultado: "Tu balance es $1,234.56"

🔐 Permisos

Todos los permisos están registrados y visibles en LuckPerms:

Permisos de Jugador

• theeconomy.player.money – Acceso al comando /money
• theeconomy.player.money.pay – Acceso al comando /money pay
• th...