用途:为魔兽世界正式服插件开发提供 PvP 相关 API 参考,覆盖战场、竞技场、评级 PvP、战争模式、决斗与战争游戏。
主要能力:C_PvP 提供 PvP 状态与匹配判断(IsArena、IsInBattleground、IsWarModeActive 等)、评级奖励与赛季信息、荣誉与征服点信息;还包含战场计分(GetBattlefieldScore 等)、队列相关函数(JoinBattlefield、AcceptBattlefieldPort、GetBattlefieldStatus)、决斗函数(AcceptDuel、CancelDuel、StartDuel)、战争游戏函数(C_PvP.StartWarGame)以及 PVP_MATCH_ACTIVE、UPDATE_BATTLEFIELD_STATUS、DUEL_REQUESTED 等关键事件。
使用方式:通过全局与 C_PvP 命名空间调用上述函数,并监听对应事件更新插件界面或状态。文档给出若干常见写法示范,如根据 C_PvP.IsArena 等判断当前 PvP 上下文,以及循环 GetPvpTierID 与 GetPvpTierInfo 展示评级信息。
限制:战争模式仅能在暴风城/奥格瑞玛切换;GetBattlefieldScore 索引从 1 开始,未必与玩家顺序一致;GetBattlefieldStatus 使用队列索引;PvP 天赋由 C_SpecializationInfo 管理;接受战场传送需硬件事件;12.0.0 中敌方玩家信息可能为秘密值;荣誉与征服点为货币,需用 C_CurrencyInfo 追踪;评级数据每赛季重置。
注:资料标注适用于 Patch 12.0.0(Build 65655,2026 年 1 月 28 日),仅限正式服。