AddonAPI

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

Суть простая: AddonAPI смотрит, какие моды реально загружены в Forge, и подгружает только те части твоих аддонов, которые подходят под эту конфигурацию. Если какой-то целевой мод не стоит в папке mods - просто отключаются связанные с ним расширения. Игра запускается без ошибок, а игрок не видит красных текстов и крашей.

Для какой версии подходит

• Forge для Майнкрафт 1.20.1 (Fabric / NeoForge / Quilt не поддерживаются)

Ключевая фишка

Динамическая загрузка модулей по списку модов (ModList). Если аддон рассчитан на 5 разных модов и у игрока стоит только 3 из них, AddonAPI сам решит, какие фичи показывать, а какие скрыть. Все гибко и без лишнего кода.

Как это работает

• В конфигах аддонов появляется секция compat, где можно для каждого целевого мода указать, включать его или нет.
• Добавлено условие для рецептов (recipe condition), которое смотрит на настройки совместимости. Если мод, нужный для рецепта, отключен в конфиге - крафт тупо не появится у игрока.
• Встроен шаблонный плагин для Mixin, который проверяет, загружен ли нужный мод. Это упрощает написание миксинов.

Как сделать свои модули (для разработчиков)

Если ты пишешь аддон и хочешь, чтобы он дружил с AddonAPI:

1. Создаешь класс модуля, наследуясь от AddonModule.
2. Делаешь провайдер модуля, наследуя AddonModuleProvider. Внутри метода registerRawModules() вызываешь addRawModules() и добавляешь туда свои модули.
3. В конструкторе самого аддона пишешь AddonModuleRegistry.INSTANCE.LoadModule().

Выглядит чуть громоздко, но по факту это стандартный паттерн для таких библиотек.

Настройка совместимости в рецептах

В датапаках (data packs) рецепты оформляются так:

{
  "type": "YOUR_RECIPE_TYPE",
  "conditions": [
      {
        "type": "addonlib:mods_available",
        "required_raw_module": "YOUR_RAW_ADDON_MODULE_NAME"
      }
    ],
    ...
}

Главное тут - не перепутать имя модуля. Если имя совпадает с именем мода, который проверяешь, всё подхватится автоматически.

Итог

AddonAPI - вещь специфическая. Если ты собираешь свою сборку или пишешь что-то сложное с кучей зависимостей - эта библиотека спасет от головной боли. Если играешь на чужой сборке, где она уже стоит - просто радуйся, что меньше крашей. Скачать AddonAPI можно для Forge 1.20.1, и он не будет грузить игру понапрасну.