Balm: что это, кому нужен мод и как исправить запуск

Что такое Balm

Balm — общая библиотека для модов BlayTheNinth и других проектов, использующих её интерфейсы. Она помогает разработчику поддерживать Forge, NeoForge и Fabric без полного дублирования кода. Для игрока Balm является зависимостью, а не самостоятельным контентным модом. Установка только Balm обычно не добавляет блоки или меню. Видимые функции приходят от Waystones, Cooking for Blockheads и других зависимых проектов.

Balm не смешивает загрузчики

Официальный README прямо поясняет: Balm не является способом запустить Forge-мод на Fabric или наоборот. Он помогает автору выпустить отдельные совместимые сборки. Игрок всё равно должен скачать файл каждого мода под свой загрузчик. Если Waystones Fabric лежит рядом с Balm Forge, общий автор и похожий номер не помогут — загрузка закончится ошибкой metadata или отсутствующего класса.

Когда библиотека нужна

Устанавливайте Balm, когда зависимый мод указывает её в relations или загрузчик сообщает missing dependency. Не добавляйте библиотеку в чистую игру без причины. В готовом модпаке она уже должна входить в manifest; ручное добавление второй версии создаёт дубликат. Для собственного набора сначала выберите контентный мод, затем откройте его зависимости и скачайте соответствующий Balm.

Выбор версии

Сопоставьте Minecraft, Forge/Fabric/NeoForge и диапазон Balm, который требует основной мод. Номер файла может включать несколько частей и не обязан совпадать с Waystones. Используйте фильтры официальной страницы и прочитайте changelog. Не подставляйте сборку соседней версии. В Fabric старых веток проект мог публиковаться иначе, поэтому ссылка из старого гайда не является универсальной для современной установки.

Установка на клиент

Закройте игру, положите jar в mods нужного профиля вместе с зависимым модом и запустите. Если лаунчер использует отдельные instance, откройте их фактическую папку. Не распаковывайте jar. После запуска проверьте список модов и журнал. Если Balm загружена, но Waystones отсутствует, исправляйте файл Waystones; библиотека не устанавливает зависимый мод автоматически.

Установка на сервер

Для общего контентного мода серверу обычно нужны совместимые Balm и сам мод. Остановите сервер, сохраните backup и заменяйте набор согласованно. Игроки должны использовать совместимый client pack. Ошибка dedicated server может исходить от случайного клиентского аддона, поэтому ищите первую строку caused by. Не удаляйте Balm только потому, что её имя встречается в стеке: она могла быть точкой вызова чужого кода.

Ошибка requires Balm

Сравните требуемый диапазон с установленным номером. Удалите дубликат и поставьте подходящий релиз. Если обновление Balm вызывает требование обновить Waystones, меняйте их парой. Не редактируйте зависимость вручную в jar. Когда два мода требуют несовместимые Balm, найдите более новые или более старые версии этих модов, которые рассчитаны на одну ветку Minecraft и загрузчика.

Ошибка после обновления

Верните предыдущий работающий комплект из backup, затем обновляйте один связанный набор. NoSuchMethodError часто означает, что основной мод собран против другой Balm. Config error может быть вторичной: первая ошибка другого мода прервала нормальную инициализацию. Приложите полный журнал и не ориентируйтесь на последнюю строку. Удаление config допустимо только после копии и подтверждения, что версия бинарников совпадает.

Какие моды используют Balm

Waystones — один из известных примеров, но список меняется. Смотрите раздел dependents на официальной странице и manifest конкретного проекта. Не составляйте вечный ручной перечень: новые релизы добавляются, старые меняют зависимости. Для SEO-страницы полезно объяснить процедуру проверки, а не обещать, что любая игра с Waystones требует один и тот же номер Balm.

Диагностика

Укажите Minecraft, Java, загрузчик, Balm, зависимый мод и стороны установки. Приложите latest.log или server log. Создайте минимальный профиль из загрузчика, Balm и одного мода; если он работает, возвращайте остальные группами. Для Fabric-интеграции отметьте дополнительные библиотеки. В issue не публикуйте только скриншот списка mods: текст ошибки позволяет увидеть первый отсутствующий класс или несовместимый метод.

Быстрая проверка перед началом

balm minecraft мод: Сверь версию игры, загрузчик и зависимости. Добавляй моды небольшими группами и сохраняй журнал, чтобы быстро найти причину вылета.

Держи рядом исходные значения и итог проверки: количество ресурсов, время, координаты или сообщение интерфейса. Эти данные полезнее общей оценки «работает», особенно после обновления Java или Bedrock.