Gua review
A focused open-source choice for semantic UI and visual regression testing.
Reviewed by iTechGuides Editors · Editorial team · Updated Oct 2026
Gua is an open-source game testing and automation protocol for Godot and Unity. It is aimed at game developers and QA teams that need end-to-end UI testing, semantic control discovery, screenshot capture, visual regression comparison, and selected gameplay input. Tests can work with UI trees rather than screen coordinates, using roles, text, IDs, and state. The project targets Godot 4.7 and Unity 6 on desktop platforms, with Windows, macOS, and Linux listed among its platforms.
Its strongest area is the testing workflow around visual and semantic state. Gua supports state-based waits, semantic action recording and replay, PNG baselines and diffs, virtual time, and bounded gameplay input. Failure diagnostics add logs, screenshots, and runtime metadata, giving teams several artifacts to inspect when a test fails. The World Object Tree can expose selected game-world information, while MCP and browser-native WebMCP connectivity extend how tests, inspectors, and AI agents can interact with the project.
Gua fits teams that want open-source tooling and can work within its engine and platform boundaries. It integrates with MCP, WebMCP, GitHub Actions, NUnit, xUnit, and MSTest, which supports CI-oriented workflows and established test frameworks. The project is MIT-licensed rather than organized around commercial plans, and support is documentation-only. Unity support is documented for desktop Mono workflows, while iOS and Android are not supported targets. Choose Gua for semantic game UI automation and visual regression in Godot or Unity; consider another tool if broader engine coverage, mobile targets, or direct support are priorities.
Gua pros and cons
- Where it wins
- Semantic selectors locate controls by role, text, ID, and state
- PNG visual regression testing includes baselines and diffs
- Diagnostics combine logs, screenshots, and runtime metadata
- Where it doesn't
- Verified support is limited to Godot and Unity
- Desktop workflows exclude iOS and Android targets
- Support is documentation-only
Gua fact sheet, pricing and score →
Advertiser disclosure: iTechGuides is reader-supported. Vendors can pay for top positions in our rankings and for a place on other products' pages, and we may earn a commission when you click some links. Bought places stand at the number bought; this page and our disclosure say so. Paying vendors may get a fuller, more detailed review from our editors, and that review can change their score. How we rank.
Last updated · How we research and update