KuksoLib

“kukso-hy-lib” es una biblioteca fundamental para el ecosistema de mods de Kukso Hytale. Proporciona utilidades y módulos esenciales que agilizan el desarrollo de mods para Hytale. En lugar de reinventar la rueda para cada mod, esta biblioteca ofrece soluciones probadas para necesidades comunes de modificación.

Características

Módulo de Localización

Soporte multilingüe basado en la configuración del idioma del cliente del jugador.

import com.kukso.hy.lib.locale.LocaleMan;

// Uso básico - utiliza automáticamente el idioma del jugador  
Message msg = LocaleMan.get(playerRef, "messages.welcome");  
player.sendMessage(msg);

// Con marcadores de posición  
Message msg = LocaleMan.get(playerRef, "messages.welcome",  
    Map.of("player", player.getUsername()));

// Cadena sin procesar para un locale específico  
String text = LocaleMan.getRaw("en_US", "messages.welcome");

// Comprobar qué locales están cargados  
Set loaded = LocaleMan.getLoadedLocales();

Ejemplo de archivo de idioma (locales/en_US.json):

{  
  "prefix": "&e[MyPlugin]&r",  
  "messages": {  
    "welcome": "&a¡Bienvenido, &e{player}&a!",  
    "goodbye": "&7¡Adiós, &e{player}&7!"  
  },  
  "errors": {  
    "no_permission": "&cNo tienes permiso para hacer eso.",  
    "not_enough_coins": "&cNecesitas {required} monedas. Tienes {current}."  
  }  
}

Características:

• Archivos de idioma basados en JSON (sin dependencias externas)
• Resolución automática de marcadores de posición con la sintaxis {placeholder}
• Detección del idioma del jugador a partir de la configuración del cliente
• Cadena de retroceso: Localidad del jugador → Localidad predeterminada (en_US) → Nombre de la clave
• Seguridad en hilos con soporte para acceso concurrente
• Recarga en caliente a través de /kuksolib reload
• Soporte de códigos de color en traducciones (se integra con ColorMan)

Nota: Hytale solo admite inglés en Acceso Anticipado.

Módulo de Coloración de Chat

Traduce códigos de color al estilo Minecraft al formato de Mensaje de Hytale.

import com.kukso.hy.lib.util.ColorMan;

// Códigos de color básicos - devuelve objeto de Mensaje de Hytale  
Message msg = ColorMan.translate("&aVerde &bAqua &cRojo");

// Múltiples colores en un solo mensaje  
Message msg = ColorMan.translate("&4Hel&clo &bWo&1rld!");  
// Resultado: "Hel" rojo oscuro, "lo " rojo, "Wo" aqua, "rld!" azul oscuro

// Soporte para colores hexadecimales  
Message msg = ColorMan.translate("&#FF5733¡Esto es naranja!");

// Códigos de formato  
Message msg = ColorMan.translate("&l&4Rojo Negrita &r&oItálico Blanco");

// Combinado con localización  
Message msg = LocaleMan.get(player, "messages.welcome"); // ¡Ya coloreado!

player.sendMessage(msg);

Códigos soportados:

• Colores heredados: &0-9, &a-f (16 colores estándar de Minecraft)
• Colores hexadecimales: &#RRGGBB (por ejemplo, &#FF5733)
• Negrita: &l
• Itálico: &o
• Restablecer: &r (restablece color y formato)

Características:

• Soporte completo para códigos de color heredados
• Soporte para colores hexadecimales para colores personalizados
• Múltiples colores en un solo mensaje
• Códigos de formato (negrita, itálico)
• Integración perfecta con LocaleMan
• Devuelve objetos de Mensaje nativos de Hytale

Nota: Subrayado (&n), tachado (&m) y ofuscado (&k) no son compatibles con la API de Mensaje de Hytale.