用途:为《魔兽世界》正式服(Retail)插件开发者提供遭遇战相关 API 的完整参考,涵盖 Encounter Journal(首领数据库、掉落表、技能)、C_ChallengeMode(M+ 钥石、词缀、计时)、C_MythicPlus(每周 M+ 记录、评分、赛季)、ScenarioInfo(场景、探秘、阶段)、InstanceLeaverInfo(逃亡者信息)、团队副本锁定与 C_SeasonInfo(赛季内容)。仅适用于正式服。
主要能力:Encounter Journal 提供层级、副本、首领、章节(技能)、掉落、难度与搜索等函数,如 EJ_GetEncounterInfoByIndex、EJ_GetLootInfoByIndex、EJ_SetDifficulty。C_ChallengeMode 提供钥石信息、地图与词缀数据、完成记录与奖励,如 GetActiveKeystoneInfo、GetMapUIInfo、GetCompletionInfo。C_MythicPlus 提供赛季、跑本历史、钥石等级与评分,如 GetRunHistory、GetOverallDungeonScore。ScenarioInfo 提供场景与步骤信息。Raid Locks 提供已保存副本与首领击杀状态。C_SeasonInfo 提供赛季数据。
使用方式:在插件 Lua 中调用上述函数;EJ 数据为异步,读取掉落前需等待 EJ_LOOT_DATA_RECIEVED;EJ 函数作用于当前选中的层级,需先设置层级;RequestRaidInfo() 为异步,需等待 UPDATE_INSTANCE_INFO 事件后再读取已保存副本;钥石插槽需玩家手动与能量之泉交互(硬件事件)。
适用场景:编写首领手册、M+ 追踪、副本锁定查看、场景进度等插件。
限制:仅正式服;GetCompletionInfo() 仅在跑本结束后立即返回数据;M+ 评分按赛季重置;SetSavedInstanceExtend() 需在锁定有效期内调用;探秘、海岛探险与场景共用 ScenarioInfo 但类型标志不同。部分函数与字段的完整细节暂未提供。