配置项

基本信息

asm.cfg 这个名字是历史遗留（ASM = 早期 “Another Skin Mod”）， 现在与 mixin 补丁无关，不要按名字推断其作用。

general（2 项）

enablePatchNEI 门控的是 Mixin 是否应用，因此改完必须重启游戏， 光重载配置无效。

predictions（15 项）

调用的类：PredictionHandler.adjustPredictions()（见 预言权重重写）。 所有值都是 int 权重，无范围限制（prop.getInt(默认) 不带上下界）。

⚠️ 源码缺陷：chancePredictionSpawnFriendlyWolf 的注释字符串没写完—— prop.comment = "Adjusts weight for ";（AsmConfig.java:154），末尾直接是分号。 生成出来的 cfg 里这一项的说明就是半句话。

📌 默认值 ≠ 生效保证：这 15 个默认值会被 PredictionHandler 的 17 元素数组按下标读取，其中 aNewValues[-1] 越界、 下标 17 无对应配置。详见 预言权重重写 的 「数组越界 + 下标错位」一节——不要把上表默认值当成「实际生效的权重」。

blocks（1 项）

分类名是 blocks 但只有 1 项，且它不禁用本 mod 的方块（本 mod 没有方块）， 禁用的是 Witchery 的银缸。该开关不标记 setRequiresMcRestart(true)， 但它改变的是方块注册阶段，实际上仍需重启才能改变结果。

⚠️ 空的 debug 分类

ArrayList<String> propOrderDebug = new ArrayList<>();          // AsmConfig.java:46
...
config.setCategoryPropertyOrder("debug", propOrderDebug);     // AsmConfig.java:179

propOrderDebug 被创建并传给 setCategoryPropertyOrder("debug", ...)， 但全代码库没有任何一处往 debug 分类加过属性 （grep '"debug"' 只命中 AsmConfig.java:179 一行）。 即 debug 是一个永远为空的分类。

异常处理

AsmConfig.java:184-186：

} catch (Exception var3) {
    FMLLog.log(Level.ERROR, var3, "Witchery++ ASM had a problem loading it's config", new Object[0]);
}

整个 syncConfig 包在一个 catch (Exception) 里。 任一配置项读取失败只打 ERROR 日志，所有 public static 字段保留 Java 默认值 （boolean = false，int = 0）——注意 0 权重与配置默认值 2/3/13 差别很大， 配置损坏时预言权重会全部变成 0。

📌 异常信息里写的是 "Witchery++ ASM had a problem loading it's config"—— 仍用旧名 ASM，且 it's 应为 its。

关联

• 15 个预测开关的运行时消费见 预言权重重写
• allowPoppetShelfChunkLoading 的效果见 机器容器与 TileEntity 补丁
• enablePatchNEI 门控的 Mixin 见 Mixin 补丁总表