Godot main.gd | Gua 日本語リファレンス

中心となるオブジェクト

アダプター生成gdscript

const GuaAutoAdapterScript := preload(
  "res://addons/gua/gua_auto_adapter.gd"
)
var ui := GuaAutoAdapterScript.new()

uiがGodotのControlツリーとGuaランタイムの境界です。attachでルートを渡し、updateをフレームごとに呼びます。

名前	型 / 初期値	役割
`start_inspector_bridge_on_ready`	bool / true	Ready時にゲーム内WebSocketブリッジを始めるか。
`inspector_bridge_port`	int / 8765	InspectorとMCPが接続するポート。`GUA_BRIDGE_PORT`で上書き可能。
`ui`	GuaAutoAdapter	Control収集、要求のディスパッチ、スナップショット公開を担当。
`loading`	bool / false	現在の論理画面がtitleかloadingかを決める。
`title_label`	Label	タイトル画面の見出し。UI Treeではテキストノードになる。
`start_button`	Button	開始操作。`pressed`を`_show_loading`へ接続する。
`settings_button`	Button	複数ボタン収集を示す設定ボタン。
`loading_label`	Label	操作後に表示されるLoadingテキスト。
`visual_e2e`	bool	`GUA_VISUAL_E2E=1`で視覚テスト用Controlとキャプチャを有効化。
`v2_e2e`	bool	`GUA_V2_E2E=1`でProtocol v2フォームを追加。
`visual_e2e_update_elapsed`	float / 0.0	視覚E2E中の更新頻度を0.1秒単位に抑える。

関数	呼ばれる時点	Gua上の役割
`_ready()`	シーン準備完了	環境変数読取、UI構築、`ui.attach(self)`、初回update、ブリッジ開始。
`_process(delta)`	毎フレーム	`ui.update(_current_screen())`で最新Control状態を反映。
`_current_screen()`	update直前	`loading`を論理画面名`title`/`loading`へ変換。

関数	説明
`_build_ui()`	LabelとButtonを生成し、位置・サイズ・シグナルを設定する通常UI。
`_build_visual_e2e_controls()`	機密LineEdit、CheckBox、OptionButtonを追加し、視覚比較とredactionを試す。
`_build_v2_e2e_controls()`	TextEdit、選択、タブ、スクロール等のProtocol v2操作対象を追加。
`_show_loading()`	開始ボタン後の可視/無効状態を更新し、直ちにGuaへ同期。
`_capture_visual_e2e()`	描画フレームを待ってviewport PNGを明示的に公開。
`_start_inspector_bridge()`	指定ポートでゲーム内ブリッジを開始し、成功URLまたは警告を出力。