跳到正文
烈焰甘蔗Wiki

Thaumcraft API

[!INFO] Git Commit: ced30ed | Updated: 2015-12-09

审计结论（2026-10-01 回源码核对）

⚠️ modid 无法从本仓源码实读。 本仓是纯接口源码：

  • 全仓 60 个 java 文件中没有任何 @Mod 注解的主类（全量 grep @Mod( → 0 命中）；
  • 不存在 VersionInfo 类，不存在 build.gradle / mcmod.properties / mcmod.info， 因此没有 GRADLETOKEN_MODID 之类的构建期占位符（本仓与 thaumicinsurgence 不同）；
  • 真实 modid 只能在主 Thaumcraft 仓的构建配置里查，本仓无从佐证，故此处不填。
  • 本仓源码中唯一出现的资源命名空间字面量是 "thaumcraft"（父 mod 域，用于元素贴图 thaumcraft:textures/aspects/<tag>.png、焦点/杖贴图、药水图），这不是本 mod 的 modid。

主 Agent 已从主仓补齐（2026-10-01）：查 /Users/evlos/a/mirror/thaumcraft4/， 主 mod 的注解是

@Mod(modid = "Thaumcraft", name = "Thaumcraft", version = "4.2.3.5", ...)   // Ascii.java:82

⇒ thaumcraft-api 自身没有 modid，它是 modid Thaumcraft（驼峰 T） 的纯接口实现库。分类名 thaumcraft-api 与之无关，relation.md 记的 “驼峰转小写” 只描述分类名本身，不代表 modid。

⚠️ 与 thaumicinsurgence 的区别：那个仓至少有 VersionInfo.ModID （虽然是 GRADLETOKEN_MODID 占位符）；本仓连占位符都没有， 因为它压根不是独立 mod。派单时不要预设"每个仓都有 modid"。

API 版本（有源码依据）：package-info.java:1 @API(owner = "Thaumcraft", apiVersion = "4.2.2.0", provides = "Thaumcraft|API") → API 版本 4.2.2.0，owner Thaumcraft，provides Thaumcraft|API（对应 MC 1.7.10）。

Thaumcraft API 是一个纯接口定义库（Pure API Library），用于第三方模组集成 Thaumcraft 的核心功能。该库不包含任何方块或实体的具体实现，所有实现均在主 Thaumcraft 模组中。

核心 API 入口为 ThaumcraftApi.java，提供物品/方块 Aspect 标记、实体标记、多种合成配方（Arcane/Infusion/Crucible）、研究系统、魔杖触发器、Warp 系统、战利品袋等注册接口。

Aspect 系统

Aspects（元素）是 Thaumcraft 的核心魔力系统，所有物品和方块都可以被打上 Aspect 标签。

  • 原始元素 - 6 种基础元素：AER、TERRA、IGNIS、AQUA、ORDO、PERDITIO
  • 复合元素 - 由原始元素组合形成的 42 种复合元素
  • AspectList - Aspect 容器类，管理多个 Aspect 的增删改查
  • Essentia 传输 - IEssentiaTransport 接口，定义 essentia 的传输行为
  • 节点系统 - INode 接口、NodeType 和 NodeModifier 枚举
  • Vis 网络 - VisNetHandler 和 TileVisNode，节点间 Vis 流动

合成系统

Thaumcraft 提供多种合成配方类型，支持 Arcane Workbench、Infusion Altar 和 Crucible。

研究系统

研究系统是 Thaumcraft 的进度机制，玩家通过扫描物品/方块/实体来解锁研究并获得配方。

  • 研究分类 - ResearchCategories 注册和管理研究分类
  • 研究条目 - ResearchItem 和 ResearchPage，定义的每个研究页面类型
  • 扫描系统 - ScanResult 和 IScanEventHandler，扫描物品/方块/实体来推进研究

魔杖系统

魔杖是 Thaumcraft 的核心工具，用于施法、扫描和与方块交互。

  • Focus 核心 - ItemFocusBasic 和 FocusUpgradeType，魔杖的 Focus 升级类型
  • 魔杖杖柄 - WandRod 和 StaffRod，各种杖柄材料及其 Vis 容量
  • 魔杖杖帽 - WandCap，杖帽材料及其 cost modifier
  • 魔杖触发器 - WandTriggerRegistry 和 IWandTriggerManager，魔杖与方块交互
  • Warp 系统 - Warp 扭曲值系统，永久/临时/黏性三种类型

物品效果

与物品相关的特殊效果和接口。

  • Warp 系统 - addWarpToItem/addWarpToResearch，Warp 值的添加和获取
  • 战利品袋 - Loot bag 系统，3 种袋子等级和加权随机掉落
  • 符文护甲 - IRunicArmor 接口，提供额外魔杖充能
  • Vis 折扣 - IVisDiscountGear 接口，穿着时减少 Vis 消耗
  • Warping 装备 - IWarpingGear 接口，增加玩家 Warp 上限
  • 可修复物品 - IRepairable 和 IRepairableExtended 接口

药水效果

  • Vis 耗竭 - PotionVisExhaust，Vis 消耗药水
  • Flux 腐化 - PotionFluxTaint，对被污染生物治疗，对其他生物造成伤害

实体接口

游戏设定

  • ItemApi - 通过反射获取 ConfigItems/ConfigBlocks 中的物品和方块
  • 坐标系统 - WorldCoordinates 和 BlockCoordinates 坐标封装类
浏览全部模组