01 Install and implement UI →
Add the UPM package and understand automatic startup, IDs, screens, and supported controls.
02 Testing UI →Start Editor Play Mode or a Windows Player from an external .NET test.
Architecture
Unity runtime UI→Gua.Unity→Gua.Runtime→WebSocket→Tests / Inspector / MCP
com.link1345.gua starts automatically in Play Mode and Windows Players. It rebuilds semantic state from the real UI hierarchy every frame and applies external actions through Unity controls. Game code does not maintain a second test-only UI model.
Unity and Godot
| Concern | Unity | Godot |
|---|---|---|
| Game adapter | Managed UPM package | GDScript + GDExtension |
| Automatic reflection | UI Toolkit / uGUI / TMP | Control tree |
| External host | Gua.Testing.Unity | Gua.Testing.Godot |
| Shared contract | Gua Core, Semantic UI Tree v2, action results, reset, diagnostics, screenshots, and WebSocket | |
See the Unity API and specification for the public surface, mappings, actions, and supported environment.