用途:为魔兽世界正式服插件开发提供天赋、英雄天赋、Trait 系统与专精相关 API 的完整参考,资料截至 Patch 12.0.0(Build 65655,2026年1月28日),仅适用于正式服。
主要能力:C_ClassTalents 负责天赋配置(loadout)管理、导入导出与提交;C_Traits 提供底层节点、词条、定义、条件与货币接口;C_SpecializationInfo 与全局专精函数用于查询和切换专精。系统为分层结构:专精为顶层,C_ClassTalents 管理配置与天赋树交互,C_Traits 处理节点级操作,英雄天赋为子树形式(SubTreeSelection 节点类型)。
使用方式:通过 GetSpecialization() 获取当前专精索引,再用 GetSpecializationInfo() 取得 specID 等信息;用 C_ClassTalents.GetActiveConfigID() 获取活动配置,配合 C_Traits.GetTreeNodes / GetNodeInfo 遍历天赋树;导入导出使用 C_ClassTalents.ImportLoadout 与 GetLoadoutExportString,提交使用 CommitConfig。
限制与注意:configID 按专精划分,切换专精后活动配置会变化;战斗中无法更改天赋或切换专精;C_Traits 为通用系统,职业天赋、英雄天赋与专业专精共用,靠 configType 区分;GetNodeInfo 开销较大,遍历整棵树时应缓存,不要在 OnUpdate 中调用;导出字符串格式为内部实现,不应手动解析;GetSpecialization() 返回的是索引(1-4)而非 specID。