KuksoHyLib

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

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 en bruto para una localidad específica  
String text = LocaleMan.getRaw("en_US", "messages.welcome");

// Ver qué localidades están cargadas  
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 desde la configuración del cliente
• Cadena de respaldo: Localidad del jugador → Localidad predeterminada (en_US) → Nombre de clave
• Seguro para hilos con soporte de 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 mensaje  
Message msg = ColorMan.translate("&4Hel&clo &bWo&1rld!");  
// Resultado: "Hel" rojo oscuro, "lo " rojo, "Wo" aqua, "rld!" azul oscuro

// Soporte de color hex  
Message msg = ColorMan.translate("&#FF5733¡Esto es naranja!");

// Códigos de formato  
Message msg = ColorMan.translate("&l&4Rojo Negrita &r&oBlanco Cursiva");

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

player.sendMessage(msg);

Códigos Soportados:

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

Características:

• Soporte completo para códigos de color heredados
• Soporte de color hex para colores personalizados
• Múltiples colores en un solo mensaje
• Códigos de formato (negrita, cursiva)
• 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.