Thaumcraft API

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

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
  • 复合元素 - 由原始元素组合形成的 37+ 种复合元素
  • 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 坐标封装类