feat(ai): add Unity gameplay authoring and MCP workflows

README.md

@@ -35,12 +35,16 @@ Exposes project-grade tools to AI agents while defining capability contracts and
 Initial tool families:
 
 - `unity.project.*` — inspect project structure, packages, settings, scenes, scripts, and assets.
+- `unity.audit.*` — generate hashed JSON/Markdown reports from persisted events and before/after evidence.
 - `unity.assets.*` — list project assets with GUIDs, paths, and main asset types.
+- `unity.assets.import` — copy or download FBX/OBJ/DAE/3DS/DXF and package-backed glTF models, textures, and audio; verify hashes; configure importers; instantiate models; and save prefabs.
+- `unity.assets.catalog.search` / `unity.assets.import_from_catalog` — search CC0-by-default asset catalogs and import entries with enforced license, provenance, byte size, and SHA-256 metadata.
 - `unity.asset.*` — inspect specific asset metadata and dependencies.
 - `unity.prefabs.*` / `unity.prefab.*` — list and inspect prefab assets.
 - `unity.scene.*` — inspect hierarchies and serialized component state, then create, duplicate, rename, reparent, delete, instantiate prefabs, add/remove components, and set serialized properties through atomic batches.
+- `unity.gameplay.*` — turn existing objects into checkpointed doors, pickups, and multi-target proximity activators through high-level templates.
 - `unity.scenes.*` — list scenes discovered in the project and Build Settings.
-- `unity.scripts.*` / `unity.assemblies.*` — inspect C# scripts and Unity script assemblies.
+- `unity.scripts.*` / `unity.assemblies.*` — inspect C# scripts and assemblies, or author hash-confirmed runtime `MonoBehaviour` components with compile verification and rollback.
 - `unity.packages.*` — list and change registry packages through reload-safe jobs.
 - `unity.jobs.*` — inspect and cancel persistent long-running operations.
 - `unity.playmode.*` / `unity.compilation.*` — control Play Mode and wait for compilation/import plus console verification.
@@ -50,7 +54,7 @@ Initial tool families:
 - `unity.meta_xr.*` — validate and configure Meta XR SDK, OpenXR, rigs, hands, passthrough, anchors, interactions, and Quest build requirements.
 - `unity.tests.*` — run Edit Mode/Play Mode tests and summarize failures.
 - `unity.build.*` — validate and execute builds, especially Android/Quest targets.
-- `unity.assets.author` — create or edit shaders, materials, animation clips, generated WAV audio, and audio import settings.
+- `unity.assets.author` — create or edit shaders, materials, animation clips, Animator Controllers, generated WAV audio, and audio import settings.
 - `unity.prefab.manage` — save prefab assets, create variants, edit prefab contents, and apply/revert overrides.
 
 ### Unity Editor plugin
@@ -155,7 +159,7 @@ npm run setup:user -- --unity-project /path/to/UnityProject --opencode --claude-
 Apply the changes:
 
 ```bash
-npm run setup:user -- --unity-project /path/to/UnityProject --opencode --claude-code --codex --build --write
+npm run setup:user -- --unity-project /path/to/UnityProject --opencode --claude-code --codex --antigravity --build --write
 ```
 
 What it changes:
@@ -164,10 +168,11 @@ What it changes:
 - Adds or updates `mcp.unity-ai` in `~/.config/opencode/opencode.json` using an absolute path to `apps/mcp-server/dist/index.js`.
 - Configures Claude Code through `claude mcp add-json unity-ai ...`; the script does not edit Claude Code config files directly.
 - Adds or updates a generated `unity-ai` MCP server block in `~/.codex/config.toml`.
+- Adds or updates `unity-ai` in Antigravity, Antigravity CLI, and Antigravity IDE MCP configs.
 - Creates `.bak-YYYYMMDDHHmmss` backups next to files before writing.
 - Generates and prints a local bridge token when applying with `--write` and an MCP host without `--bridge-token`; use that same token when starting the Unity local bridge.
 
-After changing opencode or Codex config, restart the host so it reloads config. Claude Code is configured through its CLI.
+After changing opencode, Codex, or Antigravity config, restart the host so it reloads config. Claude Code is configured through its CLI.
 
 See `docs/setup.md` for focused setup details and examples.
 
@@ -185,7 +190,12 @@ Useful commands:
 npm ci
 npm run typecheck
 npm run build
