mcpField
W
wow-api-settings-system

wow-api-settings-system

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

wow-api-settings-system について

WoW Retailのアドオンやスクリプト開発者向けに、CVarとコンソールコマンドの使い方を説明します。読み取り・変更・リセット方法に加え、安全制限、適用範囲、設定ファイルの場所を扱います。

主な機能

  1. 01CVarの読み取り、確認、設定
  2. 02/consoleコマンドによる設定変更
  3. 03戦闘中のセキュア設定制限の確認
  4. 04アカウント単位とキャラクター単位の区別
  5. 05CVarのリセットと設定ファイルの確認

活用シーン

  1. 01アドオンでUIや音声設定を調整
  2. 02戦闘中にCVarを変更できるか確認
  3. 03設定を個別または一括で初期値に戻す
  4. 04ゲーム終了中に設定ファイルを確認

インストール

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

$npx skills add https://github.com/jburlison/wowaddonapiagents --skill wow-api-settings-system

インストール後、Claude Code で/wow-api-settings-systemを入力して読み込まれたか確認します。

同梱ファイルreferences/CVARS-OVERVIEW.md

詳細

WoW Settings System (CVars and Console)

WoW Retail のコンソール変数（CVar）やコンソールコマンドについて説明したり、操作したりする必要がある場合に、このスキルを使用します。

CVar とは

  • CVar は、グラフィック、サウンド、UI、ゲームプレイの動作に影響するクライアント設定値です。
  • ゲーム内の［インターフェース］オプションにある設定の多くは、CVar に直接対応しています。
  • 最新かつ信頼できる一覧は Wiki にあります。大量の一覧をコピーする代わりに、こちらを使用してください。

参照先：https://warcraft.wiki.gg/wiki/Console_variables

CVar の読み取りと設定

API（アドオンまたはスクリプト）
  • 読み取り：GetCVar(name) は文字列値を返します。
  • デフォルト値の読み取り：GetCVarDefault(name) はコードで定義されたデフォルト値を返します。
  • 確認：GetCVarInfo(name) で、CVar がセキュアかどうかを確認できます。
  • 書き込み：SetCVar(name, value) は値を文字列として設定します。

例：

-- Enable UI error popups
SetCVar("scriptErrors", 1)
/console コマンド
  • チャットで /console <name> <value> を使用します。
  • 例：
/console scriptErrors 1
コンソールウィンドウ
  • /console enable で有効にするか、クライアントを -console を付けて起動します。
  • ` または ~ キーでコンソールウィンドウを開きます。

セキュア CVar と戦闘中の制限

  • セキュア CVar は戦闘中に変更できません。
  • セキュア CVar は SetCVar を使用して変更する必要があります（/console は使用できません）。
  • 変更する前に GetCVarInfo を使用して、その CVar がセキュアかどうかを確認してください。

CVar の適用範囲（アカウントまたはキャラクター）

  • アカウント全体に適用される CVar もあれば、キャラクターごとに適用される CVar もあります。
  • キャラクター別またはアカウント別の値は、サーバーに同期される場合があります（synchronizeConfig が有効な場合）。
  • キャラクター別の CVar を変更しても、現在のキャラクターにのみ影響します。

CVar のリセット

  • 1 つの CVar をデフォルト値にリセットする場合：
SetCVar("autoSelfCast", GetCVarDefault("autoSelfCast"))
  • コンソールからリセットする場合：
/console cvar_default autoSelfCast
  • すべてリセットする場合：
/console cvar_default

注：同期されるアカウント別またはキャラクター別の CVar は、ゲームの再インストール後や WTF フォルダーの削除後も保持される場合があります。

設定ファイル（ゲームの実行中以外）

  • WTF/Config.wtf には、起動時および全体に適用される設定が保存されます。
  • WTF/Account/<AccountName>/config-cache.wtf とキャラクターごとの config-cache.wtf には、アカウント別またはキャラクター別の値が保存されます。
  • ゲームを終了してからファイルを編集してください。ゲームを起動したまま編集すると、変更が上書きされます。

CVar とコンソールコマンドを調べる

  • Wiki の一覧が、最も網羅的で検索しやすい情報源です。
  • コンソールコマンドの一覧も同じページにあります。
  • コンソール API の中には、コマンド一覧を取得できるものがあります（C_Console の API ドキュメントを参照してください）。

参照先：https://warcraft.wiki.gg/wiki/Console_variables

補足

ワークフローのヒント、注意点、リセット方法を厳選してまとめた内容については、references/CVARS-OVERVIEW.md を参照してください。

このスキルを使用する場面

  • アドオンまたはスクリプトから CVar を設定または読み取る方法を説明する必要がある場合。
  • CVar の適用範囲、セキュア設定の制限、リセット時の動作を明確にする必要がある場合。
  • コンソールコマンドの使い方や設定ファイルの場所について案内する必要がある場合。

コメント

Markdown 対応