Gua
gua.orizika.com
- Free plan
- Windows
- macOS
- Linux
- Web
- API
What Gua is
Gua is a free, open-source protocol for testing and automating games made with Godot and Unity. It exposes semantic UI details—including IDs, roles, text, hierarchy, visibility, values, focus, and selection—so tests and AI agents can inspect and operate controls. Tests can wait for interface states in NUnit, xUnit, MSTest, or C++ rather than relying on fixed pauses. Its visual testing module compares PNG screenshots against baselines with pixel thresholds, masks, and environment variants. Recording captures semantic actions, timing, revisions, and wait conditions for replay; failure artifacts can include UI differences, event history, logs, screenshots, runtime details, and game-process output. A native MCP server connects to a running game over WebSocket, while WebMCP exposes tools in Godot Web Export and Unity WebGL builds. The site documents a Godot 4.7 add-on and Unity 6 support for UI Toolkit, uGUI, and TextMeshPro. Player mode blocks screenshots by default, and WebMCP requires a browser with an experimental API. Unity desktop support excludes IL2CPP, IMGUI, and EditorWindow automation.
Who it suits
Gua suits game developers and QA teams using Godot or Unity who need automated interface checks or AI-assisted game verification. Its semantic controls and replay features may also help teams building AI agents for release builds.
Good to know, and what to watch
- Free and open source under an MIT License.
- Tests can wait for UI states without fixed sleeps.
- Visual checks support thresholds, masks, and environment variants.
- Failure artifacts can include UI, logs, and screenshots.
- Offers native MCP and WebMCP integrations.
- Player mode blocks screenshots by default.
- WebMCP requires an experimental browser API.
- Unity support excludes IL2CPP, IMGUI, and EditorWindow automation.
- Stable Unity desktop scope is limited to Unity 6000.5+ Mono.
The verdict
Gua combines semantic game UI automation with visual checks, recording, and diagnostic artifacts for Godot and Unity projects. Check its Unity restrictions and screenshot controls against your workflow before adopting it.
What the maker publishes
- 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. source
- 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. source
- Diagnostics
- Failure artifacts can include the UI tree and diff, pending requests, event history, logs, runtime version, environment, screenshot, and game-process output. source
- Download
- The site directs users to GitHub Releases for the Godot add-on and Windows Inspector. source
- 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. source
- Game engine support
- The site documents a Godot 4.7 add-on and Unity 6 support for UI Toolkit, uGUI, and TextMeshPro. source
- 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. source
- License
- The official documentation links to an MIT License. source
- Product
- Gua is a game testing and automation protocol for Godot and Unity built around Playwright-like design principles. source
- Product
- Gua is a game testing and automation protocol for Godot and Unity built around Playwright-like design principles. source
- Recording
- Gua.Testing.Recording records semantic actions, timing, revisions, and wait conditions for replay with host completion checks. source
- Recording
- Gua.Testing.Recording records semantic actions and wait conditions for replay, with sensitive values stored as secret keys rather than plaintext. source
- 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. source
- Secret handling
- Sensitive values are redacted from snapshots, logs, diagnostics, and recordings, and are resolved in memory only during replay. source
- Secret handling
- Sensitive values can be redacted from snapshots, logs, diagnostics, and recordings, then resolved in memory during replay. source
- Security controls
- The Player profile can hide UI and world subtrees, reduce fields, restrict UI operations, and keep debug logs out of the AI-facing view. source
- 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. source
- 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. source
- Support
- The Gua site directs questions to its support Discord server. source
- Support
- The site directs users with questions to its support Discord server. source
- 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. source
- Testing
- Tests can wait for UI state in NUnit, xUnit, MSTest, or C++ without fixed sleeps. source
- Testing
- Its .NET testing support includes NUnit, xUnit, MSTest, and C++ helpers, with state-based waits intended to avoid fixed sleeps. source
- 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. source
Checked against the maker's pages on 4 Oct 2026.