+npm run schemas:check
+npm run verify:asset-catalog
+npm run verify:bridge-retry
 npm run verify:unity-package
 ```
 
 `npm run verify:unity-package` expects a local Unity installation. Set `UNITY_PATH` or pass the Unity executable path as the first argument if Unity is not discoverable in the default location.
+
+Run `npm run schemas:antigravity` after adding or changing MCP tools to refresh Antigravity, Antigravity CLI, and Antigravity IDE local `parameters` JSON instead of leaving stale `parameters: null` entries.

apps/mcp-server/catalog-assets/starter-character.obj

@@ -0,0 +1,91 @@
+# Unity AI Starter Catalog - CC0 1.0
+o StarterCharacterBody
+v -0.3 0.8 -0.18
+v 0.3 0.8 -0.18
+v 0.3 1.55 -0.18
+v -0.3 1.55 -0.18
+v -0.3 0.8 0.18
+v 0.3 0.8 0.18
+v 0.3 1.55 0.18
+v -0.3 1.55 0.18
+f 1 2 3 4
+f 5 8 7 6
+f 1 5 6 2
+f 2 6 7 3
+f 3 7 8 4
+f 5 1 4 8
+o StarterCharacterHead
+v -0.22 1.58 -0.22
+v 0.22 1.58 -0.22
+v 0.22 2.02 -0.22
+v -0.22 2.02 -0.22
+v -0.22 1.58 0.22
+v 0.22 1.58 0.22
+v 0.22 2.02 0.22
+v -0.22 2.02 0.22
+f 9 10 11 12
+f 13 16 15 14
+f 9 13 14 10
+f 10 14 15 11
+f 11 15 16 12
+f 13 9 12 16
+o StarterCharacterArmL
+v -0.62 0.85 -0.12
+v -0.36 0.85 -0.12
+v -0.36 1.45 -0.12
+v -0.62 1.45 -0.12
+v -0.62 0.85 0.12
+v -0.36 0.85 0.12
+v -0.36 1.45 0.12
+v -0.62 1.45 0.12
+f 17 18 19 20
+f 21 24 23 22
+f 17 21 22 18
+f 18 22 23 19
+f 19 23 24 20
+f 21 17 20 24
+o StarterCharacterArmR
+v 0.36 0.85 -0.12
+v 0.62 0.85 -0.12
+v 0.62 1.45 -0.12
+v 0.36 1.45 -0.12
+v 0.36 0.85 0.12
+v 0.62 0.85 0.12
+v 0.62 1.45 0.12
+v 0.36 1.45 0.12
+f 25 26 27 28
+f 29 32 31 30
+f 25 29 30 26
+f 26 30 31 27
+f 27 31 32 28
+f 29 25 28 32
+o StarterCharacterLegL
+v -0.28 0.0 -0.13
+v -0.04 0.0 -0.13
+v -0.04 0.8 -0.13
+v -0.28 0.8 -0.13
+v -0.28 0.0 0.13
+v -0.04 0.0 0.13
+v -0.04 0.8 0.13
+v -0.28 0.8 0.13
+f 33 34 35 36
+f 37 40 39 38
+f 33 37 38 34
+f 34 38 39 35
+f 35 39 40 36
+f 37 33 36 40
+o StarterCharacterLegR
+v 0.04 0.0 -0.13
+v 0.28 0.0 -0.13
+v 0.28 0.8 -0.13
+v 0.04 0.8 -0.13
+v 0.04 0.0 0.13
+v 0.28 0.0 0.13
+v 0.28 0.8 0.13
+v 0.04 0.8 0.13
+f 41 42 43 44
+f 45 48 47 46
+f 41 45 46 42
+f 42 46 47 43
+f 43 47 48 44
+f 45 41 44 48

apps/mcp-server/catalog-assets/starter-crate.obj

@@ -0,0 +1,16 @@
+# Unity AI Starter Catalog - CC0 1.0
+o StarterCrate
+v -0.5 0.0 -0.5
+v 0.5 0.0 -0.5
+v 0.5 1.0 -0.5
+v -0.5 1.0 -0.5
+v -0.5 0.0 0.5
+v 0.5 0.0 0.5
+v 0.5 1.0 0.5
+v -0.5 1.0 0.5
+f 1 2 3 4
+f 5 8 7 6
+f 1 5 6 2
+f 2 6 7 3
+f 3 7 8 4
+f 5 1 4 8

apps/mcp-server/catalog-assets/starter-platform.obj

@@ -0,0 +1,31 @@
+# Unity AI Starter Catalog - CC0 1.0
+o StarterPlatform
+v -2.0 0.0 -2.0
+v 2.0 0.0 -2.0
+v 2.0 0.2 -2.0
+v -2.0 0.2 -2.0
+v -2.0 0.0 2.0
+v 2.0 0.0 2.0
+v 2.0 0.2 2.0
+v -2.0 0.2 2.0
+f 1 2 3 4
+f 5 8 7 6
+f 1 5 6 2
+f 2 6 7 3
+f 3 7 8 4
+f 5 1 4 8
+o StarterPlatformMarker
+v -0.2 0.21 -0.2
+v 0.2 0.21 -0.2
+v 0.2 0.24 -0.2
+v -0.2 0.24 -0.2
+v -0.2 0.21 0.2
+v 0.2 0.21 0.2
+v 0.2 0.24 0.2
+v -0.2 0.24 0.2
+f 9 10 11 12
+f 13 16 15 14
+f 9 13 14 10
+f 10 14 15 11
+f 11 15 16 12
+f 13 9 12 16

apps/mcp-server/catalog-assets/starter-ramp.obj

@@ -0,0 +1,13 @@
+# Unity AI Starter Catalog - CC0 1.0
+o StarterRamp
+v -1.0 0.0 -1.0
+v 1.0 0.0 -1.0
+v -1.0 0.0 1.0
+v 1.0 0.0 1.0
+v -1.0 1.0 1.0
+v 1.0 1.0 1.0
+f 1 2 4 3
+f 3 4 6 5
+f 1 3 5
+f 2 6 4
+f 1 5 6 2

apps/mcp-server/catalog-assets/starter-tree.obj

@@ -0,0 +1,27 @@
+# Unity AI Starter Catalog - CC0 1.0
+o StarterTreeTrunk
+v -0.15 0.0 -0.15
+v 0.15 0.0 -0.15
+v 0.15 1.0 -0.15
+v -0.15 1.0 -0.15
+v -0.15 0.0 0.15
+v 0.15 0.0 0.15
+v 0.15 1.0 0.15
+v -0.15 1.0 0.15
+f 1 2 3 4
+f 5 8 7 6
+f 1 5 6 2
+f 2 6 7 3
+f 3 7 8 4
+f 5 1 4 8
+o StarterTreeCanopy
+v 0.0 2.0 0.0
+v -0.75 0.95 -0.75
+v 0.75 0.95 -0.75
+v 0.75 0.95 0.75
+v -0.75 0.95 0.75
+f 10 11 12 13
+f 9 10 11
+f 9 11 12
+f 9 12 13
+f 9 13 10

apps/mcp-server/catalog-assets/starter-vehicle.obj

@@ -0,0 +1,91 @@
+# Unity AI Starter Catalog - CC0 1.0
+o StarterVehicleBody
+v -1.2 0.35 -0.7
+v 1.2 0.35 -0.7
+v 1.2 0.75 -0.7
+v -1.2 0.75 -0.7
+v -1.2 0.35 0.7
+v 1.2 0.35 0.7
+v 1.2 0.75 0.7
+v -1.2 0.75 0.7
+f 1 2 3 4
+f 5 8 7 6
+f 1 5 6 2
+f 2 6 7 3
+f 3 7 8 4
+f 5 1 4 8
+o StarterVehicleCabin
+v -0.45 0.75 -0.35
+v 0.45 0.75 -0.35
+v 0.45 1.25 -0.35
+v -0.45 1.25 -0.35
+v -0.45 0.75 0.45
+v 0.45 0.75 0.45
+v 0.45 1.25 0.45
+v -0.45 1.25 0.45
+f 9 10 11 12
+f 13 16 15 14
+f 9 13 14 10
+f 10 14 15 11
+f 11 15 16 12
+f 13 9 12 16
+o StarterVehicleWheelFL
+v -0.9 0.05 -0.85
+v -0.45 0.05 -0.85
+v -0.45 0.5 -0.85
+v -0.9 0.5 -0.85
+v -0.9 0.05 -0.65
+v -0.45 0.05 -0.65
+v -0.45 0.5 -0.65
+v -0.9 0.5 -0.65
+f 17 18 19 20
+f 21 24 23 22
+f 17 21 22 18
+f 18 22 23 19
+f 19 23 24 20
+f 21 17 20 24
+o StarterVehicleWheelFR
+v 0.45 0.05 -0.85
+v 0.9 0.05 -0.85
+v 0.9 0.5 -0.85
+v 0.45 0.5 -0.85
+v 0.45 0.05 -0.65
+v 0.9 0.05 -0.65
+v 0.9 0.5 -0.65
+v 0.45 0.5 -0.65
+f 25 26 27 28
+f 29 32 31 30
+f 25 29 30 26
+f 26 30 31 27
+f 27 31 32 28
+f 29 25 28 32
+o StarterVehicleWheelBL
+v -0.9 0.05 0.65
+v -0.45 0.05 0.65
+v -0.45 0.5 0.65
+v -0.9 0.5 0.65
+v -0.9 0.05 0.85
+v -0.45 0.05 0.85
+v -0.45 0.5 0.85
+v -0.9 0.5 0.85
+f 33 34 35 36
+f 37 40 39 38
+f 33 37 38 34
+f 34 38 39 35
+f 35 39 40 36
+f 37 33 36 40
+o StarterVehicleWheelBR
+v 0.45 0.05 0.65
+v 0.9 0.05 0.65
+v 0.9 0.5 0.65
+v 0.45 0.5 0.65
+v 0.45 0.05 0.85
+v 0.9 0.05 0.85
+v 0.9 0.5 0.85
+v 0.45 0.5 0.85
+f 41 42 43 44
+f 45 48 47 46
+f 41 45 46 42
+f 42 46 47 43
+f 43 47 48 44
+f 45 41 44 48