KuksoHyLib

"kukso-hy-lib" is a core library for the Kukso Hytale Mods ecosystem. It provides essential utilities and modules that streamline Hytale mod development. Instead of reinventing the wheel for every mod, this library offers battle-tested solutions for common modding needs.

Features

Localization Module

Multi-language support based on the player's client language setting.

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

// Basic usage - automatically uses the player's language  
Message msg = LocaleMan.get(playerRef, "messages.welcome");  
player.sendMessage(msg);

// With placeholders  
Message msg = LocaleMan.get(playerRef, "messages.welcome",  
    Map.of("player", player.getUsername()));

// Raw string for specific locale  
String text = LocaleMan.getRaw("en\_US", "messages.welcome");

// Check what locales are loaded  
Set loaded = LocaleMan.getLoadedLocales();

Language file example (locales/en_US.json):

{  
  "prefix": "&e[MyPlugin]&r",  
  "messages": {  
    "welcome": "&aWelcome, &e{player}&a!",  
    "goodbye": "&7Goodbye, &e{player}&7!"  
  },  
  "errors": {  
    "no_permission": "&cYou don't have permission to do that.",  
    "not_enough_coins": "&cYou need {required} coins. You have {current}."  
  }  
}

Features:

• JSON-based language files (no external dependencies)
• Automatic placeholder resolution with {placeholder} syntax
• Player language detection from client settings
• Fallback chain: Player locale → Default locale (en_US) → Key name
• Thread-safe with concurrent access support
• Hot-reload via /kuksolib reload
• Color code support in translations (integrates with ColorMan)

Note: Hytale only supports English in Early Access.

Chat Colorization Module

Translate Minecraft-style color codes to Hytale's Message format.

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

// Basic color codes - returns Hytale Message object  
Message msg = ColorMan.translate("&aGreen &bAqua &cRed");

// Multiple colors in one message  
Message msg = ColorMan.translate("&4Hel&clo &bWo&1rld!");  
// Result: "Hel" dark red, "lo " red, "Wo" aqua, "rld!" dark blue

// Hex color support  
Message msg = ColorMan.translate("&#FF5733This is orange!");

// Formatting codes  
Message msg = ColorMan.translate("&l&4Bold Red &r&oItalic White");

// Combined with localization  
Message msg = LocaleMan.get(player, "messages.welcome"); // Already colored!

player.sendMessage(msg);

Supported Codes:

• Legacy colors: &0-9, &a-f (standard 16 Minecraft colors)
• Hex colors: &#RRGGBB (e.g., &#FF5733)
• Bold: &l
• Italic: &o
• Reset: &r (resets color and formatting)

Features:

• Full legacy color code support
• Hex color support for custom colors
• Multiple colors in a single message
• Format codes (bold, italic)
• Seamless integration with LocaleMan
• Returns native Hytale Message objects

Note: Underline (&n), strikethrough (&m), and obfuscated (&k) are not supported by Hytale's Message API.