GGua REFERENCE日本語GitHub ↗
GODOT / UI TESTING

Godot UI Testing with Semantic Locators

Gua brings Playwright-style UI automation to running Godot 4.7 games. Find standard Controls by role, text, ID, and state, then operate and verify them without coordinates or image recognition.

Recommended configuration

GDScript + GDExtension

native/gua-godot and gua_auto_adapter.gd observe a broad set of Controls. This addon is recommended even when the Godot project also uses C#.

The C# addon is experimental

examples/dotnet-godot demonstrates basic tree reflection, screenshots, and button clicks. It is not feature-equivalent to the GDScript addon.

Connection model

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

What you can test in Godot

Semantic UI and end-to-end tests

Find Controls by ID, role, text, value, and state, then wait for and assert the result in ordinary .NET tests.

Screenshot and visual regression

Capture PNGs from rendered runs and retain baseline diffs and diagnostic artifacts in CI.

Inspector-led debugging

Let a human inspect the live tree, state, logs, and screenshot and try semantic actions interactively.

AI playtesting

Let an MCP-enabled AI coding agent inspect, operate, and verify the running game. See the AI development loop →