Balm (Forge Edition)

Абстракция для нескольких загрузчиков

Balm является библиотекой BlayTheNinth, которая помогает автору поддерживать один мод на Forge, NeoForge и Fabric. Она предоставляет общий слой поверх различий загрузчиков, чтобы значительная часть логики не дублировалась в нескольких проектах.

Для игрока библиотека обычно незаметна. Её устанавливают только как обязательную зависимость другого мода; самостоятельных приключений, миров или производственных систем она не добавляет.

Какие задачи объединяет Balm

Библиотека предоставляет общие интерфейсы и события для типичных задач разработки. Официальное описание называет решение all-inclusive: оно охватывает сетевое взаимодействие, конфигурации и другие базовые механизмы без сторонних зависимостей.

• События дают общий способ реагировать на действия игры.
• Сеть скрывает часть различий передачи данных между платформами.
• Конфигурация позволяет использовать согласованный подход к настройкам.
• Интеграции объединяют работу с Curios или Trinkets, Jade или The One Probe.

Подход проверен более чем на двадцати модах автора, включая крупные дополнения и небольшие улучшения качества жизни.

Чего Balm не делает

Balm не является магическим мостом для одновременного запуска Forge- и Fabric-модов. Каждый мод и каждая библиотека всё равно должны быть собраны под выбранный загрузчик. Наличие общего исходного кода у автора не делает готовые jar-файлы взаимозаменяемыми.

Сравнение с Bookshelf

Bookshelf также предоставляет кросслоадерные события, регистрацию контента и набор утилит для разработчиков. Однако у библиотек разные программные интерфейсы и наборы зависимых проектов. Если мод требует Balm, установка Bookshelf не удовлетворит это требование.

Выбор подходящего файла

На странице проекта представлены отдельные выпуски Balm для Forge, NeoForge и Fabric. Нужно одновременно сопоставить номер Minecraft, тип загрузчика и диапазон версии, указанный основным модом.

Пометки Client и Server не означают, что любой файл подходит любой стороне. Если Balm требуется контентному моду на сервере, согласованная версия часто нужна и клиентам, подключающимся к нему.

Установка Balm

Скачанный jar помещают в mods того же экземпляра, где установлен зависимый проект. При ошибке запуска следует удалить файл для чужого загрузчика, проверить дубликаты и прочитать требуемый диапазон версии в журнале.

Обновлять Balm безопаснее вместе с использующими его модами. Перед сменой большой ветки Minecraft или загрузчика нужна резервная копия мира и проверка сборки в отдельном экземпляре.