Gua
What it is
Gua is a free, open-source protocol for testing and automating games built with Godot and Unity. It exposes semantic interface state—including IDs, roles, text, hierarchy, bounds, visibility, enabled state, values, focus and selection—so tests and AI agents can query controls and perform actions such as clicking, focusing, setting values, selecting, scrolling and pressing keys. Tests can wait for UI conditions in NUnit, xUnit, MSTest or C++ without fixed sleeps. Visual testing compares PNG screenshots with baselines using thresholds, masks and operating-system or renderer variants. Recording preserves semantic actions, timing, revisions and wait conditions for replay, while diagnostics can include UI trees, diffs, requests, events, logs, screenshots and environment details. Native MCP connects over WebSocket; WebMCP exposes tools in Godot Web Export and Unity WebGL. Documentation covers a Godot 4.7 add-on and Unity 6. The project links to an MIT License.
For and against
For
- Provides semantic game UI automation
- Supports multiple test frameworks
- Includes visual baseline comparisons
- Captures replayable action recordings
- Offers native and WebMCP integrations
Against
- Player mode denies screenshots by default
- WebMCP needs an experimental browser API
- Unity IL2CPP is unsupported
- Unity IMGUI and EditorWindow automation are unsupported
The verdict
Gua offers semantic, visual and recorded testing for Godot and Unity, plus controlled AI-agent connections. Check screenshot, browser-API and Unity desktop limitations against your test setup.
Who it suits
It suits teams testing Godot or Unity games, including AI-assisted development and release-build agents. It targets Windows, Linux and macOS workflows.
On the record
- AI integrations
- The native MCP server connects AI tools to a running game over WebSocket, while WebMCP exposes tools in Godot Web and Unity WebGL browser builds.gua.orizika.com · read 4 Oct 2026
- Core automation
- Gua exposes semantic UI state and lets tests operate controls through actions such as click, focus, set value, select, scroll, and press key.gua.orizika.com · read 4 Oct 2026
- Diagnostics
- Failure artifacts can include the UI tree and diff, pending requests, event history, logs, runtime version, environment, screenshot, and game-process output.gua.orizika.com · read 3 Oct 2026
- Download
- The site directs users to GitHub Releases for the Godot add-on and Windows Inspector.gua.orizika.com · read 4 Oct 2026
- Engines
- The site describes a recommended GDScript add-on for Godot 4.7 and a Unity package for Unity 6 that reflects UI Toolkit, uGUI, and TextMeshPro.gua.orizika.com · read 3 Oct 2026
- Game engine support
- The site documents a Godot 4.7 add-on and Unity 6 support for UI Toolkit, uGUI, and TextMeshPro.gua.orizika.com · read 4 Oct 2026
- Integrations
- The native MCP server connects to a running game over WebSocket, while WebMCP registers semantic tools in a Godot Web Export or Unity WebGL browser tab.gua.orizika.com · read 3 Oct 2026
- License
- The official documentation links to an MIT License.gua.orizika.com · read 4 Oct 2026
- Product
- Gua is a game testing and automation protocol for Godot and Unity built around Playwright-like design principles.gua.orizika.com · read 4 Oct 2026
- Recording
- Gua.Testing.Recording records semantic actions and wait conditions for replay, with sensitive values stored as secret keys rather than plaintext.gua.orizika.com · read 4 Oct 2026
- Screenshot restriction
- Player mode denies screenshots by default because semantic rules cannot redact rendered pixels; the game host may opt in before starting the bridge.gua.orizika.com · read 4 Oct 2026
- Secret handling
- Sensitive values can be redacted from snapshots, logs, diagnostics, and recordings, then resolved in memory during replay.gua.orizika.com · read 4 Oct 2026
- Security controls
- An AI player policy can hide UI or world objects, omit or redact fields, replace or quantize values, and restrict allowed UI actions.gua.orizika.com · read 4 Oct 2026
- Semantic UI automation
- It exposes UI state such as IDs, roles, text, hierarchy, bounds, visibility, enabled state, values, focus, and selection for semantic queries and actions.gua.orizika.com · read 3 Oct 2026
- Support
- The site directs users with questions to its support Discord server.gua.orizika.com · read 4 Oct 2026
- Supported desktop scope
- Unity stable desktop support covers Windows x64, Linux x64, Intel macOS, and Apple Silicon macOS; IL2CPP, Unity IMGUI, and EditorWindow automation are unsupported.gua.orizika.com · read 4 Oct 2026
- Testing
- Its .NET testing support includes NUnit, xUnit, MSTest, and C++ helpers, with state-based waits intended to avoid fixed sleeps.gua.orizika.com · read 4 Oct 2026
- Unity limits
- The documented stable Unity desktop scope is Unity 6000.5+ Mono on Windows, Linux, and Intel or Apple Silicon macOS; IL2CPP, IMGUI, and EditorWindow automation are unsupported.gua.orizika.com · read 3 Oct 2026
