unity-control-protocol

Manage project assets with `ucp asset` (search/move/bulk-move/import-settings/reimport/info/inspect), bridge-mediated file I/O via `ucp files` (read/write/patch), and shader diagnostics via `ucp shader errors`. Use when the user wants to find/move assets, edit importer settings, reimport, or read/write project files. For broad multi-surface Unity automation, use the unity-control-protocol skill instead.

Drive the build pipeline with `ucp build` (targets/active-target/set-target/scenes/set-scenes/start/defines/set-defines). Use when the user wants to inspect or change the build target, scene list, scripting defines, or run a build. For broad multi-surface Unity automation, use the unity-control-protocol skill instead.

Create and edit materials with `ucp material` (create/get-properties/get-property/set-property/keywords/set-keyword/set-shader). Use when the user wants to create a material or read/write its properties, keywords, or shader. For broad multi-surface Unity automation, use the unity-control-protocol skill instead.

Create and edit GameObjects and components with `ucp object` (create incl. `--primitive`, get/set-property, get-fields, add/remove-component, reparent, instantiate, delete, set-active, set-name). Use when the user wants to spawn, inspect, or modify GameObjects and their components. For broad multi-surface Unity automation, use the unity-control-protocol skill instead.

Manage Unity packages with `ucp packages` (search/add/remove/info/dependency, scoped registries, and selective `.unitypackage` import). Use when the user wants to install/remove UPM packages, manage scoped registries, or selectively import a `.unitypackage`. For broad multi-surface Unity automation, use the unity-control-protocol skill instead.

Work with prefabs via `ucp prefab` (status/apply/revert/unpack/create/overrides). Use when the user wants to create prefabs, apply or revert overrides, unpack, or inspect prefab status. For broad multi-surface Unity automation, use the unity-control-protocol skill instead.

Profile play mode with `ucp profiler` (status/config/session/capture/frames/hierarchy/timeline/callstacks/summary), plus `ucp profile` and `ucp frame capture`. Use when the user wants to capture profiler frames and analyze performance, spikes, or hot paths. For broad multi-surface Unity automation, use the unity-control-protocol skill instead.

Find references across the project with `ucp references` (find/index/check/find-strings) using native Rust indexing — read-only. Use when the user wants to find every place an asset, script, material, or prefab is referenced. For broad multi-surface Unity automation, use the unity-control-protocol skill instead.

Manage scenes and the editor lifecycle with `ucp scene` (list/load/active/save/focus/snapshot/query), `ucp editor`, and `ucp play|stop|pause|compile|screenshot`. Use when the user wants to open/save/snapshot scenes, enter or exit play mode, recompile, or screenshot the editor. For broad multi-surface Unity automation, use the unity-control-protocol skill instead.

Read and write project settings with `ucp settings` (player/quality/physics/lighting/tags-layers and their set-* plus add-tag/add-layer). Use when the user wants to inspect or change player, quality, physics, lighting, or tags/layers settings. For broad multi-surface Unity automation, use the unity-control-protocol skill instead.

Reason about scene geometry with `ucp spatial` (raycast/overlap/bounds/ground/nearest). Use when the user wants to place objects on surfaces, cast rays, or query bounds and nearby objects. For broad multi-surface Unity automation, use the unity-control-protocol skill instead.

Run tests and named editor scripts with `ucp run-tests`, `ucp exec` (list/run), and `ucp script doctor`. Use when the user wants to run edit/play-mode tests, execute a named editor script, or diagnose a script. For broad multi-surface Unity automation, use the unity-control-protocol skill instead.

Author object transforms with `ucp transform` (move/rotate/scale/look-at/get) using Euler degrees, world|local space, and `--relative` offsets. Use when the user wants to position, orient, or scale objects in the scene. For broad multi-surface Unity automation, use the unity-control-protocol skill instead.

Access Unity Version Control (Plastic SCM) as a lightweight fallback with `ucp vcs`. Use when the user wants bridge-backed version-control actions and the native `cm` CLI is unavailable. For broad multi-surface Unity automation, use the unity-control-protocol skill instead.

Render objects and the scene for vision models with `ucp view` (capture/isolate/orbit) and `ucp screenshot`. Use when the user wants a rendered image of an object or the scene to inspect 3D shape or state. For broad multi-surface Unity automation, use the unity-control-protocol skill instead.

Programmatic control of the Unity Editor from the terminal via the `ucp` CLI. Automate scenes, GameObjects, components, assets, materials, prefabs, build pipelines, settings, tests, packages, selective `.unitypackage` import, debugging and profiling over a WebSocket/JSON-RPC 2.0 bridge. Use when the user asks to inspect, create, modify, or automate anything inside a Unity project without opening the Editor UI.