API 参考 / 入口与生命周期

ModLoadStatus

模组加载状态枚举，由宿主管理器（ModManager.getLoadStatus(id) / ModManagerAccess.getLoadStatus(id)，见 ModManagerAccess）返回，用于向玩家展示每个模组的状态。

方法速览

方法	用途
`values()`	全部常量（枚举生成）
`valueOf(String)`	按名称取常量（枚举生成）

java

public enum ModLoadStatus {
    NOT_REGISTERED,
    REGISTERED,
    LOAD_FAILED,
    ACTIVE,
    UNLOADED
}

常量	含义
`NOT_REGISTERED`	未注册（id 不在 registered 中，且没有注册前失败的 jar 记录）
`REGISTERED`	已注册、未启用（或启用集合尚未刷新）
`LOAD_FAILED`	启用但加载失败（依赖缺失 / 循环依赖 / 生命周期回调抛异常 / API 版本不匹配 / 类加载失败）
`ACTIVE`	已激活（已成功执行到 `onInit`）
`UNLOADED`	曾经激活后被禁用；当前实现不会返回该值（停用只在下次启动生效），保留供后续版本

宿主判定顺序：先看是否活跃 → ACTIVE；再看注册前失败的 jar → LOAD_FAILED；再看是否注册 → NOT_REGISTERED；再看是否有加载错误 → LOAD_FAILED；否则 REGISTERED。

线程：源码未声明额外线程约束。

稳定性：2.0 起冻结：2.x 内只增不破（禁止删签名 / 改签名 / 改语义）；破坏性变更只在 major 版本发生且须提供迁移指南与至少一个大版本的弃用期。3.x 内继续只增不破。