mcpField
W
wow-addon-structure

wow-addon-structure

github.com/jburlison开发4677 次安装37 周前更新
代码仓库

关于 wow-addon-structure

面向 World of Warcraft Retail AddOn 开发者的参考技能，涵盖目录布局、.toc 文件、加载顺序与 SavedVariables。内容针对 Patch 12.0.0，并说明第三方 AddOn 的受限指令及相关 API。

主要功能

  1. 01AddOn 目录布局与命名
  2. 02.toc 元数据和文件顺序
  3. 03加载生命周期与登录事件
  4. 04SavedVariables 持久化
  5. 05C_AddOns 元数据与加载 API
  6. 06检查 Blizzard UI 源码

适用场景

  1. 01设计或审查 AddOn 目录结构
  2. 02编写或审核 .toc 文件
  3. 03规划初始化顺序与登录事件
  4. 04排查 SavedVariables 持久化问题

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/jburlison/wowaddonapiagents --skill wow-addon-structure

安装后在 Claude Code 中输入/wow-addon-structure确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
ADDON_STRUCTURE.md
C_ADDONS_API.md
LOADING_LIFECYCLE.md
SAVED_VARIABLES.md
TOC_FORMAT.md
VIEWING_BLIZZARD_UI.md

详细介绍

WoW AddOn 结构（Retail）

范围

  • 仅限 Retail，内容截至 Patch 12.0.0。
  • 重点介绍文件夹布局、.toc 元数据、加载顺序和 SavedVariables。
  • 避免使用已弃用或已移除的 API，并指出受限指令。

何时使用此技能

在需要以下操作时使用此技能：

  • 设计或检查 AddOn 文件夹布局。
  • 编写或审查 .toc 文件。
  • 分析文件加载顺序和登录事件。
  • 配置 SavedVariables 或排查持久化问题。
  • 通过 C_AddOns API 查询或加载 AddOn。

如何使用此技能

  1. 先阅读 references/ADDON_STRUCTURE.md 中的布局和命名规则。
  2. 使用 references/TOC_FORMAT.md 编写 .toc 文件。
  3. 使用 references/LOADING_LIFECYCLE.md 规划初始化顺序。
  4. 使用 references/SAVED_VARIABLES.md 配置持久化。
  5. 使用 references/C_ADDONS_API.md 中的 C_AddOns 元数据 API。
  6. 参照 references/VIEWING_BLIZZARD_UI.md 中的 Blizzard UI 源码核对常见模式。

参考文件

  • references/ADDON_STRUCTURE.md - 文件夹布局规则、命名和常见模式。
  • references/TOC_FORMAT.md - .toc 语法、指令和文件顺序规则。
  • references/LOADING_LIFECYCLE.md - 加载顺序、事件和登录时间线。
  • references/SAVED_VARIABLES.md - 持久化规则和文件位置。
  • references/C_ADDONS_API.md - C_AddOns 的主要元数据和加载 API。
  • references/VIEWING_BLIZZARD_UI.md - 如何检查 Blizzard UI 源码。

关键规则和提醒

  • AddOn 文件夹名称必须与 .toc 文件名一致。
  • .toc 文件是必需的，它定义了文件加载顺序。
  • 文件按照 .toc 列表从上到下加载。
  • 除非使用 LoadSavedVariablesFirst，否则 SavedVariables 会在 ADDON_LOADED 后可用。
  • 对于较大的模块，请使用 LoadOnDemand 和 C_AddOns.LoadAddOn。
  • 某些 .toc 指令仅限 Blizzard AddOn 使用，第三方 AddOn 无法使用。

来源

评论

支持 Markdown