wow-api-pvp

Reference World of Warcraft Retail PvP APIs for battlegrounds, arenas, and duels.

1|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/pfchrono/SimpleUnitFrames --skill wow-api-pvp-pfchrono
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wow-api-pvp
Source: https://github.com/pfchrono/SimpleUnitFrames/tree/main/.agents/skills/wow-api-pvp
Command: npx skills add https://github.com/pfchrono/SimpleUnitFrames --skill wow-api-pvp-pfchrono

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a comprehensive reference for World of Warcraft Retail's Player versus Player (PvP) systems, enabling developers and players to understand and interact with battlegrounds, arenas, war mode, and associated APIs.

Core Features & Use Cases

  • PvP API Reference: Detailed information on C_PvP functions for state, rewards, and queuing.
  • Duel & War Game Functions: Covers starting, accepting, and canceling duels and war games.
  • Honor & Conquest Tracking: Information on how to retrieve honor and conquest currency data.
  • Use Case: A developer wants to build an addon that displays a player's current arena rating and upcoming rewards. They would use this Skill to look up the relevant C_PvP functions.

Quick Start

Use the wow-api-pvp skill to get the current PvP season number.

Frequently Asked Questions about wow-api-pvp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I use C_PvP functions to track battleground and arena queuing in a WoW addon?

WoW PvP API functions in `C_PvP` manage battleground and arena queuing, allowing your addon to programmatically retrieve queue states, accept matches, and track active PvP sessions for players.

What WoW API functions are available for reading honor and conquest currency data?

WoW PvP API provides dedicated `C_PvP` functions for retrieving honor and conquest currency data, enabling addons to accurately query and display a player's current PvP currency totals and reward progress.

How do I programmatically start, accept, or cancel duels and war games using the WoW Lua API?

WoW Lua API includes specific PvP functions for starting, accepting, and canceling duels and war games, giving developers direct programmatic control over these specific player versus player interactions.

Does the WoW PvP API support querying rated PvP rewards and arena ratings?

Yes, the WoW PvP API supports rated PvP interactions, providing `C_PvP` functions to query a player's current arena rating and retrieve information about upcoming rated PvP season rewards.

Do I need a deep understanding of the WoW API structure to use PvP functions for war mode?

Yes, effectively using WoW PvP API functions for war mode requires a solid understanding of WoW's internal API structure to correctly handle state changes, activate war mode, and process PvP interactions.