mcpField
W
wow-addon-structure

wow-addon-structure

github.com/jburlison開発4677 回インストール37 週間前に更新
リポジトリ

wow-addon-structure について

World of Warcraft Retail の AddOn 開発者向けリファレンススキルです。Patch 12.0.0 を対象に、フォルダー構成、.toc ファイル、読み込み順、SavedVariables と、サードパーティ製 AddOn で制限される指令や API を扱います。

主な機能

  1. 01AddOn のフォルダー構成と命名
  2. 02.toc のメタデータとファイル順
  3. 03読み込みライフサイクルとログインイベント
  4. 04SavedVariables による永続化
  5. 05C_AddOns のメタデータ・読み込み API
  6. 06Blizzard UI ソースの確認

活用シーン

  1. 01AddOn のフォルダー構成の設計・レビュー
  2. 02.toc ファイルの作成・監査
  3. 03初期化順とログインイベントの計画
  4. 04SavedVariables の永続化問題の調査

インストール

コマンドをコピーしてターミナルで実行します。

$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 アドオンの構造（Retail）

対象範囲

  • Retail のみを対象とし、Patch 12.0.0 時点の情報です。
  • フォルダー構成、.toc メタデータ、読み込み順序、SavedVariables に焦点を当てます。
  • 非推奨または削除された API は避け、制限付きディレクティブについて明記します。

このスキルを使う場面

次の作業が必要な場合に、このスキルを使います。

  • アドオンのフォルダー構成を設計またはレビューする。
  • .toc ファイルを作成または監査する。
  • ファイルの読み込み順序やログインイベントについて確認する。
  • SavedVariables を設定する、または永続化の問題をトラブルシューティングする。
  • C_AddOns API を使ってアドオンを照会または読み込む。

このスキルの使い方

  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 と読み込み API。
  • references/VIEWING_BLIZZARD_UI.md - Blizzard UI のソースを調べる方法。

主なルールと注意事項

  • アドオンのフォルダー名と .toc ファイル名は一致させる必要があります。
  • .toc ファイルは必須で、ファイルの読み込み順序を定義します。
  • ファイルは .toc のリストに記載された順に上から読み込まれます。
  • LoadSavedVariablesFirst を使用しない限り、SavedVariables は ADDON_LOADED の後に利用可能になります。
  • 大きなモジュールには LoadOnDemand と C_AddOns.LoadAddOn を使用します。
  • 一部の .toc ディレクティブは Blizzard のアドオンに限定されており、サードパーティ製アドオンでは利用できません。

出典

コメント

Markdown 対応