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

Semantic locatorによるGodot UIテスト

GuaはGodot 4.7の実行中ゲームへPlaywrightスタイルのUI自動化を提供します。標準Controlをrole、text、ID、状態から検索し、座標や画像認識に頼らず操作・検証できます。

推奨構成

GDScript + GDExtension

native/gua-godotgua_auto_adapter.gdで標準Controlを幅広く収集します。.NET有効プロジェクトでも、このアドオンをC#ゲームコードと併用するのが推奨です。

C#アドオンは実験的

examples/dotnet-godotは基本的なtree、screenshot、button clickを試すサンプルで、GDScriptアドオンと同等機能ではありません。

接続の全体像

Control treeGua adapterws://127.0.0.1:8765Test / Inspector / MCP

Godot開発でできること

Semantic UI・E2Eテスト

ID、role、text、value、状態からControlを検索し、操作後の変化を通常の.NETテストで待機・検証します。

Screenshot・Visual regression

描画付き実行からPNGを取得し、baselineとの差分と失敗artifactをCIへ残します。

Inspectorによる調査

実行中のUI Tree、状態、ログ、スクリーンショットを人間が確認し、Semantic actionを試せます。

AI playtesting

MCP対応AIコーディングエージェントが実行中ゲームを観測・操作・検証できます。AI向けの開発ループを見る →