Balm — мод-библиотека для работы модов на разных загрузчиках в Minecraft
Balm — общая библиотека, благодаря которой моды для Minecraft одинаково работают на Fabric, Forge и NeoForge. Когда она нужна и как её…
Balm — общая библиотека, благодаря которой моды для Minecraft одинаково работают на Fabric, Forge и NeoForge. Когда она нужна и как её установить.
Balm — мод-библиотека для работы модов на разных загрузчиках в Minecraft
Версия Minecraft, на которой протестирована и написана статья: 26.1.2
Диапазон поддерживаемых версий: 1.18.x – 26.2
Balm — это библиотека, от которой зависят другие моды для Minecraft; сама по себе она не добавляет блоков, предметов, мобов или механик. Устанавливать её отдельно нет смысла: она нужна только тогда, когда другой мод указывает Balm как обязательную зависимость. Задача библиотеки — дать авторам модов общий код, который одинаково работает на Fabric, Forge и NeoForge, без отдельной версии под каждый загрузчик.
Зачем нужен Balm
Каждый загрузчик модов устроен по-своему: регистрация предметов, обработка событий, сеть и настройки в Fabric, Forge и NeoForge выполняются разными способами. Без промежуточного слоя автору пришлось бы писать отдельную версию кода под каждый из них. Balm берёт эту разницу на себя — мод обращается к общему набору инструментов библиотеки, а она уже переводит вызовы на язык конкретного загрузчика.
Для игрока следствие простое: один и тот же мод может выходить сразу для трёх загрузчиков, и поведение везде одинаковое. Если на странице нужного мода в списке зависимостей стоит Balm — достаточно скачать оба файла под свой загрузчик и версию Minecraft и положить их в папку mods.
Версия библиотеки должна соответствовать версии Minecraft и загрузчику, под который собран основной мод. Файл Balm для Fabric не запустится на Forge и наоборот.
Что библиотека берёт на себя
Вне игры Balm не видна, но именно она отвечает за часть того, как ведут себя моды на её основе. Библиотека охватывает несколько направлений:
регистрация содержимого — предметы, блоки и другие объекты мода добавляются через общий механизм;
события игры — мод реагирует на действия игрока и мира через единый набор обработчиков;
сеть — передача данных между клиентом и сервером, открытие меню с дополнительной информацией;
настройки — система конфигов с возможностью выводить их на отдельный экран в игре.
Отдельно библиотека даёт общие точки доступа к сторонним утилитам: просмотру рецептов, информационным HUD-панелям и модам аксессуаров. Благодаря этому авторам не приходится вручную поддерживать каждую такую интеграцию под каждый загрузчик.
Настройка модов через Balm
Конфиги — одна из немногих частей, которые библиотека реализует самостоятельно, а не просто переводит на загрузчик. Моды на Balm могут выводить свои параметры на отдельный экран настроек, доступный из списка модов, так что редактировать файлы вручную не обязательно.
Вторая заметная для игрока вещь — синхронизация. Часть настроек сервер передаёт клиенту при подключении, поэтому правила одинаково действуют для всех участников. Библиотека также следит за соответствием сетевых версий: если версия мода на клиенте и сервере разная, подключение отклоняется с сообщением, а не приводит к скрытым сбоям уже в игре.
Заключение
Balm позволяет авторам выпускать мод сразу для Fabric, Forge и NeoForge из общего кода, а игроку гарантирует одинаковое поведение на любом из загрузчиков. В отличие от других слоёв абстракции, библиотека обходится официальными инструментами загрузчиков и не тянет за собой сторонних зависимостей. Устанавливать Balm имеет смысл только тогда, когда её требует другой мод; в составе модпаков она обычно уже добавлена автоматически.
Установка
Базовая установка занимает около 5 минут. Общий процесс одинаков, отличается только лоадер и совместимый билд.
- 1Install a mod loader (Forge, Fabric or NeoForge) that matches your Minecraft version.
- 2Download the mod file (.jar) built for that same version.
- 3Place the .jar into your .minecraft/mods folder.
- 4Launch Minecraft with the modded profile and check the mod loads in-game.











