Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Gua

gua.orizika.com

  • Free plan
  • Windows
  • macOS
  • Linux
  • Web
  • API
8.0 Club score Visit gua.orizika.com

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.