Skip to content
SPECIFICTION
Get listed

Gua

gua.orizika.com

WebWindowsmacOSLinuxAPI
Visit gua.orizika.com
Spec score 7.5 #12 of 18 in Game Testing Software

What it is

Gua is a free, open-source protocol for testing and automating games made with Godot and Unity. It exposes semantic interface state, including identifiers, 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 interface conditions in NUnit, xUnit, MSTest, or C++ without fixed sleeps. Visual testing compares PNG screenshots with baselines using pixel thresholds, difference ratios, masks, and operating-system or renderer variants. Recording stores semantic actions, timing, revisions, and wait conditions for replay with host checks. Failure artifacts may include UI trees and diffs, pending requests, event history, logs, runtime and environment details, screenshots, and game output. Native MCP connects over WebSocket; WebMCP exposes tools in Godot Web Export and Unity WebGL. Gua documents a Godot 4.7 add-on and Unity 6 support. It targets Windows, Linux, macOS, API, and web environments.

Spec sheet

Product
Gua is a game testing and automation protocol for Godot and Unity built around Playwright-like design principles.Read 4 Oct 2026 · gua.orizika.com
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.Read 3 Oct 2026 · gua.orizika.com
Support
The site directs users with questions to its support Discord server.Read 4 Oct 2026 · gua.orizika.com
License
The official documentation links to an MIT License.Read 4 Oct 2026 · gua.orizika.com
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.Read 4 Oct 2026 · gua.orizika.com
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.Read 4 Oct 2026 · gua.orizika.com
Diagnostics
Failure artifacts can include the UI tree and diff, pending requests, event history, logs, runtime version, environment, screenshot, and game-process output.Read 3 Oct 2026 · gua.orizika.com
Download
The site directs users to GitHub Releases for the Godot add-on and Windows Inspector.Read 4 Oct 2026 · gua.orizika.com
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.Read 3 Oct 2026 · gua.orizika.com
Game engine support
The site documents a Godot 4.7 add-on and Unity 6 support for UI Toolkit, uGUI, and TextMeshPro.Read 4 Oct 2026 · gua.orizika.com
Recording
Gua.Testing.Recording records semantic actions and wait conditions for replay, with sensitive values stored as secret keys rather than plaintext.Read 4 Oct 2026 · gua.orizika.com
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.Read 4 Oct 2026 · gua.orizika.com
Secret handling
Sensitive values can be redacted from snapshots, logs, diagnostics, and recordings, then resolved in memory during replay.Read 4 Oct 2026 · gua.orizika.com
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.Read 4 Oct 2026 · gua.orizika.com
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.Read 3 Oct 2026 · gua.orizika.com
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.Read 4 Oct 2026 · gua.orizika.com
Testing
Its .NET testing support includes NUnit, xUnit, MSTest, and C++ helpers, with state-based waits intended to avoid fixed sleeps.Read 4 Oct 2026 · gua.orizika.com
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.Read 3 Oct 2026 · gua.orizika.com
Use cases
Gua supports AI-assisted game development and verification, as well as AI agents playing release builds with approved information and operations.Read 3 Oct 2026 · gua.orizika.com
Visual testing
Gua.Testing.Visual compares rendered PNG screenshots with baselines and supports pixel thresholds, masks, and OS or renderer variants.Read 4 Oct 2026 · gua.orizika.com
WebMCP limitation
WebMCP requires a browser implementing the experimental document.modelContext API, and the released Godot and Unity built-in ports do not currently advertise screenshot support.Read 3 Oct 2026 · gua.orizika.com

Strong points and limits

Strong points

  • Free and open source
  • Semantic UI state and control actions
  • Visual screenshot comparison with masks
  • Replayable semantic action recordings
  • Native MCP and WebMCP integrations

Limits

  • WebMCP needs an experimental browser API
  • Screenshots denied by default in Player mode
  • Unity excludes IL2CPP, IMGUI, and EditorWindow automation
  • Unity desktop scope is limited to documented versions and systems

Who it suits

Gua suits game developers and QA teams working with Godot or Unity who need semantic automation, visual checks, or AI-assisted verification. It also suits teams connecting AI tools to running games through MCP.

Verdict

Gua combines semantic game automation, visual comparison, recordings, diagnostics, and AI connections in one protocol. Check its browser, screenshot, and Unity scope limits before adopting it.

Where Specifiction places it

Alternatives to GuaAll alternatives →