KuksoHyLib

A core library for the Hytale Mods ecosystem.

157.0 загрузок

Обновлён 13 дней назад

Описание

«kukso-hy-lib» является основной библиотекой для экосистемы Kukso Hytale Mods. Он предоставляет необходимые утилиты и модули, которые оптимизируют разработку модов Hytale. Вместо того, чтобы изобретать колесо для каждого мода, эта библиотека предлагает проверенные решения для общих потребностей моддинга.

Особенности

Модуль локализации

Поддержка нескольких языков на основе настройки языка клиента игрока.

Импорт com.kukso.hy.lib.locale.Locale Человек;

Основное использование - автоматически использует язык игрока
Сообщение msg = LocaleMan.get (playerRef, "messages.welcome")
player.sendMessage (msg);

// С заполнителями
Сообщение msg = LocaleMan.get (playerRef, "messages.welcome")
&nbsp; &nbsp; Map.of("player", player.getUsername()));

// Сырая строка для конкретной локализации
Текст строки = LocaleMan.getRaw("en\_US", "messages.welcome");

// Проверьте, какие места загружаются
Set loaded = LocaleMan.getLoadedLocales();

Пример языкового файлаlocales/en_US.json):

{
"префикс": "&e [MyPlugin]&r",
"Сообщения": {
"Добро пожаловать, &aWelcome, &e{player}&a!",
"Прощай": "&7Goodbye, &e{player}&7!"
?
«Ошибки»: {
«No_permission»: «У вас нет разрешения на это». ,
«Not_enough_coins»: «Вам нужны монеты». У тебя есть время".
?
?

Особенности:

Языковые файлы на основе JSON (без внешних зависимостей)
Автоматическое разрешение заполнителя с [заместитель] синтаксис
Обнаружение языка игрока в настройках клиента
Сеть Fallback: Player locale → Default locale (en_US)
Thread-safe с поддержкой параллельного доступа
Горячая перезагрузка через /kuksolib скачать
Поддержка цветового кода в переводах (интегрируется с ColorMan)

Hytale поддерживает только английский язык в раннем доступе.

Колоризация чата модуль

Перевод цветовых кодов в стиле Minecraft в формат сообщений Hytale.

Импорт com.kukso.hy.lib.util. Человек;

Основные цветовые коды - возвращает объект Hytale Message
Сообщение msg = ColorMan.translate ("&aGreen &bAqua &cRed")

Множественные цвета в одном сообщении
Сообщение msg = ColorMan.translate("&4Hel&clo&bWo&1rld!");
// Результат: «Hel» темно-красный, «lo» красный, «Wo» аква, «rld!» темно-синий

// Цветовая поддержка Hex
Сообщение msg = ColorMan.translate("&#FF5733) Это оранжевый!

// Форматирование кодов
Сообщение msg = ColorMan.translate («&l&4Bold Red &r&oItalic White»);

// В сочетании с локализацией
Сообщение msg = LocaleMan.get (игрок, "messages.welcome") Уже цветные!

player.sendMessage (msg);

Поддерживаемые коды:

Цвета наследия: &0-9, &a-f (стандартные 16 цветов Minecraft)
Шестицветные: #RRGGBB (например, #FF5733)
Смелый: ил
Курсив: и
Перезагрузка: &r (сбрасывает цвет и форматирование)

Особенности:

Поддержка устаревшего цветового кода
Поддержка цвета Hex для пользовательских цветов
Несколько цветов в одном сообщении
Формат кодов (смелый, курсив)
Бесшовная интеграция с LocaleMan
Возвращение объектов Hytale Message

Примечание: Подчеркнуть ()и), пробить (&m) и запутанные (инк) не поддерживается API сообщений Hytale.

Показать оригинальное описание (English)

"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",  
&nbsp; &nbsp; 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: