LibJF — технический мод-библиотека и ядро для поддержки сторонних модификаций в Minecraft

LibJF — технический мод-библиотека и ядро для поддержки сторонних модификаций в Minecraft

LibJF — это модульная библиотека от автора JFronny, содержащая набор общих компонентов для его же модов. На компьютер игрока этот мод обычно ставят не сам по себе, а как обязательную зависимость — без него соответствующие моды не запустятся. В Minecraft LibJF не добавляет рецептов, мобов или новых блоков. Его задача в другом: вынести повторяющийся функционал — формат конфигов, систему перевода, локальный HTTP-сервер, два служебных тега — в отдельный проект и использовать его повторно в разных модах одного разработчика.

Назначение в сборке

Библиотека разделена на отдельные модули, каждый из которых отвечает за свою задачу: формат конфиг-файлов и их внутриигровое меню, теги для предметов, перевод, сетевые компоненты. Моды, зависящие от LibJF, подгружают только те модули, которые реально используют. Поэтому после первого запуска игры в папке config/ появляется не один файл, а несколько — по одному на активный модуль.

Один из базовых эффектов, который игрок заметит сразу — автоматическая перезагрузка конфигов. Параметр watchForChanges по умолчанию включен: если изменить любой конфиг-файл, работающий через LibJF, правки подхватятся без перезапуска игры.

Универсальные теги для предметов и брони

LibJF добавляет два тега, которые доступны как другим модам, так и ванильным датапакам:

Сами теги пустые — наполнение делает датапак или сторонний мод. Чтобы в выживании сделать, например, полный кожаный набор «непробиваемым», достаточно создать небольшой датапак, который добавит minecraft:leather_helmet, minecraft:leather_chestplate, minecraft:leather_leggings и minecraft:leather_boots в файл тега libjf:overpowered.

Подсистема перевода

Модуль libjf-translate-v1 дает другим модам разработчика доступ к сервису перевода строк. Сама библиотека ничего не переводит в чате или интерфейсе — она лишь определяет, через какой внешний сервис пойдут запросы, если мод-потребитель их вызовет. Поддерживается четыре варианта провайдера:

• Google — публичный интерфейс переводчика Google (значение по умолчанию).

• DeepLX — открытая реализация API DeepL.

• LibreTranslate — селфхост-решение с открытым исходным кодом; требует отдельно указать адрес инстанса.

• Noop — заглушка, которая возвращает входящий текст без изменений; удобно для тестов и для полного отключения перевода.

Отдельный параметр throttleMillis задает минимальную паузу между вызовами сервиса. Это ограничение нужно, чтобы не получить временную блокировку со стороны бесплатного API при частых запросах от мода-потребителя.

Локальный веб-сервер

Модуль libjf-web-v1 поднимает внутри игры небольшой HTTP-сервер. Он используется другими модами автора тогда, когда нужно отдать клиенту что-то большее, чем обычный сетевой пакет — например, статичную страницу или файл предпросмотра. На стандартном рабочем месте игрока этот модуль обычно молчит: порт открыт только локально (127.0.0.1), а раздача файлов выключена.

Админы приватных серверов могут включить раздачу любых файлов из папки config/wwwroot как статичных ресурсов через отдельный параметр конфига — это опциональная возможность, не активированная по умолчанию.

Заключение

LibJF — это библиотека-зависимость, нужная тогда, когда в сборке присутствует мод того же разработчика или датапак, использующий теги libjf:overpowered или libjf:shulker_boxes_illegal. На фоне других библиотек подобного класса его отличает модульная архитектура и наличие локального HTTP-сервера вместе с переводческим слоем, чего большинство вспомогательных библиотек не предлагает. Для обычной ванильной сборки Minecraft Java Edition LibJF устанавливать нет смысла; для сборок с модами JFronny — это обязательный компонент.