Kilnwork — библиотека для модов Minecraft на NeoForge

Kilnwork для Minecraft — техническая библиотека для NeoForge: ретекстурированные блоки, жидкости и меню. Узнайте, зачем она нужна и как установить.

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 — и всё заработает без лишних правок.