用途:该技能是《魔兽世界》正式服(Retail,截至 Patch 12.0.0)插件的结构指南,聚焦文件夹布局、.toc 元数据、加载顺序与 SavedVariables,并避免已弃用或移除的 API,指出受限指令。
主要能力:设计或审查插件文件夹布局;编写或审计 .toc 文件;推理文件加载顺序与登录事件;接入 SavedVariables 或排查持久化问题;通过 C_AddOns API 查询或加载插件。
使用方式:先阅读 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 对照暴雪 UI 源码模式。
关键规则:插件文件夹名与 .toc 文件名必须一致;.toc 必需并定义文件加载顺序,文件按列表自上而下加载;SavedVariables 在 ADDON_LOADED 之后可用,除非使用 LoadSavedVariablesFirst;对重型模块使用 LoadOnDemand 与 C_AddOns.LoadAddOn;部分 .toc 指令仅限暴雪插件,第三方插件不可用。
适用场景:插件目录规划、.toc 编写与审计、加载与登录时序分析、持久化调试。
限制:仅适用于正式服,资料未提供其他版本支持、安装命令或收费信息。