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。
- Arcane 合成 - 奥法工作台配方,需要 Vis 作为魔力消耗
- Infusion 灌注合成 - 灌注合成,高级配方,支持复杂配方和附魔
- Crucible 坩埚配方 - 坩埚配方,将物品在沸腾液体中转化
- Infusion 附魔 - 通过灌注合成的附魔配方
研究系统
研究系统是 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 接口
药水效果
实体接口
- 被污染生物 - ITaintedMob 标记接口
- 神秘生物 - IEldritchMob 标记接口
- 伤害源 - DamageSourceThaumcraft 和 DamageSourceIndirectThaumcraftEntity