wow-api-unit-player

Reference World of Warcraft Retail Unit and Player APIs for unit data.

39|4|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/JBurlison/WoWAddonAPIAgents --skill wow-api-unit-player-jburlison
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wow-api-unit-player
Source: https://github.com/JBurlison/WoWAddonAPIAgents/tree/main/.github/skills/wow-api-unit-player
Command: npx skills add https://github.com/JBurlison/WoWAddonAPIAgents --skill wow-api-unit-player-jburlison

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides comprehensive documentation and examples for interacting with World of Warcraft's Unit and Player APIs, enabling developers to query and manipulate character and unit data.

Core Features & Use Cases

  • Unit Identification: Query names, GUIDs, classes, races, and levels of any unit.
  • Combat & State: Check health, power, status effects (auras), combat state, and group membership.
  • Player Specifics: Access detailed player stats, equipment, PvP info, and movement data.
  • Use Case: An addon developer needs to display a player's current health percentage and active buffs. They would use this Skill to find the relevant API calls for UnitHealthPercent and C_UnitAuras.

Quick Start

Use this skill to get the name and health percentage of your current target.

Frequently Asked Questions about wow-api-unit-player

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

FAQPage Schema
How do I get a target's health percentage using the WoW API in Lua?

To get a target's health percentage using the WoW API, you query unit health functions with the appropriate UnitId token. This skill provides reference for UnitHealthPercent and related calls to retrieve accurate health values for any specified unit.

How do I check active auras and buffs on a unit in WoW addon development?

Checking active auras and buffs on a unit in WoW addon development involves querying aura APIs like C_UnitAuras. This reference details how to retrieve and inspect active status effects, combat states, and group membership for any valid UnitId.

What is a UnitId token and how does it work with WoW API functions?

A UnitId token is a string identifier used to reference specific units in WoW API functions. This skill explains how to use these tokens alongside GUIDs to accurately query unit identity, stats, casting info, and threat data.

Can I access player-specific data like equipment and PvP info with the WoW API?

Yes, you can access player-specific data like equipment and PvP info with the WoW API. This reference covers player-specific functions that enable querying detailed character stats, movement data, and inspection details for the player character.

How do I retrieve unit GUIDs and combat states in World of Warcraft?

Retrieving unit GUIDs and combat states in World of Warcraft requires calling specific API functions with valid UnitId tokens. This skill provides the function signatures needed to accurately extract identity, combat state, and threat information.

Do I need to understand API function signatures to use WoW Unit and Player APIs?

Yes, understanding API function signatures is required for accurate implementation of WoW Unit and Player APIs. This reference provides the necessary function signatures and technical documentation to correctly query and manipulate game data.