Coremod 引导（ClassTransformer）

基本信息

属性	值
类型	FML coremod 加载插件 + 类字节码转换器
实现类	`net.vfyjxf.nechar.core.NechCorePlugin`（`IFMLLoadingPlugin` + `IFMLCallHook`）<br>`net.vfyjxf.nechar.core.NechClassTransformer`（`IClassTransformer`）
来源	`NechClassTransformer` 基于 Towdium 的 JustEnoughCharacters 1.12.0 版 `JechClassTransformer.java` 改写（MIT 协议）

`NechCorePlugin`

成员	值
`getASMTransformerClass()`	`new String[] { "net.vfyjxf.nechar.core.NechClassTransformer" }`
`getModContainerClass()`	`null`（不提供 mod 容器）
`getSetupClass()`	`"net.vfyjxf.nechar.core.NechCorePlugin"`（指向自身）
`getAccessTransformerClass()`	`null`（不使用 AT）
`injectData(Map<String, Object> data)`	空实现
`public static boolean INITIALIZED`	初始 `false`；在 `call()` 中置为 `true`
`call()`	调用 `TransformerRegistry.getTransformer("some.class")` 触发注册表静态块（强制初始化两个转换器），随后 `INITIALIZED = true`，返回 `null`

关键设计：getSetupClass() 返回自身类名，使 FML 在模组容器构造之前就实例化本类并调用 call()。此时配置文件尚未由模组加载，但 TransformerString / TransformerRegExp 的构造器会各自调用 reload() 读取 NechConfig——后者通过自己的 static 块从 config/NotEnoughCharacters.cfg 读值（见配置系统），因此配置在 coremod 阶段就已可用。

`NechClassTransformer`

public byte[] transform(String s, String s1, byte[] bytes) {
    if (NechCorePlugin.INITIALIZED) {
        for (Transformer t : TransformerRegistry.getTransformer(s)) {
            bytes = t.transform(bytes);
        }
        return bytes;
    } else {
        return bytes;
    }
}

要点	说明
开关	仅当 `NechCorePlugin.INITIALIZED == true` 才改写；否则原样返回字节码
参数	`s` 为正在加载的类名，作为 `getTransformer(s)` 的查询键；`s1`（基本类名）与字节码内容未用于其它判断
链式应用	返回值 `bytes` 覆盖进循环变量，因此同一类若命中多个转换器，前一个转换器的输出会成为后一个的输入
顺序	迭代顺序即转换器注册表中 `transformers` 的顺序：`TransformerString` → `TransformerRegExp`

生命周期总览

阶段	触发者	动作
1. coremod 加载	FML 读取 `IFMLLoadingPlugin`	实例化 `NechCorePlugin`，调用 `call()` → 初始化转换器注册表 → `INITIALIZED = true`
2. 类加载	LaunchWrapper 遍历 `IClassTransformer`	`NechClassTransformer.transform` 对每个类查表，命中则用 ASM 改写字节码
3. preInit	`@Mod.EventHandler preInit`	打印 `Not Enough Characters - v<VERSION>`，调用 `onConfigChange()` 把配置提交给 PinIn
4. init	`@Mod.EventHandler init`	注册 `/nech` 客户端指令（见 /nech 命令）
5. 物品列表初始化	`NEINecharConfig#loadConfig`	注册两个搜索提供者（见搜索提供者）

NechClassTransformer 类上标注 @SuppressWarnings("SameParameterValue")——因为 s1 参数未被使用。

安全性说明

TransformerRegistry.getTransformer 返回的列表可能为空，此时循环不执行、字节码原样返回——未列入目标列表的类完全不受影响。改写过程只替换特定方法调用点，不改变类结构。

Coremod 引导（ClassTransformer）

基本信息

NechCorePlugin

NechClassTransformer

生命周期总览

安全性说明

相关条目

`NechCorePlugin`

`NechClassTransformer`