wow-addon-structure

Explain World of Warcraft AddOn folder layout, .toc metadata, and SavedVariables persistence.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a comprehensive guide to structuring World of Warcraft AddOns, managing their metadata via .toc files, understanding the loading lifecycle, and handling persistent data with SavedVariables.

Core Features & Use Cases

  • AddOn Structure: Guidance on folder layout, naming conventions, and file organization.
  • .toc File Authoring: Detailed explanation of directives, metadata, and load conditions.
  • Loading Lifecycle: Understanding the sequence of events from AddOn load to player entering the world.
  • SavedVariables Management: Best practices for declaring, loading, and persisting data.
  • C_AddOns API: How to programmatically query and manage AddOns.

Quick Start

Use the wow-addon-structure skill to understand how to declare SavedVariables in a .toc file.

Frequently Asked Questions about wow-addon-structure

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

FAQPage Schema
How do I structure a World of Warcraft addon folder layout?

To structure a WoW addon, organize your folder layout following specific naming conventions and file organization rules. Proper structure ensures correct initialization when the client loads your addon during the startup sequence.

What is the correct .toc format for declaring SavedVariables in a WoW addon?

The correct .toc format for SavedVariables requires declaring persistent data variables directly in the .toc file using specific directives. This ensures the World of Warcraft client properly loads and saves your addon data between sessions.

How does the WoW addon loading lifecycle work from load to player entering the world?

The WoW addon loading lifecycle follows a specific sequence of events from initial addon load to the player entering the world. Understanding this sequence is essential for planning addon architecture and ensuring correct initialization timing.

Can I use the C_AddOns API to programmatically query addon metadata?

Yes, you can use the C_AddOns API to programmatically query and manage addons. This API provides functions for retrieving metadata and managing load conditions within your World of Warcraft Retail addon architecture.

What are the best practices for managing SavedVariables persistence in Lua?

Best practices for SavedVariables persistence in Lua involve properly declaring variables in the .toc file and managing their load state. This approach guarantees persistent data is correctly loaded and saved across client sessions.