Moff's AddonAPI-DynLoad

Мод Moff's AddonAPI-DynLoad для Minecraft 1.20.1

Moff's AddonAPI-DynLoad — это библиотека-загрузчик (library mod), разработанная для модов Forge и NeoForge. Она предоставляет API, позволяющее аддонам динамически загружать свои модули и расширения только тогда, когда в ModList присутствуют соответствующие целевые моды. Если требуемый мод не установлен, элементы, зависящие от него, автоматически исключаются из загрузки, что гарантирует безопасный запуск игры без ошибок. Библиотека также включает инструменты для настройки совместимости через секцию compat в конфигурациях аддонов.

Основной принцип работы

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

Создание модулей

Для использования функционала библиотеки разработчик должен создать собственный класс модуля, наследуя его от AddonModule. Затем необходимо реализовать провайдер модулей, наследуя класс AddonModuleProvider и вызвав метод addRawModules() внутри registerRawModules(). Финальным шагом является вызов AddonModuleRegistry.INSTANCE.LoadModule() в конструкторе самого аддона, чтобы инициировать процесс загрузки.

Настройка совместимости через `compat`

Библиотека предоставляет механизм для управления логикой рецептов и других данных в зависимости от установленных модов. В секции compat конфигурации аддона можно настроить условия. Например, в рецептах datapack используется условие addonlib:mods_available, которое проверяет наличие конкретного необработанного модуля (raw module). Если модуль найден, рецепт активируется, иначе он игнорируется. Это позволяет создавать гибкие системы, где контент загружается только при наличии соответствующих зависимостей.

Пример условия для рецепта

В секции `conditions` рецепта data pack необходимо указать тип условия `addonlib:mods_available` и имя требуемого модуля. Пример структуры условия выглядит следующим образом:

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

Технические детали файла

Файл распространения — это JAR-архив addonapi-mc1.21.1-2.1.0.jar. Внутри архива находится 22 файла, включая 11 классов Java. Размер упакованного архива составляет 18 518 байт, а распакованного — 38 638 байт. Библиотека не использует миксины (mixins) и не содержит исполняемых файлов. В архиве зафиксирован идентификатор addonapi #mandatory, указывающий на обязательность модуля для работы библиотеки. Также в манифесте указано, что NeoForge является обязательной зависимостью.