AddonAPI

AddonAPI

一个库模组，为基于Forge加载的模组的附加模组提供动态加载对象的API。

基础库

AddonAPI

AddonAPI 是一个库模组，提供基于 Forge 加载的模组来动态加载附加模组（addon）中对象的 API。如果某个目标模组未加载，则仅排除与该模组相关的扩展元素，从而使 Minecraft 能够安全启动。

支持版本

  • Minecraft 1.20.1 的 Forge

主要特性

  • 根据 ModList 动态加载已注册的模块。
  • 在附加模组的配置中添加 compat 部分，可针对每个目标模组进行配置。
  • 提供一个配方条件，根据 compat 配置决定是否加载配方。
  • 包含一个用于检测模组加载状态的模板 Mixin 插件。

创建模块

  1. 通过继承 AddonModule 创建模块类。
  2. 通过继承 AddonModuleProvider 创建模块提供者，并在 registerRawModules() 方法中调用 addRawModules()。
  3. 在你的附加模组的构造函数中调用 AddonModuleRegistry.INSTANCE.LoadModule()。

使用 compat 设置

在数据包配方中，使用以下格式：

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