Kilnwork: техническая библиотека для модов Minecraft
Если вы ставите порты модов KnightMiner от Vladeezyy, то рано или поздно встречаете в логах или в списке зависимостей загадочное имя Kilnwork. Это не отдельный контентный мод с новыми блоками и механиками, а небольшая служебная библиотека, которая обеспечивает работу других дополнений. Разберёмся, что внутри, кому она нужна и стоит ли её вообще трогать вручную.
Kilnwork — это библиотечный мод для NeoForge, на котором держатся порты Ceramics и неофициального порта Inspirations. По сути это набор технических решений, вынесенных в отдельный jar, чтобы авторы модов не дублировали один и тот же код в каждом проекте. Библиотека собрана из тех частей Mantle от SlimeKnights, которые нужны этим модам, но переписана под более новые версии игры, поскольку у самого Mantle нет релиза для актуальных сборок.
Нужно ли устанавливать Kilnwork отдельно
Короткий ответ: обычным игрокам — нет. Моды, которые используют эту библиотеку, поставляют её внутри своего jar-файла. То есть при скачивании Ceramics или порта Inspirations Kilnwork уже лежит внутри и подгружается автоматически. Отдельная страница существует для того, чтобы у библиотеки был свой дом: исходники, лицензия и понятное описание для тех, кто собирает сборки или разбирается в зависимостях.
Отдельная установка имеет смысл в двух случаях: вы разработчик и хотите собрать мод с нуля, либо вы вручную чините конфликт зависимостей в большой сборке. В остальных ситуациях достаточно просто поставить основной мод.
Что внутри библиотеки
Функционал Kilnwork условно делится на несколько блоков, и каждый из них закрывает конкретную задачу мододела.
Ретекстурированные блоки
Одна из самых заметных возможностей. Блок может принимать текстуру другого блока — например, полки из любого вида плит или кусты из любой листвы. Реализация включает компонент текстуры, модели блока и предмета, рецепт крафта, который передаёт текстуру дальше, а также поддержку JEI. Именно на этом строится вариативность декоративных элементов в портах.
Инвентари, меню и рендер
Библиотека даёт готовые решения для блоков с инвентарём и их меню, а также помогает с позициями предметов для рендереров блок-энтити. Это та самая «невидимая» часть, благодаря которой сундуки, печи и прочие контейнеры выглядят и работают корректно.
Жидкости и их отображение
Отдельный пласт — жидкостные индикаторы, формы жидкостей и их рендер для блок-энтити. Сюда же относятся передачи жидкостей на основе данных: миски, бутылки и прочая тара. Всё это описано в датапаках, а не зашито жёстко в код, что упрощает настройку.
Хелперы регистрации и совместимость миров
Есть вспомогательные методы для регистрации блоков вместе с предметами, создания по одному объекту на каждое значение enum и сборки наборов строительных блоков. Отдельно стоит упомянуть чтение стаков предметов формата 1.20 в блок-энтити — благодаря этому старые миры не теряют содержимое контейнеров после обновления.
Тем, кто собирает собственный набор дополнений, удобно держать такие библиотеки под рукой в одном месте: лаунчер foxygame.net подтягивает Kilnwork и совместимые с ним моды из общего каталога, так что версии не приходится подбирать вручную.
Поддерживаемые версии и загрузчик
Kilnwork работает на загрузчике NeoForge. Актуальный список версий Minecraft, под которые есть сборки, выглядит так:
- 1.21.1 — основная ветка разработки;
- 1.21.11;
- 26.1.2;
- 26.2;
- 26.3.
Исходный код открыт: репозиторий расположен на GitHub по адресу github.com/Vladeezyy/kilnwork, причём на каждую версию игры заведена отдельная ветка. Основная ветка main соответствует 1.21.1, остальные имеют имена вида mc/<версия>. Лицензия — LGPL-3.0-only. Часть кода основана на Mantle от SlimeKnights под лицензией MIT, и текст этой лицензии поставляется вместе с библиотекой.
Как установить
Если вам всё же нужно поставить библиотеку вручную, порядок действий стандартный для NeoForge:
- убедитесь, что у вас установлен NeoForge нужной версии и игра запускается;
- скачайте Kilnwork для Minecraft, выбрав сборку строго под свою версию игры;
- поместите jar-файл в папку mods рядом с основными модами;
- запустите игру и проверьте лог на отсутствие ошибок загрузки.
Главное правило — соответствие версий. Файл, собранный под 1.21.1, не заработает на 26.2, и наоборот. Если вы используете лаунчер с автообновлением, он сам подставит подходящую сборку и предупредит о несовместимости.
Итог
Kilnwork — это типичная «библиотека за кулисами»: игрок редко замечает её напрямую, но без неё порты Ceramics и Inspirations просто не запустятся. Обычному пользователю достаточно знать, что она уже входит в состав нужных модов, а разработчику — что внутри есть готовые решения для ретекстурирования, жидкостей, меню и регистрации, с открытым исходным кодом и понятной лицензией. Если вы собираете сборку вручную, держите версию библиотеки в соответствии с версией игры и загрузчиком NeoForge — и всё заработает без лишних правок.