配方脚本

基本信息

⚠️ 112 ≠ 111：一个特例

112 个 Script*.java 文件中：

• 110 个在 ScriptLoader 的 Arrays.asList(...) 里以 new ScriptXxx() 形式列出
• 1 个 ScriptZZClientOnly 不在该列表里，而是以静态单例 ScriptZZClientOnly.instance 的形式追加（ScriptLoader.java:129）
• 1 个 ScriptLoader 本身不是脚本，是加载器

所以「112 个文件」与「111 个被加载的脚本」并不矛盾，只是统计口径不同。

功能

IScriptLoader 是本 mod 配方脚本的统一接口，每个实现类负责一个宿主 mod 的配方修补。接口本身提供 4 个 default 方法：

接口注释明确要求：「Avoid manual checks with Loader.isModLoaded」（IScriptLoader.java:36-38）—— 依赖判断应交给 getDependencies() + isScriptLoadable()，而非脚本内手写 isModLoaded。

加载循环

for (IScriptLoader script : scripts) {
    if (script.isScriptLoadable()) {
        script.loadRecipes();
    }
}

依赖不全的脚本被整体跳过，不抛异常、不打日志 —— 这就是 GTNH 配方脚本能安全地横跨上百个模组的原因。

配方登记

addShapedRecipe / addShapelessRecipe 都用 try/catch (Exception) 包裹，失败时打日志 a recipe went wrong: 并返回 false（IScriptLoader.java:58-64、:77-83）。这是有处理的捕获，不是空捕获。

全部 111 个脚本

「依赖」列为 getDependencies() 返回的 Mods 枚举；标「仅 Minecraft」的表示依赖列表不含任何模组。配方数为该文件内 addShapedRecipe + addShapelessRecipe 调用次数。

⚠️ ScriptZZClientOnly 的配方数 0 是统计口径造成的，不是它没有配方。 它是唯一不使用 addShapedRecipe / addShapelessRecipe 的脚本：它直接构造 Forestry 的 CarpenterRecipe 与 ShapedRecipeCustom 对象 （ScriptZZClientOnly.java:27-28 导入，:57 起声明 stamps 数组，:59 起逐个 new）。 本表的「配方数」只统计 IScriptLoader 的两个 default 登记方法，故它计 0。

数值

交互

相关条目

• GT 配方加载器 - 走 GregTech 配方表（而非 GameRegistry.addRecipe）的另一套配方
• 跨模组集成 - 脚本之外的手写兼容代码