Witchery++（WitcheryExtras）

[!INFO] Git Commit: ce2dfbe | Updated: 2026-10-01

modid：WitcheryExtras（core/WitcheryExtras.java:40 public static final String MODID = "WitcheryExtras";， 由 @Mod(modid = WitcheryExtras.MODID, ...) 在 WitcheryExtras.java:34 引用）。 gradle.properties 的 modId = WitcheryExtras 一致。 注意大小写混合（Witchery + Extras 首字母大写），不是全小写。

⚠️ mcmod.info 全是构建期占位符，无法从这里读 modid：

"modid": "${modId}", "name": "${modName}",
"version": "${modVersion}", "mcversion": "${minecraftVersion}"

真正的 description 是唯一手写字段："Extends Witchery." （src/main/resources/mcmod.info:6）。

显示名：Witchery++（WitcheryExtras.java:41 NAME = "Witchery++"， gradle.properties 的 modName = Witchery++） 网址： https://github.com/GTNewHorizons/WitcheryExtras 作者： Alkalus / Draknyte1（mcmod.info 的 authorList） 根包名： alkalus.main（gradle.properties 的 modGroup）

一句话：Witchery 的补丁包，不是内容附属

59 个 Java 文件里，本 mod 自己注册的内容极少：

它做的事：

1. 给 Witchery 的烤炉加 11 条配方，并把烤炉的配方查找表整个换掉
2. 修复 Witchery 大蒜配方只认自家大蒜的问题（改走 cropGarlic 矿石字典）
3. 调整 15 类预言的触发权重
4. 修 Resizing 缩小药水在客户端的相机/眼高/同步
5. 放宽祭坛多方块的 TileEntity 数量限制
6. 改若干机器的 GUI 标题与槽位判定
7. 提供人偶架区块加载开关
8. 让 Witchery 的钥匙与人偶能装进 Baubles Expanded 饰品栏
9. 开放 8 类注册表的插件 API

依赖声明

@Mod(dependencies = "required-after:witchery;required-after:spongemixins;") （WitcheryExtras.java:37）

⚠️ 关于 witchery 不在本 wiki 收录范围

Witchery 本体不在本 wiki 的收录范围内（data/relation.md 中没有 witchery 分类）。

因此以下内容本 wiki 不提供，本分类的所有条目都只记录 「Witchery++ 对它做了什么改动」，不复述 Witchery 自身的机制：

• 祭坛的等级、放置规则、旋转与拆除方式
• 烤炉/蒸馏器/纺车/坩埚/茶壶的完整工作流程与产出
• 预言系统的完整语义（15 类预言分别代表什么）
• ItemGeneric 子物品的完整清单
• 人偶（Poppet）10 种类型的具体行为

涉及多方块时特别说明：本 mod 不拥有任何多方块结构。 唯一涉及多方块的是 祭坛多方块结构放宽补丁， 它改的是Witchery 的祭坛，本 mod 只施加两处常量/返回值改写。

modid 陷阱

本 mod 有 3 处 modid 相关的坑：

生命周期

core/WitcheryExtras.java:56-95，@Mod.EventHandler 四个：

ClientProxy.init 另注册 ClientSizeHandler（proxy/ClientProxy.java:11-14）。

⚠️ onServerStopped 清理逻辑的风险

private static void clearPowerSources(PowerSources instance) {
    if (instance == null) return;
    try {
        final Field powerField = instance.getClass().getDeclaredField("powerSources");
        ...
    } catch (NoSuchFieldException | IllegalAccessException e) {
        throw new RuntimeException(e);      // WitcheryExtras.java:112
    }
}

（WitcheryExtras.java:102-114）

Witchery 一旦改名这两个字段，服务端关闭事件会直接抛 RuntimeException。 客户端断线走 @SubscribeEvent onClientDisconnect（WitcheryExtras.java:97-100）， 调用同一个方法。

已确认的源码缺陷

📌 可读性隐患（非行为缺陷）： mixins/late/witchery/TileEntityWitchesOvenMixin.java:108-109 同时存在 itemStack 与 itemstack 两个仅首字母大小写不同的变量。 逻辑正确（熔炼产物 stackSize == 1 时等价于 N → N+1），但极易误改。

条目索引

机制补丁

• 祭坛多方块结构放宽补丁 - 移除 BlockAltar 的 te > 3 检查（3→999），并把结构尺寸 9 改判为 6
• 机器容器与 TileEntity 补丁 - 烤炉 2 个 @Overwrite 换配方表、蒸馏器槽位常量 3→2、纺车原料整批扣除、人偶架区块加载开关、4 个 GUI 标题键、银缸整块禁用
• 变形（Resizing）缩放的同步与相机修复 - 5 个 Mixin + 1 个自有包 + 2 个事件处理器，Y 偏移公式 1.8F × (1 − defaultHeight/1.8F × amp)
• 预言（Predictions）权重重写 - 反射覆写 17 个数组槽的权重，9 种预言类型重建；含数组越界缺陷

配方

• 巫师烤炉配方 - 11 条默认配方（6 原版树苗 + 3 Witchery 树苗 + 2 矿石字典），空罐 = ItemGeneric meta 27
• 大蒜配方修复 - 删原配方后按 cropGarlic 矿石字典重建：4 件猎人大蒜铠甲 + 吸血鬼书

配置

• 配置项 - config/WitcheryExtras/asm.cfg 共 18 项（general 2 + predictions 15 + blocks 1），含空的 debug 分类
• Mixin 补丁总表 - 11 个组 / 22 个类，EARLY 4 组打原版类、LATE 7 组打 Witchery 类

兼容

• Baubles Expanded 兼容 - 门控 3 个 Mixin；女巫门钥匙、罗温钥匙/钥匙串（3 种槽位）、人偶（仅挂饰槽，优先搜背包）

API

• 插件注册 API（RecipeManager） - 8 个注册表嵌套类 + PluginManager 3 个生命周期入口；底层 WitcheryRecipeHandlerInternal 8 对 add/remove

覆盖率

方块/物品覆盖率不适用（注册数为 0）。