MaFgLib

MaFgLib: библиотека для портов модов masa

MaFgLib - библиотечный мод для Майнкрафт, неофициальный порт MaLiLib для Forge и NeoForge. Он нужен как зависимость для портированных модов masa: предоставляет общий код настроек, горячих клавиш и графических интерфейсов. Если нужный мод при запуске требует MaFgLib, одной установки самого мода недостаточно.

Это техническая основа, а не самостоятельное дополнение к выживанию. От MaFgLib не стоит ждать новых блоков, мобов или рецептов. Изменения становятся полезны через моды, которые обращаются к библиотеке: используют ее настройки, обработку клавиш и элементы меню.

Для Minecraft 1.20.4-1.20.6, а также выпусков ветки 1.21.x до 0.2.3 включительно требуется BadPackets. Требование относится к определенным выпускам MaFgLib, поэтому при подборе файлов учитывайте и версию Minecraft, и версию самой библиотеки.

Что делает библиотека

MaFgLib переносит общую кодовую базу модов masa в среду Forge и NeoForge. Вместо того чтобы каждый раз писать одинаковые служебные системы заново, разработчики могут использовать готовые компоненты:

• Настраиваемые параметры. Общая основа для настроек, к которым обращаются зависимые моды.
• Система привязки клавиш. Код для назначения и обработки горячих клавиш. Какие именно действия доступны игроку, определяет уже установленный мод.
• Компоненты графического интерфейса, или GUI. Средства для создания большей части интерфейсного кода: экранов, меню и других элементов управления.
• Вспомогательные компоненты. Общие служебные функции, которые могут использовать другие моды.
• Регистрация экрана настроек. В порт добавлен ModConfigScreenRegister, позволяющий регистрировать экран конфигурации.[

](/mod/mafglib)Для игрока главное здесь - правильная версия зависимости. Сама библиотека не включает функции всех модов masa и не заменяет их установку. А наличие ModConfigScreenRegister не означает, что у любого стороннего мода автоматически появится меню: разработчик должен использовать этот механизм.

Чем MaFgLib отличается от MaLiLib

MaLiLib расшифровывается как Masa's Litemods Library. Название MaFgLib следует тому же принципу: Masa's mod Forge port Library, то есть библиотека для Forge-портов модов masa. При этом проект предназначен для портов под Forge и NeoForge.

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

Это особенно полезно помнить при переносе сборки модов между загрузчиками. Установка библиотеки для Forge или NeoForge сама по себе не делает совместимым мод, выпущенный для Fabric. Нужен соответствующий порт самого мода, а затем уже его зависимости.

Как установить MaFgLib

Порядок установки такой же, как у других библиотечных модов для Minecraft:

1. Проверьте, что нужный вам мод действительно требует MaFgLib, и уточните его загрузчик: Forge или NeoForge.
2. Подберите выпуск библиотеки под версию Minecraft и требования зависимого мода. Совпадения только названия проекта недостаточно.
3. Поместите файл .jar в папку mods нужного игрового профиля. Распаковывать его не нужно.
4. Для Minecraft 1.20.4-1.20.6 и указанных старых выпусков ветки 1.21.x добавьте совместимую версию BadPackets.
5. Запустите профиль с выбранным загрузчиком.[

](/mod/mafglib)Нюанс для сборок: у разных профилей лаунчера могут быть отдельные папки mods. Если библиотека уже добавлена, а игра все равно сообщает об отсутствии MaFgLib, сначала проверьте папку запускаемого профиля. Затем сравните версии Minecraft, загрузчика и зависимостей.

Что проверить при ошибке запуска

Игра требует BadPackets

Для перечисленных выше выпусков BadPackets - обязательная зависимость. Если сообщение об ошибке указывает именно на нее, проверьте наличие библиотеки и соответствие ее файла вашей версии игры и загрузчику. Переустановка одного MaFgLib не устранит отсутствие другой зависимости.

MaFgLib установлен, но зависимый мод не запускается

Проверьте требования самого мода: ему может быть нужен определенный выпуск библиотеки, а не просто любой файл MaFgLib. Также убедитесь, что в папке mods не остались несколько версий одного проекта. При обновлении библиотеки старый .jar обычно заменяют новым, а не хранят рядом.

Можно ли удалить MaFgLib из сборки

Если от MaFgLib зависят другие установленные моды, удаление библиотеки может остановить запуск игры. Убирать ее отдельно стоит только после проверки зависимостей. Это не необязательная настройка интерфейса, которую можно отключить без последствий, а код, необходимый другим модам для работы.

MaFgLib имеет смысл устанавливать под конкретную зависимость. Для обычного Майнкрафт без использующих ее модов отдельной игровой пользы от библиотеки нет.