Check whether the Unity Editor bridge is reachable and report Unity/editor versions.

Use when: before any other Unity tool, or when calls fail with connection errors. Don't use when: you already have a fresh successful response — skip re-pinging.

Get project name, path, Unity version, active scene and play-mode state.

Use when: starting a session to orient yourself in the project. Returns: { projectName, projectPath, unityVersion, activeScene{name,path,isDirty,rootCount}, playMode }.

Get the active scene: name, path, dirty flag, root object count, build index.

Use when: you need to know which scene is open before querying hierarchy.

List root GameObjects of the active scene with components summary. Paginated.

Args:

• root_only (bool, default true): only roots; false includes one level of children in 'children'

• limit (1-100, default 20), offset (default 0)

• response_format markdown|json

Use when: exploring what is in the scene. For search use unity_find_gameobjects. Returns markdown list + structured { total, count, offset, items, has_more, next_offset }.

Save the active scene to disk (AssetDatabase + EditorSceneManager.SaveOpenScenes).

Use when: after create/delete/transform batches so work is not lost. Idempotent: saving twice has no extra effect.

Search GameObjects by name substring, tag, or component type. At least one filter required. Paginated.

Examples:

• name_contains "Player" -> players, spawn points

• tag "Enemy" -> all enemies

• with_component "Rigidbody" -> physics objects Returns { total, count, offset, items[{name,path,active}], has_more, next_offset }.

Full details of one GameObject by hierarchy path: transform, tag/layer, components list.

Use path like 'Player' or 'Level/Enemies/Orc'. For search use unity_find_gameobjects first.

List all components on a GameObject with enabled flags.

Use when: inspecting what behaviour/rendering an object has before modifying it.

Create an empty GameObject or a Unity primitive (cube/sphere/capsule/cylinder/plane/quad), optionally parented. Uses Undo so it can be reverted in Editor.

Args: name (required), primitive_type (default none), position/rotation/scale arrays, parent_path (optional). Returns { path, name }. Save with unity_save_scene when done.

Delete a GameObject by path (Undo-able in Editor, but file-wise destructive once scene is saved).

Provide exact path from unity_find_gameobjects. Double-check path before calling.

Partially update position (world), rotation euler degrees (world), scale (local). Provide only fields to change.

Example: {"path":"Player","position":[0,1,0]} moves player without touching rotation.

Add a component by type name to a GameObject. Uses Undo.

Example: {"path":"Player","component_type":"Rigidbody"}. Check unity_get_components first to avoid duplicates.

Set one serialized property/field on a component. Value is parsed as JSON.

Examples:

• {"path":"Player","component_type":"Rigidbody","property":"mass","value_json":"5.0"}

• {"path":"Sun","component_type":"Light","property":"intensity","value_json":"2.5"} Fails with allowed-type hint if the property is not settable — read the error and retry.

Read buffered Unity console entries, most recent first. Filter by type.

Use when: 'summarize warnings/errors', 'check console after my change', verifying a fix. For full stacks use response_format json (stackTrace included). Default types: warning+error.

Clear the Unity console buffer (log cache in the bridge + Editor log view).

Use when: you want a clean baseline before reproducing an error.

Report stopped|playing|paused. Use before set or before assuming edits apply (edits in play mode are discarded on stop).

Enter/exit play mode: play|stop|pause|unpause. Scene edits made while playing are lost on stop — prefer stopped for structural changes.

List .cs files under a project folder with sizes. Paginated.

Args: folder (default 'Assets'), filter substring (optional), limit/offset. Use when: finding where game code lives before reading or editing it.

Read a script with line numbers, paginated. Always read before updating.

Args: path ('Assets/Scripts/X.cs'), start_line (1-based, default 1), max_lines (default 200). Returns { path, total_lines, start_line, content } — content lines prefixed 'line: code'.

Create a script from a Unity 6 template. Refreshes AssetDatabase so Unity compiles it.

