GGua 日本語リファレンスEnglishGitHub ↗
英語版が正式な参照です。内容に差異がある場合は、英語版を優先してください。
TOOL / INSPECTOR

インスペクタ編

実行中ゲームのSemantic UI Tree、ノード状態、ログ、スクリーンショットを人間の目で確認します。導入時の最初の診断道具です。

起動と接続

  1. Guaリポジトリで依存関係を入れる
    PowerShellpowershell
    bun install --frozen-lockfile
  2. ブラウザー版Inspectorを起動
    ターミナル 1powershell
    bun run --filter @gua/inspector dev
  3. ゲーム側ブリッジを起動

    Godotサンプルはゲームプロセス内でブリッジを開始します。プロトコルだけ試す場合はサンプルブリッジも使えます。

    ターミナル 2(サンプルブリッジ)powershell
    bun run bridge:ws
  4. URLを入力して接続
    texttext
    ws://127.0.0.1:8765

画面で見るもの

Semantic UI Tree

screen、role、id、textと親子関係。期待したControlやウィジェットが収集されたかを見る。

Node state

visible、enabled、focused、checked、value、boundsなど、テスト判断に使う状態。

Logs

ゲーム側が公開した時系列ログ。ブリッジ接続だけでは分からない状態変化を追う。

Screenshot

明示的に公開されたPNG。Semantic情報と実画面を照合する補助証拠。

デスクトップ版

Tauriシェルで起動する場合はRustツールチェーンが必要です。

PowerShellpowershell
bun run --filter @gua/inspector build
bun run --filter @gua/inspector tauri:dev