Thaumic Machina

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

Thaumic Machina 是 GTNH 1.7.10 的 Thaumcraft 4 法杖改装向附属模组（MODID = ThaumicMachina，作者 jcm2606 / HuggableCreep）。它不是机器/多方块附属：全模组只注册 3 个方块与 3 个物品，核心玩法是通过注魔把「Augmentation（改装）」写进法杖的 NBT，从而改写法杖的最大 Vis 容量、单次 Vis 消耗、法杖符文数量，以及提供清除节点附近 Flux 沾污物的能力。此外它新增 1 套研究树（独立研究分类 THAUMIC_MACHINA_CAT，21 个 ResearchItem）和 1 台以红石脉冲触发的方块改造机。

源码根：/Users/evlos/a/mirror/ThaumicMachina/；包名：jcm2606.thaumicmachina；资源域实际为小写 assets/thaumicmachina/。

维度 内容
模组 ID ThaumicMachina（混合大小写，实测自 @Mod 注解）
名称 Thaumic Machina
Minecraft 1.7.10
Forge 10.13.4.1614
Thaumcraft 依赖 Thaumcraft:1.7.10-4.2.3.5（api，required-after:Thaumcraft）
作者 jcm2606、HuggableCreep
渲染 / 加载 2 个 GTNH Mixin（LATE 阶段）
GUI 数量 1（Node Transmodifier，ID = 0）
自定义网络包 0（无 SimpleNetworkWrapper）
方块 / 物品 3 / 3
改装（Augmentation） 5 法杖改装 + 2 节点改装
配方总数 6（1 奥术工作台 + 5 注魔）
条目数 20（3 方块 / 3 物品 / 5 改装 / 9 机制）

方块列表

  • Node Transmodifier - 3 个方块中唯一的机器；4 槽 TileNodeTransmodifier，红石脉冲时扫描 13×13×13 体积内的 Aura Node 并注入节点改装
  • Metaphysical Brick - 仅戴 IRevealer 护目镜时才有碰撞/可选取的「形而上」砖块，绑定 TileMetaphysical
  • Metaphysical Rose - 同上的植物材质版本，绑定 TileMetaphysicalRose

物品列表

  • Node Augmentation - 节点改装载体物品，NBT 字符串 nodeAugmentation 区分 2 种 meta
  • Wand Augmentation Core - 唯一有配方的 TM 物品（奥术工作台，ORDER 25）
  • Celestial Wand Core - ItemWandCore 唯一 subtype celestial；未注册进 WandRodRegistry，且无配方（源码现状）

法杖改装列表

  • Charge Buffer - Vis 容量 ×1.25（getMaxVis mixin，int 运算 *5/4）
  • Vis Channel - Vis 消耗 ×0.9（同时作用于 getBaseCostModifier 与 getSpecialCostModifier）
  • Taint Capping - 准星指向 Flux Gas/Goo 时吸收周围 5×5×5 的沾污物换成 Vis（唯一有实际效果的高级改装）
  • Tainted Core - Taint Capping 的前置改装；无任何功能实现
  • Contact Discharge - 无任何功能实现

机制与设置

  • Node Transmodifier GUI - GUI ID 0，4 个 SlotLocked 改装槽（起始 x=20, y=47，间距 40px）
  • 节点改装系统 - 2 种节点改装（Dual Charging / Enhanced Recharging）及其互斥规则
  • 事件处理器 - 3 个 Forge 事件：隐形方块拆除、深红研究解锁、法杖 Vis 近战（≥6 要素各 >15 → 4 点魔伤）
  • Flux Wand Trigger - 覆盖 performTrigger 恒返回 true 的空实现，同时注册到 Flux Gas / Flux Goo
  • 研究树 - 独立分类 THAUMIC_MACHINA_CAT，21 个 ResearchItem，6 组分支
  • 配置文件 - research.concept.mode 0/1/2 三档
  • 命令行 - /thaumicmachina（别名 /tm）wandaugmentation add|remove|reset
  • 符文渲染 Mixin - 修正符文悬浮高度、起始位置与数量（杖 8 个 / 权杖 6 个）
  • 创意标签页 - thaumicMachina，图标 = Wand Augmentation Core

跨条目交叉引用

  • Augmentation NBT 契约：所有法杖改装以 NBTTagList（字符串）存于法杖 NBT 的 Augmentations 键；主 ID 与 alias ID 均可命中，删除走同一列表。
  • 法杖 tooltip（客户端唯一入口）：RenderEventHandler.onItemTooltip（client/event/RenderEventHandler.java，由 ProxyClient.preInit 注册）。对带 Augmentation 的法杖：默认显示金色 [Augmented] + Hold [CTRL]；按住左/右 Ctrl 时改为金色 Augmentations installed: + 每条改装的深灰 tm.augmentation.<主ID>。lang 仅定义 5 个 tm.augmentation.*。
  • TESR 绑定：ProxyClient.preInit 一次性 bindTileEntitySpecialRenderer 3 个 TE（TileNodeTransmodifier / TileMetaphysical / TileMetaphysicalRose），本 mod 全部方块渲染均走 TESR，无一个是普通方块模型。
  • 注魔配方链：Wand Augmentation Core（奥术台）→ 5 个法杖改装（注魔）→ 节点改装需先有 Node Transmodifier。
  • Node Transmodifier：唯一的节点改装施放装置，同时是本模组唯一的 GUI 方块。
  • Mixins 优先级：WAND_AUGMENTATIONS 改数值，RUNE_RENDERING 改表现，二者同在 LATE 阶段。

第三方模组集成

  • Thaumcraft 1.7.10-4.2.3.5（api 硬依赖，源码 required-after:Thaumcraft）
    • ThaumcraftApi.addArcaneCraftingRecipe / getCraftingRecipes().add 注册 6 个配方
    • WandRodRegistry.registerWandBlockTrigger 覆写 Flux Gas / Flux Goo 的法杖触发
    • ResearchCategories / ResearchItem / ResearchPage 整套研究 API
    • IRevealer（thaumcraft.api.nodes）判定玩家是否佩戴护目镜
  • Baubles-Expanded 2.2.21-GTNH（runtimeOnlyNonPublishable，编译期不依赖）—— 见 baubles-expanded
  • AspectRecipeIndex 1.1.1（runtimeOnlyNonPublishable，编译期不依赖）—— 见 aspectrecipeindex
  • GTNHLib / UniMixins（由 GTNH 构建脚本注入，承载 Mixin 框架）—— 未收录于本 wiki