Gua

What it does

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.checked 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.checked 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.checked 3 Oct 2026

Download

The site directs users to GitHub Releases for the Godot add-on and Windows Inspector.checked 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.checked 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.checked 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.checked 3 Oct 2026

License

The official documentation links to an MIT License.checked 4 Oct 2026

Product

Gua is a game testing and automation protocol for Godot and Unity built around Playwright-like design principles.checked 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.checked 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.checked 4 Oct 2026

Secret handling

Sensitive values can be redacted from snapshots, logs, diagnostics, and recordings, then resolved in memory during replay.checked 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.checked 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.checked 3 Oct 2026

Support

The site directs users with questions to its support Discord server.checked 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.checked 4 Oct 2026

Testing

Its .NET testing support includes NUnit, xUnit, MSTest, and C++ helpers, with state-based waits intended to avoid fixed sleeps.checked 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.checked 3 Oct 2026

Use cases

Gua supports AI-assisted game development and verification, as well as AI agents playing release builds with approved information and operations.checked 3 Oct 2026

Visual testing

Gua.Testing.Visual compares rendered PNG screenshots with baselines and supports pixel thresholds, masks, and OS or renderer variants.checked 4 Oct 2026

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.checked 3 Oct 2026