Args: path ('Assets/Scripts/PlayerController.cs'), template monobehaviour|scriptableobject|editor|empty, class_name (default = file name; must match file name), overwrite (default false). After creating, wait for compilation (console check) before attaching.

Replace an exact text block in a script (like a focused diff hunk). Fails unless old_text occurs exactly expected_occurrences times.

Workflow: unity_read_script first, copy old_text verbatim (whitespace matters), then call with new_text. Returns { path, replaced, total_lines }. Unity recompiles after the change — check console for errors.

Attach a MonoBehaviour class to a GameObject (Undo-able). Script must be compiled — no compile errors in console.

Args: object_path ('Player'), script_class ('PlayerController'). Fails with hint if the class is not found (typo? not compiled yet?) — read the error.

Browse AssetDatabase: find assets by folder, name substring and type. Paginated.

Args: folder (default 'Assets'), filter (name substring, optional), type (Prefab/Material/Texture2D/AudioClip/Scene/..., optional), limit/offset. Use when: locating prefabs, materials or textures before instantiating or assigning them.

Force Unity to reimport an asset (picks up external file changes).

Args: path ('Assets/Textures/logo.png'). Idempotent — reimporting twice is harmless.

List what an asset depends on (textures of a material, scripts of a prefab, ...). Recursive by default.

Args: path, recursive (default true). Use when: checking what will break if you move/delete an asset, or why a prefab pulls in half the project.

Map the project folder tree up to a depth (default 3). Read-only overview of how the project is organized.

Args: folder (default 'Assets'), depth 1-5 (default 3). Large folders are truncated with a note — drill into subfolders for detail.

Instantiate a prefab from an asset path into the active scene (Undo-able). Keeps the prefab link so overrides can be applied later.

Args: prefab_path ('Assets/Prefabs/Enemy.prefab'), name override (optional), position/rotation, parent_path (optional). Find prefabs first with unity_list_assets type='Prefab'.

Apply an instance's overrides back to its prefab source (Undo-able, but affects all instances once saved).

Args: object_path of the instance ('Level/Enemy_1'). Fails with hint if the object is not a prefab instance.

Compile and run bare C# statements inside the Unity Editor via Roslyn/AssemblyBuilder. Returns a job_id immediately — poll unity_get_code_result for completion (compile takes ~2-10s).

Code rules: bare statements only (wrapped into static Run(); UnityEngine/UnityEditor/System/LINQ usings included); 'return ;' sends JSON back. Keep snippets short and side-effect aware (runs on main thread; infinite loops hang the Editor). Sandbox blocks: filesystem (System.IO/File./Directory.), processes, network, reflection-load (Assembly.Load/Activator/DllImport), Application.Quit, while(true)/for(;;). Requires: mutations ON + 'Enable C# execution' in Window > Unity MCP (off by default).

Poll a code-execution job: running | done {output, logs} | error {error, logs}.

Use when: after unity_execute_code returned a job_id. If still running, wait and poll again. Output is the JSON of your 'return' value; logs are Debug.Log lines captured during Run().

Drive the player tank remotely: throttle/steer become the TankController input (physical keyboard ignored while override is on). Fire is edge-triggered — one call queues exactly one shot.

Loop: unity_get_game_state -> decide -> unity_set_player_input (repeat ~2-5x/sec) -> poll result. Call unity_clear_player_input to hand control back to the human.

Hand control back to the human: disables the remote override, zeroes throttle/steer, drops queued shots.

One-call snapshot for self-play: every tank's team, hp/maxHP, alive, position [x,y,z], hull yaw, turret yaw, reload fraction (1 = ready).

Use in the drive loop before each unity_set_player_input. JSON format recommended for parsing.

Trigger Unity asset reimport + script recompilation on demand (AssetDatabase.Refresh).

Use when: files were written to the project from outside the Editor (scripts, models, textures) and Unity hasn't picked them up yet — e.g. background work while the Editor is unfocused. Idempotent.