{"owner":"CoplayDev","repo":"unity-mcp","hasSkills":true,"totalSkillsCount":91,"totalTokensCount":69388,"categories":["claude-rule","mcp-config","anthropic-skill"],"hasMcp":true,"mcpConfig":{"mcpServers":{"unity-mcp":{"command":"npx","args":["-y","@modelcontextprotocol/server-unity-mcp"]}}},"found":["CLAUDE.md",".claude/mcp.json",".claude/skills/mcp-source/SKILL.md",".claude/skills/unity-mcp-skill/SKILL.md",".claude/skills/blender-to-unity/SKILL.md","tools/UPDATE_DOCS_PROMPT.md","tools/unity-versions.json","unity-mcp-skill/references/tools-reference.md","unity-mcp-skill/references/probuilder-guide.md","unity-mcp-skill/references/resources-reference.md","unity-mcp-skill/references/workflows.md",".claude/skills/blender-to-unity/manual-verify.md","TestProjects/UnityMCPTests/Packages/manifest.json","TestProjects/AssetStoreUploads/Packages/manifest.json","TestProjects/AssetStoreUploads/Packages/packages-lock.json",".claude/skills/unity-mcp-skill/references/tools-reference.md",".claude/skills/unity-mcp-skill/references/workflows.md",".claude/skills/blender-to-unity/references/bridge-fidelity.md","TestProjects/AssetStoreUploads/Packages/com.unity.asset-store-tools/CHANGELOG.md","TestProjects/AssetStoreUploads/Packages/com.unity.asset-store-tools/LICENSE.md","TestProjects/AssetStoreUploads/Packages/com.unity.asset-store-tools/package.json","website/docs/reference/tools/index.md","TestProjects/UnityMCPTests/ProjectSettings/Packages/com.unity.testtools.codecoverage/Settings.json","website/docs/reference/tools/docs/_category_.json","website/docs/reference/tools/docs/index.md","website/docs/reference/tools/docs/unity_docs.md","website/docs/reference/tools/docs/unity_reflect.md","website/docs/reference/tools/core/_category_.json","website/docs/reference/tools/core/apply_text_edits.md","website/docs/reference/tools/core/batch_execute.md","website/docs/reference/tools/core/create_script.md","website/docs/reference/tools/core/debug_request_context.md","website/docs/reference/tools/core/delete_script.md","website/docs/reference/tools/core/execute_custom_tool.md","website/docs/reference/tools/core/execute_menu_item.md","website/docs/reference/tools/core/find_gameobjects.md","website/docs/reference/tools/core/find_in_file.md","website/docs/reference/tools/core/get_sha.md","website/docs/reference/tools/core/index.md","website/docs/reference/tools/core/manage_asset.md","website/docs/reference/tools/core/manage_build.md","website/docs/reference/tools/core/manage_camera.md","website/docs/reference/tools/core/manage_components.md","website/docs/reference/tools/core/manage_editor.md","website/docs/reference/tools/core/manage_gameobject.md","website/docs/reference/tools/core/manage_graphics.md","website/docs/reference/tools/core/manage_material.md","website/docs/reference/tools/core/manage_packages.md","website/docs/reference/tools/core/manage_physics.md","website/docs/reference/tools/core/manage_prefabs.md","website/docs/reference/tools/core/manage_scene.md","website/docs/reference/tools/core/manage_script.md","website/docs/reference/tools/core/manage_script_capabilities.md","website/docs/reference/tools/core/manage_tools.md","website/docs/reference/tools/core/read_console.md","website/docs/reference/tools/core/refresh_unity.md","website/docs/reference/tools/core/script_apply_edits.md","website/docs/reference/tools/core/set_active_instance.md","website/docs/reference/tools/core/validate_script.md","website/docs/reference/tools/asset_gen/_category_.json","website/docs/reference/tools/asset_gen/generate_audio.md","website/docs/reference/tools/asset_gen/generate_image.md","website/docs/reference/tools/asset_gen/generate_model.md","website/docs/reference/tools/asset_gen/import_model.md","website/docs/reference/tools/asset_gen/import_model_file.md","website/docs/reference/tools/asset_gen/index.md","website/docs/reference/tools/animation/_category_.json","website/docs/reference/tools/animation/index.md","website/docs/reference/tools/animation/manage_animation.md","website/docs/reference/tools/probuilder/_category_.json","website/docs/reference/tools/probuilder/index.md","website/docs/reference/tools/probuilder/manage_probuilder.md","website/docs/reference/tools/profiling/_category_.json","website/docs/reference/tools/profiling/index.md","website/docs/reference/tools/profiling/manage_profiler.md","website/docs/reference/tools/scripting_ext/_category_.json","website/docs/reference/tools/scripting_ext/execute_code.md","website/docs/reference/tools/scripting_ext/index.md","website/docs/reference/tools/scripting_ext/manage_scriptable_object.md","website/docs/reference/tools/testing/_category_.json","website/docs/reference/tools/testing/get_test_job.md","website/docs/reference/tools/testing/index.md","website/docs/reference/tools/testing/run_tests.md","website/docs/reference/tools/ui/_category_.json","website/docs/reference/tools/ui/index.md","website/docs/reference/tools/ui/manage_ui.md","website/docs/reference/tools/vfx/_category_.json","website/docs/reference/tools/vfx/index.md","website/docs/reference/tools/vfx/manage_shader.md","website/docs/reference/tools/vfx/manage_texture.md","website/docs/reference/tools/vfx/manage_vfx.md"],"skills":{"CLAUDE.md":"# CLAUDE.md\n\nThis file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.\n\n## What This Project Is\n\n**MCP for Unity** is a bridge that lets AI assistants (Claude, Cursor, Windsurf, etc.) control the Unity Editor through the Model Context Protocol (MCP). It enables AI-driven game development workflows - creating GameObjects, editing scripts, managing assets, running tests, and more.\n\n## Architecture\n\n```text\nAI Assistant (Claude/Cursor)\n ↓ MCP Protocol (stdio/HTTP)\nPython Server (Server/src/)\n ↓ WebSocket + HTTP\nUnity Editor Plugin (MCPForUnity/)\n ↓ Unity Editor API\nScene, Assets, Scripts\n```\n\n**Two codebases, one system:**\n- `Server/` - Python MCP server using FastMCP\n- `MCPForUnity/` - Unity C# Editor package\n\n### Three Layers on the Python Side\n\nThe Python server has three distinct layers. These are **not** auto-generated from each other:\n\n| Layer | Location | Framework | Purpose |\n|-------|----------|-----------|---------|\n| **MCP Tools** | `Server/src/services/tools/` | FastMCP (`@mcp_for_unity_tool`) | Exposed to AI assistants via MCP protocol |\n| **CLI Commands** | `Server/src/cli/commands/` | Click (`@click.command`) | Terminal interface for developers |\n| **Resources** | `Server/src/services/resources/` | FastMCP (`@mcp_for_unity_resource`) | Read-only state exposed to AI assistants |\n\nMCP tools call Unity via WebSocket (`send_with_unity_instance`). CLI commands call Unity via HTTP (`run_command`). Both route to the same C# `HandleCommand` methods.\n\n### Transport Modes\n\n- **Stdio**: Single-agent only. Separate Python process per client. Legacy TCP bridge to Unity. New connections stomp old ones.\n- **HTTP**: Multi-agent ready. Single shared Python server. WebSocket hub at `/hub/plugin`. Session isolation via `client_id`.\n\n## Code Philosophy\n\n### 1. Domain Symmetry\nPython MCP tools mirror C# Editor tools. Each domain exists in both:\n- `Server/src/services/tools/manage_material.py` ↔ `MCPForUnity/Editor/Tools/ManageMaterial.cs`\n- CLI commands (`Server/src/cli/commands/`) also mirror these but are a separate implementation.\n\n### 2. Minimal Abstraction\nAvoid premature abstraction. Three similar lines of code is better than a helper that's used once. Only abstract when you have 3+ genuine use cases.\n\n### 3. Delete Rather Than Deprecate\nWhen removing functionality, delete it completely. No `_unused` renames, no `// removed` comments, no backwards-compatibility shims for internal code.\n\n### 4. Test Coverage Required\nEvery new feature needs tests. Run them before PRs.\n\n### 5. Keep Tools Focused\nEach MCP tool does one thing well. Resist the urge to add \"convenient\" parameters that bloat the API surface.\n\n### 6. Use Resources for Reading\nKeep them smart and focused rather than \"read everything\" type resources. Resources should be quick and LLM-friendly.\n\n## Key Patterns\n\n### Python MCP Tool Registration\nTools in `Server/src/services/tools/` are auto-discovered. Use the `@mcp_for_unity_tool` decorator:\n```python\nfrom services.registry import mcp_for_unity_tool\n\n@mcp_for_unity_tool(\n description=\"Does something in Unity.\",\n group=\"core\", # core (default), vfx, animation, ui, scripting_ext, testing, probuilder, profiling, docs, asset_gen\n)\nasync def manage_something(\n ctx: Context,\n action: Annotated[Literal[\"create\", \"delete\"], \"Action to perform\"],\n) -> dict[str, Any]:\n unity_instance = await get_unity_instance_from_context(ctx)\n params = {\"action\": action}\n response = await send_with_unity_instance(async_send_command_with_retry, unity_instance, \"manage_something\", params)\n return response\n```\n\nThe `group` parameter controls tool visibility. Only `\"core\"` is enabled by default. Non-core groups (vfx, animation, etc.) start disabled and are toggled via `manage_tools`.\n\n### Python CLI Error Handling\nCLI commands (not MCP tools) use the `@handle_unity_errors` decorator:\n```python\n@handle_unity_errors\nasync def my_command(ctx, ...):\n result = await call_unity_tool(...)\n```\n\n### C# Tool Registration\nTools are auto-discovered by `CommandRegistry` via reflection. Use the `[McpForUnityTool]` attribute:\n```csharp\n[McpForUnityTool(\"manage_something\", AutoRegister = false, Group = \"core\")]\npublic static class ManageSomething\n{\n // Sync handler (most tools):\n public static object HandleCommand(JObject @params)\n {\n var p = new ToolParams(@params);\n // ...\n return new SuccessResponse(\"Done.\", new { data = result });\n }\n\n // OR async handler (for long-running operations like play-test, refresh, batch):\n public static async Task HandleCommand(JObject @params)\n {\n // CommandRegistry detects Task return type automatically\n await SomeAsyncOperation();\n return new SuccessResponse(\"Done.\");\n }\n}\n```\n\nAsync handlers use `EditorApplication.update` polling with `TaskCompletionSource` — see `RefreshUnity.cs` for the canonical pattern.\n\n### C# Parameter Handling\nUse `ToolParams` for consistent parameter validation:\n```csharp\nvar p = new ToolParams(parameters);\nvar pageSize = p.GetInt(\"page_size\", \"pageSize\") ?? 50;\nvar name = p.RequireString(\"name\");\n```\n\n### C# Resources\nResources use `[McpForUnityResource]` and follow the same `HandleCommand` pattern as tools. They provide read-only state to AI assistants.\n\n### Paging Large Results\nAlways page results that could be large (hierarchies, components, search results):\n- Use `page_size` and `cursor` parameters\n- Return `next_cursor` when more results exist\n\n### Composing Tools Internally (C#)\nUse `CommandRegistry.InvokeCommandAsync` to call other tools from within a handler:\n```csharp\nvar result = await CommandRegistry.InvokeCommandAsync(\"read_console\", consoleParams);\n```\n\n### Unity API Compatibility Shims\nWe support a wide Unity version range (2021+ → 6.x → CoreCLR 6.8). When an API is renamed, deprecated, or removed across versions, **don't sprinkle `#if UNITY_x_y_OR_NEWER` at every call site** — add a shim in `MCPForUnity/Runtime/Helpers/Unity*Compat.cs` and route every caller through it.\n\nThe catalog of active shims, the policy for when to add one, what does NOT belong in a shim, and the reflection-cache pattern all live in **`MCPForUnity/Runtime/Helpers/UnityCompatShims.cs`** — the XML doc on that empty marker class is the source of truth and ships inside the UPM package, so end-users can `F12`/Go-to-definition into it. Sources for current deprecations: Unity 6.x upgrade guides and the [CoreCLR 2026 thread](https://discussions.unity.com/t/path-to-coreclr-2026-upgrade-guide/1714279).\n\nWhen you touch a shim or anything else gated by `#if UNITY_*_OR_NEWER`, run `tools/check-unity-versions.sh` to compile-check across the CI matrix locally before committing — the matrix lives in `tools/unity-versions.json`.\n\n## Commands\n\n### Running Tests\n```bash\n# Python (all tests)\ncd Server && uv run pytest tests/ -v\n\n# Python (single test file)\ncd Server && uv run pytest tests/test_manage_material.py -v\n\n# Python (single test by name)\ncd Server && uv run pytest tests/ -k \"test_create_material\" -v\n\n# Unity - open TestProjects/UnityMCPTests in Unity, use Test Runner window\n\n# Local multi-version compile check (parity with CI matrix, see tools/unity-versions.json)\ntools/check-unity-versions.sh # compile-only across installed Unity Hub editors\ntools/check-unity-versions.sh --full # full EditMode test run\n\n# License-free Roslyn compile of MCPForUnity, the same gate compile-check.yml runs on every PR.\n# No Editor launch, ~1 min per version. EXTRA_REFS must hold Newtonsoft.Json.dll and\n# nunit.framework.dll (copy them from TestProjects/UnityMCPTests/Library/PackageCache);\n# the script header has the full recipe, including the Windows/Git Bash form.\nUNITY_DATA=/path/to/Editor/Data UNITY_VERSION=2021.3.45f2 EXTRA_REFS=/path/to/refs tools/compile-check.sh\n```\n\n#### Local headless test harness\nOne command boots a headless Hub-licensed Editor against `TestProjects/UnityMCPTests` and runs the smoke + EditMode + PlayMode legs over the bridge — the same entrypoint CI uses (`.github/workflows/e2e-bridge.yml`):\n\n```bash\npython tools/local_harness.py\n```\n\nKey flags: `--legs smoke,editmode,playmode` (subset to run), `--project-path` (target project, default `TestProjects/UnityMCPTests`), `--reuse` (attach to an already-resident bridge instead of booting one), `--keep-alive` (leave the Editor running after the legs), `--no-warmup` (skip the warm-up import phase).\n\nExit codes: `0` pass, `1` blocking-leg regression, `2` bridge unreachable / setup failure, `3` project does not compile, `4` no Unity license / Hub seat, `5` Editor binary/version not found. Requires a Hub-activated Editor locally (no ULF/serial).\n\n### Local Development\n1. Set **Server Source Override** in MCP for Unity Advanced Settings to your local `Server/` path\n2. Enable **Dev Mode** checkbox to force fresh installs\n3. Use `mcp_source.py` to switch Unity package sources\n4. Test on Windows and Mac if possible, and multiple clients (Claude Desktop and Claude Code are tricky for configuration as of this writing)\n\n### Adding a New Tool\n1. Add Python MCP tool in `Server/src/services/tools/manage_.py` using `@mcp_for_unity_tool`\n2. Add Python CLI commands in `Server/src/cli/commands/.py` using Click\n3. Add C# implementation in `MCPForUnity/Editor/Tools/Manage.cs` with `[McpForUnityTool]`\n4. Add Python tests in `Server/tests/test_manage_.py`\n5. Add Unity tests in `TestProjects/UnityMCPTests/Assets/Tests/`\n\n## What Not To Do\n\n- Don't add features without tests\n- Don't create helper functions for one-time operations\n- Don't add error handling for scenarios that can't happen\n- Don't commit to `main` directly - branch off `beta` for PRs\n- Don't add docstrings/comments to code you didn't change\n",".claude/mcp.json":"{\n \"mcpServers\": {\n \"UnityMCP\": {\n \"type\": \"http\",\n \"url\": \"http://localhost:8080/mcp\"\n }\n }\n}\n",".claude/skills/mcp-source/SKILL.md":"---\nname: mcp-source\ndescription: Switch MCP for Unity package source in connected Unity projects. Use /mcp-source [main|beta|branch|local] to swap between upstream releases, your remote branch, or local dev checkout.\n---\n\n# Switch MCP for Unity Package Source\n\nYou are switching the `com.coplaydev.unity-mcp` package source in one or more Unity projects.\n\n## allowed-tools\n\nBash, Read, Edit, ReadMcpResourceTool, ListMcpResourcesTool\n\n## Instructions\n\n### 1. Parse arguments\n\nThe user's argument is: `$ARGUMENTS`\n\nValid values: `main`, `beta`, `branch`, `local`, or empty.\n\nIf empty or not one of the four valid values, ask the user to choose:\n- **main** — upstream main branch (stable releases)\n- **beta** — upstream beta branch (pre-release)\n- **branch** — your current remote branch (for testing a PR)\n- **local** — local file reference to your checkout (for live dev iteration)\n\n### 2. Detect repo context\n\nRun these git commands from the current working directory to find the unity-mcp repo:\n\n```bash\ngit rev-parse --show-toplevel # → repo_root\ngit rev-parse --abbrev-ref HEAD # → branch_name\ngit remote get-url origin # → origin_url\n```\n\nConvert SSH origins to HTTPS: if `origin_url` starts with `git@github.com:`, transform it to `https://github.com/{owner}/{repo}.git`.\n\n### 3. Discover target Unity projects\n\nTry two approaches to find `Packages/manifest.json` files to update:\n\n**Approach A — MCP resources (preferred):**\nRead `mcpforunity://project/info` for each connected Unity instance (use `ListMcpResourcesTool` to find available instances). Extract `projectRoot` and use `{projectRoot}/Packages/manifest.json`.\n\n**Approach B — filesystem fallback:**\nIf no MCP instances are connected, search upward from the current working directory for `Packages/manifest.json` files using Bash:\n```bash\nfind \"$(pwd)\" -maxdepth 3 -name \"manifest.json\" -path \"*/Packages/manifest.json\" 2>/dev/null\n```\n\nIf multiple manifests are found, update all of them (confirming with the user first).\n\n### 4. Build the package URL\n\nBased on the user's selection, construct the dependency value:\n\n| Selection | URL |\n|-----------|-----|\n| `main` | `https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main` |\n| `beta` | `https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#beta` |\n| `branch` | `{origin_https}?path=/MCPForUnity#{branch_name}` |\n| `local` | `file:{repo_root}/MCPForUnity` |\n\nFor `branch`: use the HTTPS-normalized origin URL and current git branch name.\nFor `local`: use the absolute path to the repo root with `file:` prefix (no `//`), e.g. `file:/Users/davidsarno/unity-mcp/MCPForUnity`.\n\n### 5. Update each manifest\n\nFor each discovered `manifest.json`:\n\n1. Read the file with the Read tool\n2. Find the `\"com.coplaydev.unity-mcp\"` dependency line\n3. Use the Edit tool to replace the old value with the new URL\n4. Report what was changed: old value → new value, file path\n\n### 6. Report results\n\nAfter updating, tell the user:\n- Which manifests were updated\n- The old and new package source values\n- Remind them: \"Unity will re-resolve the package automatically. If it doesn't, open Package Manager and click Refresh.\"\n",".claude/skills/unity-mcp-skill/SKILL.md":"---\nname: unity-mcp-orchestrator\ndescription: Orchestrate Unity Editor via MCP (Model Context Protocol) tools and resources. Use when working with Unity projects through MCP for Unity - creating/modifying GameObjects, editing scripts, managing scenes, running tests, or any Unity Editor automation. Provides best practices, tool schemas, and workflow patterns for effective Unity-MCP integration.\n---\n\n# Unity-MCP Operator Guide\n\nThis skill helps you effectively use the Unity Editor with MCP tools and resources.\n\n## Template Notice\n\nExamples in `references/workflows.md` and `references/tools-reference.md` are reusable templates. They may be inaccurate across Unity versions, package setups (UGUI/TMP/Input System), and project-specific conventions. Please check console, compilation errors, or use screenshot after implementation.\n\nBefore applying a template:\n- Validate targets/components first via resources and `find_gameobjects`.\n- Treat names, enum values, and property payloads as placeholders to adapt.\n\n## Quick Start: Resource-First Workflow\n\n**Always read relevant resources before using tools.** This prevents errors and provides the necessary context.\n\n```\n1. Check editor state → mcpforunity://editor/state\n2. Understand the scene → mcpforunity://scene/gameobject-api\n3. Find what you need → find_gameobjects or resources\n4. Take action → tools (manage_gameobject, create_script, script_apply_edits, apply_text_edits, validate_script, delete_script, get_sha, etc.)\n5. Verify results → read_console, manage_camera(action=\"screenshot\"), resources\n```\n\n**If a tool you need is not in your tool list, it is not necessarily missing.** Check these before troubleshooting the connection:\n\n- **Project custom tools** (C# `[McpForUnityTool]`): with project-scoped tools enabled on the server, they are *not* callable by name. List them via `mcpforunity://custom-tools` and run them with `execute_custom_tool(tool_name=\"...\", parameters={...})`. With it disabled, they are registered as ordinary tools and appear in your list.\n- **Disabled tool groups**: over HTTP, a session starts with only the `core` group enabled. Over stdio, all groups start enabled and are then synced to the tool toggles in the Unity editor, so a tool can still be hidden. `manage_tools(action=\"list_groups\")` shows the groups, `manage_tools(action=\"activate\", group=\"...\")` enables one.\n\n## Critical Best Practices\n\n### 1. After Writing/Editing Scripts: Wait for Compilation and Check Console\n\n```python\n# After create_script or script_apply_edits:\n# Both tools already trigger AssetDatabase.ImportAsset + RequestScriptCompilation automatically.\n# No need to call refresh_unity — just wait for compilation to finish, then check console.\n\n# 1. Poll editor state until compilation completes\n# Read mcpforunity://editor/state → wait until is_compiling == false\n\n# 2. Check for compilation errors\nread_console(types=[\"error\"], count=10, include_stacktrace=True)\n```\n\n**Why:** Unity must compile scripts before they're usable. `create_script` and `script_apply_edits` already trigger import and compilation automatically — calling `refresh_unity` afterward is redundant.\n\n### 2. Use `batch_execute` for Multiple Operations\n\n```python\n# 10-100x faster than sequential calls\nbatch_execute(\n commands=[\n {\"tool\": \"manage_gameobject\", \"params\": {\"action\": \"create\", \"name\": \"Cube1\", \"primitive_type\": \"Cube\"}},\n {\"tool\": \"manage_gameobject\", \"params\": {\"action\": \"create\", \"name\": \"Cube2\", \"primitive_type\": \"Cube\"}},\n {\"tool\": \"manage_gameobject\", \"params\": {\"action\": \"create\", \"name\": \"Cube3\", \"primitive_type\": \"Cube\"}}\n ],\n parallel=True # Hint only: Unity may still execute sequentially\n)\n```\n\n**Max 25 commands per batch by default (configurable in Unity MCP Tools window, max 100).** Use `fail_fast=True` for dependent operations.\n\n**Tip:** Also use `batch_execute` for discovery — batch multiple `find_gameobjects` calls instead of calling them one at a time:\n```python\nbatch_execute(commands=[\n {\"tool\": \"find_gameobjects\", \"params\": {\"search_term\": \"Camera\", \"search_method\": \"by_component\"}},\n {\"tool\": \"find_gameobjects\", \"params\": {\"search_term\": \"Player\", \"search_method\": \"by_tag\"}},\n {\"tool\": \"find_gameobjects\", \"params\": {\"search_term\": \"GameManager\", \"search_method\": \"by_name\"}}\n])\n```\n\n### 3. Use Screenshots to Verify Visual Results\n\n```python\n# Basic screenshot (saves to Assets/, returns file path only)\nmanage_camera(action=\"screenshot\")\n\n# Inline screenshot (returns base64 PNG directly to the AI)\nmanage_camera(action=\"screenshot\", include_image=True)\n\n# Use a specific camera and cap resolution for smaller payloads\nmanage_camera(action=\"screenshot\", camera=\"MainCamera\", include_image=True, max_resolution=512)\n\n# Batch surround: captures front/back/left/right/top/bird_eye around the scene\nmanage_camera(action=\"screenshot\", batch=\"surround\", max_resolution=256)\n\n# Batch surround centered on a specific object\nmanage_camera(action=\"screenshot\", batch=\"surround\", view_target=\"Player\", max_resolution=256)\n\n# Positioned screenshot: place a temp camera and capture in one call\nmanage_camera(action=\"screenshot\", view_target=\"Player\", view_position=[0, 10, -10], max_resolution=512)\n\n# Scene View screenshot: capture what the developer sees in the editor\nmanage_camera(action=\"screenshot\", capture_source=\"scene_view\", include_image=True)\n\n# Scene View framed on a specific object\nmanage_camera(action=\"screenshot\", capture_source=\"scene_view\", view_target=\"Canvas\", include_image=True)\n```\n\n**Best practices for AI scene understanding:**\n- Use `include_image=True` when you need to *see* the scene, not just save a file.\n- Use `batch=\"surround\"` for a comprehensive overview (6 angles, one command).\n- Use `view_target`/`view_position` to capture from a specific viewpoint without needing a scene camera.\n- Use `capture_source=\"scene_view\"` to see the editor viewport (gizmos, wireframes, grid).\n- Keep `max_resolution` at 256–512 to balance quality vs. token cost.\n\n```python\n# Agentic camera loop: point, shoot, analyze\nmanage_gameobject(action=\"look_at\", target=\"MainCamera\", look_at_target=\"Player\")\nmanage_camera(action=\"screenshot\", camera=\"MainCamera\", include_image=True, max_resolution=512)\n# → Analyze image, decide next action\n\n# Multi-view screenshot (6-angle contact sheet)\nmanage_camera(action=\"screenshot_multiview\", max_resolution=480)\n\n# Scene View for editor-level inspection (shows gizmos, debug overlays, etc.)\nmanage_camera(action=\"screenshot\", capture_source=\"scene_view\", view_target=\"Player\", include_image=True)\n```\n\n### 4. Check Console After Major Changes\n\n```python\nread_console(\n action=\"get\",\n types=[\"error\", \"warning\"], # Focus on problems\n count=10,\n format=\"detailed\"\n)\n```\n\n### 5. Always Check `mcpforunity://editor/state` Before Complex Operations\n\n```python\n# Read mcpforunity://editor/state to check:\n# - is_compiling: Wait if true\n# - is_domain_reload_pending: Wait if true \n# - ready_for_tools: Only proceed if true\n# - blocking_reasons: Why tools might fail\n```\n\n## Parameter Type Conventions\n\nThese are common patterns, not strict guarantees. `manage_components.set_property` payload shapes can vary by component/property; if a template fails, inspect the component resource payload and adjust.\n\n### Vectors (position, rotation, scale, color)\n```python\n# Both forms accepted:\nposition=[1.0, 2.0, 3.0] # List\nposition=\"[1.0, 2.0, 3.0]\" # JSON string\n```\n\n### Booleans\n```python\n# Both forms accepted:\ninclude_inactive=True # Boolean\ninclude_inactive=\"true\" # String\n```\n\n### Colors\n```python\n# Auto-detected format:\ncolor=[255, 0, 0, 255] # 0-255 range\ncolor=[1.0, 0.0, 0.0, 1.0] # 0.0-1.0 normalized (auto-converted)\n```\n\n### Paths\n```python\n# Assets-relative (default):\npath=\"Assets/Scripts/MyScript.cs\"\n\n# URI forms:\nuri=\"mcpforunity://path/Assets/Scripts/MyScript.cs\"\nuri=\"file:///full/path/to/file.cs\"\n```\n\n## Core Tool Categories\n\n| Category | Key Tools | Use For |\n|----------|-----------|---------|\n| **Scene** | `manage_scene`, `find_gameobjects` | Scene operations, finding objects. Multi-scene editing (additive load, close, set active, move GO between scenes), scene templates (`3d_basic`, `2d_basic`, `empty`, `default`), scene validation with `auto_repair`. For build settings, use `manage_build(action=\"scenes\")`. |\n| **Objects** | `manage_gameobject`, `manage_components` | Creating/modifying GameObjects |\n| **Scripts** | `create_script`, `script_apply_edits`, `validate_script` | C# code management (auto-refreshes on create/edit) |\n| **Assets** | `manage_asset`, `manage_prefabs` | Asset operations. **Prefab instantiation** is done via `manage_gameobject(action=\"create\", prefab_path=\"...\")`, not `manage_prefabs`. |\n| **Editor** | `manage_editor`, `execute_menu_item`, `read_console` | Editor control, package deployment (`deploy_package`/`restore_package`), undo/redo (`undo`/`redo` actions) |\n| **Testing** | `run_tests`, `get_test_job` | Unity Test Framework |\n| **Batch** | `batch_execute` | Parallel/bulk operations |\n| **Camera** | `manage_camera` | Camera management (Unity Camera + Cinemachine). **Tier 1** (always available): create, target, lens, priority, list, screenshot. **Tier 2** (requires `com.unity.cinemachine`): brain, body/aim/noise pipeline, extensions, blending, force/release. 7 presets: follow, third_person, freelook, dolly, static, top_down, side_scroller. Resource: `mcpforunity://scene/cameras`. Use `ping` to check Cinemachine availability. See [tools-reference.md](references/tools-reference.md#camera-tools). |\n| **Animation** | `manage_animation`, `manage_sprite` | Animator control, clips and controllers. **2D sprite sheets**: `manage_sprite(action=\"get_info\")` returns a PNG or JPEG sheet as an image to count the grid from, then `full_setup` slices it and builds clips and a controller; clip names decide the states (idle, walk/run, attack-type triggers). Off by default over HTTP: `manage_tools(action=\"activate\", group=\"animation\")`. |\n| **Graphics** | `manage_graphics` | Rendering and post-processing management. 33 actions across 5 groups: **Volume** (create/configure volumes and effects, URP/HDRP), **Bake** (lightmaps, light probes, reflection probes, Edit mode only), **Stats** (draw calls, batches, memory), **Pipeline** (quality levels, pipeline settings), **Features** (URP renderer features: add, remove, toggle, reorder). Resources: `mcpforunity://scene/volumes`, `mcpforunity://rendering/stats`, `mcpforunity://pipeline/renderer-features`. Use `ping` to check pipeline status. See [tools-reference.md](references/tools-reference.md#graphics-tools). |\n| **Packages** | `manage_packages` | Install, remove, search, and manage Unity packages and scoped registries. Query actions: list installed, search registry, get info, ping, poll status. Mutating actions: add/remove packages, embed for editing, add/remove scoped registries, force resolve. Validates identifiers, warns on git URLs, checks dependents before removal (`force=true` to override). See [tools-reference.md](references/tools-reference.md#package-tools). |\n| **Physics** | `manage_physics` | Manage 3D and 2D physics (21 actions). Settings, collision matrix, materials, joints (14 types). Queries: `raycast`, `raycast_all`, `linecast`, `shapecast` (sphere/box/capsule sweep), `overlap`. Forces: `apply_force` (AddForce/AddTorque/AddExplosionForce with ForceMode). Rigidbody: `get_rigidbody`, `configure_rigidbody` (mass, drag, gravity, constraints, collision detection). Validation: scene-wide checks. Simulation: `simulate_step` in edit mode. See [tools-reference.md](references/tools-reference.md#physics-tools). |\n| **ProBuilder** | `manage_probuilder` | 3D modeling, mesh editing, complex geometry. **When `com.unity.probuilder` is installed, prefer ProBuilder shapes over primitive GameObjects** for editable geometry, multi-material faces, or complex shapes. Supports 12 shape types, face/edge/vertex editing, smoothing, and per-face materials. See [ProBuilder Guide](references/probuilder-guide.md). |\n| **UI** | `manage_ui`, `batch_execute` with `manage_gameobject` + `manage_components` | **UI Toolkit**: Use `manage_ui` to create UXML/USS files, attach UIDocument, inspect visual trees. **uGUI (Canvas)**: Use `batch_execute` for Canvas, Panel, Button, Text, Slider, Toggle, Input Field. **Read `mcpforunity://project/info` first** to detect uGUI/TMP/Input System/UI Toolkit availability. (see [UI workflows](references/workflows.md#ui-creation-workflows)) |\n| **Docs** | `unity_reflect`, `unity_docs` | API verification and documentation lookup. **`unity_reflect`** inspects live C# APIs via reflection (requires Unity connection): `search` types across assemblies, `get_type` for member summary, `get_member` for full signatures. **`unity_docs`** fetches official docs from docs.unity3d.com (no Unity connection needed): `get_doc` (ScriptReference), `get_manual` (Manual pages), `get_package_doc` (package docs), `lookup` (parallel search all sources + project assets). **Trust hierarchy: reflection > project assets > docs.** Workflow: `unity_reflect` search -> get_type -> get_member -> `unity_docs` lookup. See [tools-reference.md](references/tools-reference.md#docs-tools). |\n| **More** | `manage_material`, `manage_texture`, `manage_shader`, `manage_vfx`, `manage_profiler`, `execute_code`, `manage_scriptable_object`, `generate_image`, `generate_model`, `generate_audio`, `import_model`, `import_model_file`, `blender_bridge` | Materials; textures, shaders and VFX (`vfx` group); profiling (`profiling`); in-editor C# and ScriptableObjects (`scripting_ext`); AI asset generation, Sketchfab and on-disk model import, Blender (`asset_gen`). Every tool has a section in [tools-reference.md](references/tools-reference.md). |\n\n## Common Workflows\n\n### Creating a New Script and Using It\n\n```python\n# 1. Create the script (automatically triggers import + compilation)\ncreate_script(\n path=\"Assets/Scripts/PlayerController.cs\",\n contents=\"using UnityEngine;\\n\\npublic class PlayerController : MonoBehaviour\\n{\\n void Update() { }\\n}\"\n)\n\n# 2. Wait for compilation to finish\n# Read mcpforunity://editor/state → wait until is_compiling == false\n\n# 3. Check for compilation errors\nread_console(types=[\"error\"], count=10)\n\n# 4. Only then attach to GameObject\nmanage_gameobject(action=\"modify\", target=\"Player\", components_to_add=[\"PlayerController\"])\n```\n\n### Finding and Modifying GameObjects\n\n```python\n# 1. Find by name/tag/component (returns IDs only)\nresult = find_gameobjects(search_term=\"Enemy\", search_method=\"by_tag\", page_size=50)\n\n# 2. Get full data via resource\n# mcpforunity://scene/gameobject/{instance_id}\n\n# 3. Modify using the ID\nmanage_gameobject(action=\"modify\", target=instance_id, position=[10, 0, 0])\n```\n\n### Running and Monitoring Tests\n\n```python\n# 1. Start test run (async)\nresult = run_tests(mode=\"EditMode\", test_names=[\"MyTests.TestSomething\"])\njob_id = result[\"job_id\"]\n\n# 2. Poll for completion\nresult = get_test_job(job_id=job_id, wait_timeout=60, include_failed_tests=True)\n```\n\n## Pagination Pattern\n\nLarge queries return paginated results. Always follow `next_cursor`:\n\n```python\ncursor = 0\nall_items = []\nwhile True:\n result = manage_scene(action=\"get_hierarchy\", page_size=50, cursor=cursor)\n all_items.extend(result[\"data\"][\"items\"])\n if not result[\"data\"].get(\"next_cursor\"):\n break\n cursor = result[\"data\"][\"next_cursor\"]\n```\n\n## Multi-Instance Workflow\n\nWhen multiple Unity Editors are running:\n\n```python\n# 1. List instances via resource: mcpforunity://instances\n# 2. Set active instance\nset_active_instance(instance=\"MyProject@abc123\")\n# 3. All subsequent calls route to that instance\n```\n\n## Error Recovery\n\n| Symptom | Cause | Solution |\n|---------|-------|----------|\n| Tools return \"busy\" | Compilation in progress | Wait, check `mcpforunity://editor/state` |\n| \"stale_file\" error | File changed since SHA | Re-fetch SHA with `get_sha`, retry |\n| Connection lost | Domain reload | Wait ~5s, reconnect |\n| Commands fail silently | Wrong instance | Check `set_active_instance` |\n\n## Reference Files\n\nFor detailed schemas and examples:\n\n- **[tools-reference.md](references/tools-reference.md)**: Every tool's main actions, parameters, and examples, with links to the full parameter tables\n- **[resources-reference.md](references/resources-reference.md)**: All available resources and their data\n- **[workflows.md](references/workflows.md)**: Extended workflow examples and patterns\n- **[probuilder-guide.md](references/probuilder-guide.md)**: ProBuilder modeling patterns\n",".claude/skills/blender-to-unity/SKILL.md":"---\nname: blender-to-unity\ndescription: Hand off a model from Blender (via BlenderMCP) into Unity (via MCP for Unity) — export the current Blender model, import it through import_model_file, and place it in the open scene. Use when the user has BlenderMCP and MCP for Unity both connected and wants to bring a Blender model into Unity. Does NOT drive Blender's own generators; BlenderMCP owns how the model got into Blender.\n---\n\n# Blender → Unity Model Handoff\n\nBring whatever model is currently in Blender into the open Unity scene. The seam is the\nlocal filesystem: Blender exports a file, Unity imports it. The two servers never talk\ndirectly.\n\n## Preconditions\n- Both `mcp__blender__*` tools and MCP for Unity tools are connected.\n- A model exists in the Blender scene (confirm with `mcp__blender__get_scene_info` /\n `mcp__blender__get_object_info`). If empty, stop and tell the user — this skill does not generate models.\n- **`import_model_file` is in the `asset_gen` tool group, which is off by default** (only `core`\n loads). Enable it first with `manage_tools` (enable the `asset_gen` group), **or** call the C#\n handler straight through `batch_execute` —\n `{\"tool\":\"import_model_file\",\"params\":{\"sourcePath\":...,\"name\":...,\"outputFolder\":...}}` (camelCase)\n — which dispatches by name regardless of group gating.\n\n## Steps\n1. **Resolve the Unity project path.** Read `mcpforunity://editor/state` for the project\n root (the editor dataPath's parent). Decide the export format:\n - **GLB (glTFast) when the model has a rig, animation, PBR (metallic/roughness), emission,\n or transparency** — glTFast carries all of these automatically, no post-processing\n (see [references/bridge-fidelity.md](references/bridge-fidelity.md)). Multi-material zones\n survive either format, so they alone don't force GLB.\n - **FBX otherwise** — when glTFast isn't installed, the model is plain geometry, or you\n specifically need the built-in importer's humanoid-avatar pipeline. FBX drops emission/metallic\n (Step 5 restores emission) and surfaces animation only with `animation_type` set (Step 3).\n2. **Export from Blender to a temp path** via `mcp__blender__execute_blender_code`:\n ```python\n import bpy, os, tempfile\n out = os.path.join(tempfile.gettempdir(), \"blender_to_unity.fbx\")\n # Export the selection if any, else the whole scene:\n bpy.ops.export_scene.fbx(filepath=out, use_selection=bool(bpy.context.selected_objects),\n apply_unit_scale=True, bake_space_transform=True)\n print(out)\n ```\n (glTF branch: `out_glb = os.path.join(tempfile.gettempdir(), \"blender_to_unity.glb\")`, then\n `bpy.ops.export_scene.gltf(filepath=out_glb, export_format='GLB', use_active_scene=True)`\n — its default `use_active_scene=False` can silently export a *different* open scene.)\n3. **Import into Unity** with `import_model_file`:\n `import_model_file(source_path=, name=, target_size=)`.\n For a **rigged/animated FBX**, also pass `animation_type=\"generic\"` (or `\"humanoid\"`; `\"legacy\"`\n targets the old Animation-component system) — the importer defaults to `\"none\"`, which\n deliberately imports the mesh with **zero animation clips**. GLB ignores this (glTFast imports\n animation itself), so it's an FBX-only knob.\n It returns `{ asset_path, asset_guid }`. Pass `target_size` as the intended final size, but treat\n it only as a hint: it rescales at import solely when the project's **Auto-normalize** pref is on,\n and even then is unreliable for Blender FBX (see the **Scale** note). Step 4 does the reliable\n normalization.\n4. **Place it in the scene, normalized to size.** Ensure the scene has a camera + directional\n light (`manage_scene` / `manage_gameobject`). Instantiate the model at the chosen position via\n `manage_gameobject(action=\"create\", prefab_path=, name=, position=[x,y,z])`.\n Then normalize its size deterministically — Blender FBX commonly imports ~100× too large — by\n measuring the placed model's world bounds and scaling so its largest dimension equals your target\n size. Run via `execute_code` (substitute your object name and target meters):\n ```csharp\n var go = GameObject.Find(\"\");\n var rs = go.GetComponentsInChildren();\n var b = rs[0].bounds; for (int i = 1; i < rs.Length; i++) b.Encapsulate(rs[i].bounds);\n float maxDim = Mathf.Max(b.size.x, Mathf.Max(b.size.y, b.size.z));\n float target = 2f; // intended size in meters\n if (maxDim > 0.0001f) go.transform.localScale *= target / maxDim;\n ```\n5. **Restore emission FBX dropped (FBX path).** Blender scenes commonly store their color/glow\n in *material emission* (and other Principled-node inputs). FBX carries base/diffuse color but\n **not emission**, so neon / \"Tron\" scenes import as dark bodies with black accents. If the\n import looks flat vs. Blender, restore it:\n a. Dump the emissive materials from Blender via `execute_blender_code`:\n ```python\n import bpy, json\n out = {}\n for m in bpy.data.materials:\n if not (m.use_nodes and m.node_tree): continue\n col, s = (0, 0, 0), 0.0\n p = next((n for n in m.node_tree.nodes if n.type == 'BSDF_PRINCIPLED'), None)\n es = next((k for k in ('Emission Color', 'Emission') if p and k in p.inputs), None) # 4.x / 3.x name\n if es:\n col = tuple(p.inputs[es].default_value)[:3]\n s = float(p.inputs['Emission Strength'].default_value)\n e = next((n for n in m.node_tree.nodes if n.type == 'EMISSION'), None)\n if e and s == 0:\n col = tuple(e.inputs['Color'].default_value)[:3]; s = float(e.inputs['Strength'].default_value)\n if s > 0 and sum(col) > 0.01:\n out[m.name] = [round(col[0], 3), round(col[1], 3), round(col[2], 3), round(s, 3)]\n print(json.dumps(out))\n ```\n b. In Unity (`execute_code`): extract the FBX's materials so they're editable\n (`AssetDatabase.ExtractAsset` per `Material`, then `ImportAsset(fbx, ForceUpdate)`), then for\n each dumped name set `_EmissionColor = color * Mathf.Clamp(strength*0.45f, 1.5f, 5f)`,\n `EnableKeyword(\"_EMISSION\")`, and `globalIlluminationFlags = RealtimeEmissive`. Match names\n **case-insensitively** — FBX mangles case and can split one material into variants\n (`EdgeCyan` → `EdgeCyan` + `EDGE_CYAN`); set every match. Add a global Bloom volume and enable\n the camera's `renderPostProcessing` so the emission actually glows.\n6. **Verify** with `manage_camera(action=\"screenshot\", include_image=true)` and report the\n asset path + a screenshot.\n\n## Notes\n- **Scale.** Models from Blender almost always arrive at the wrong scale — its FBX unit handling\n makes them land ~100× too large in Unity. `import_model_file`'s `target_size` only rescales at\n import when the project's Auto-normalize pref is enabled, and its importer-level normalization is\n unreliable for Blender FBX (it can over- or under-shoot, e.g. a `target_size=2` model measured 200 m).\n The robust fix is the Step 4 measure-bounds-then-set-`localScale` routine, which hits the target\n size deterministically regardless of the import scale or the Auto-normalize pref.\n- **Materials & emission.** FBX carries base/diffuse color and transforms fine, but **drops\n emission and any node-based color** — so Blender neon / \"Tron\" scenes (color stored in\n emission) import as dark bodies with black accents. Two fixes: **(a) prefer glTF/GLB when glTFast\n is installed** — glTF's PBR model carries `emissiveFactor` + `KHR_materials_emissive_strength`\n natively, so emission survives with no post-step (`bpy.ops.export_scene.gltf(filepath=out, export_format='GLB', use_active_scene=True)`);\n **(b) with FBX, run Step 5** to dump Blender's emission and reapply it. Also check the mesh for a\n `color_attributes` (vertex color) layer — the *data* survives FBX, but URP Lit won't *display* it;\n that needs a vertex-color-reading shader, not `_EmissionColor`.\n- FBX is the default because glTFast is optional in MCP for Unity. If the import errors with\n \"GLB import requires glTFast\", re-export as FBX (or install glTFast from the Dependencies tab).\n- **Format fidelity.** [references/bridge-fidelity.md](references/bridge-fidelity.md) is a tested\n matrix of what each format carries. Summary: **GLB (glTFast)** keeps textures, metallic/roughness,\n emission, transparency, and animation automatically; **FBX** drops metallic + emission, needs\n `ModelImporter.animationType = Generic` to surface transform animation, and needs material/texture\n extraction to assign an embedded texture. Both bake modifiers and carry geometry + vertex-color\n *data* (URP Lit won't *display* vertex colors). Neither carries procedural/node materials — bake\n them to image textures in Blender first.\n- **Animation doesn't auto-play.** An imported clip won't move the model until an `AnimatorController`\n drives it — the placed model has an `Animator` with a **null controller**, so it looks frozen. Build\n one with `manage_animation` (`controller_create` → add the clip as a looping state → `controller_assign`\n onto the instance) rather than hand-rolling `execute_code`. See bridge-fidelity gotcha #7.\n- **Multi-material zones survive.** A mesh split into material slots in Blender (e.g. skin/shirt/pants\n regions) imports as submeshes with one material each — base colors carry over GLB natively — so you\n can \"dress\" a model with material zones and it arrives intact.\n- Keep one model per handoff; for batches, repeat the loop with distinct names.\n- This skill never sends API keys or file bytes over the MCP bridge — Unity reads the file from disk.\n- `import_model_file` copies only the single source file; for multi-file exports (a text `.gltf` with an external `.bin`, or an `.obj` with a sibling `.mtl`/textures), zip them first and pass the `.zip` — a bare `.gltf`/`.obj` will lose its sidecars.\n","tools/UPDATE_DOCS_PROMPT.md":"# LLM Prompt for Updating Documentation\n\nCopy and paste this prompt into your LLM after you add, remove, rename or change an MCP tool or resource. Review its changes, then make sure the checks in step 5 pass.\n\n---\n\n## Prompt\n\nI've just changed MCP tools or resources in this MCP for Unity repository. Please update the documentation to match.\n\n1. **Read the current tools and resources**:\n - `Server/src/services/tools/`: tools (`@mcp_for_unity_tool`, including its `group`)\n - `Server/src/services/resources/`: resources (`@mcp_for_unity_resource`)\n - `Server/src/cli/commands/`: the Click CLI commands that mirror the tools\n\n2. **Regenerate the reference pages.** `website/docs/reference/tools/**` and `website/docs/reference/resources/index.md` are generated from the registry:\n ```bash\n cd Server && uv run python ../tools/generate_docs_reference.py\n ```\n Do not hand-edit them, except for usage examples between `` and ``, which the generator keeps.\n\n3. **Update the hand-maintained files**:\n - **manifest.json**: the `tools` array must list exactly the registered tools as `{\"name\", \"description\"}` entries; put new ones in alphabetical position. Resources are not listed. `Server/tests/test_manifest_tools.py` fails when a tool is missing, extra or listed twice, but it compares names only: when a tool's purpose changes, check its one-line description by hand.\n - **Tool groups**: if a tool adds a group or changes what a group covers, update the group's blurb in `TOOL_GROUPS` (`Server/src/services/registry/tool_registry.py`; it feeds the generated group pages, the `tool_groups` resource and `manage_tools`) and the group lists in `website/docs/guides/tool-groups.md` and `website/docs/contributing/dev-setup.md`.\n - **Tool count**: `README.md`, `docs/i18n/README-zh.md` and `website/docs/guides/tool-groups.md` state how many tools ship. Update the number if it changed.\n - **CLI docs**: the group table in `website/docs/reference/cli.md` and the \"Complete Command Reference\" table in `website/docs/guides/cli.md` must match the Click command tree (`cd Server && uv run unity-mcp --help`, then `--help` on each group).\n - **Skill**: if agents need new guidance for the change, update the skill. It has two copies, `unity-mcp-skill/` and `.claude/skills/unity-mcp-skill/`; keep both copies identical.\n\n4. **Leave the release notes alone.** `README.md` has no tool or resource lists; it links to the website catalog. Its \"Recent Updates\" block (the latest 5 releases) and `website/docs/releases.md` are generated from GitHub Releases, whose notes GitHub builds from merged PR titles. After each release, `release.yml` dispatches `.github/workflows/sync-releases.yml`, which runs `tools/sync_release_notes.py` and merges the result into `beta` through its own PR. The \"最近更新\" block in `docs/i18n/README-zh.md` is not synced; it is updated by hand at release time.\n\n5. **After updating**, run these checks:\n ```bash\n cd Server\n uv run python ../tools/generate_docs_reference.py --check\n uv run pytest tests/test_manifest_tools.py\n ```\n\nPlease show me the exact changes you're making to each file, and explain any discrepancies you find.\n\n---\n","tools/unity-versions.json":"{\n \"$comment\": \"Single source of truth for Unity versions exercised by CI and tools/check-unity-versions.* local script. Versions are pinned to specific patch releases (no floating tags) per acceptance criteria in CoplayDev/unity-mcp#1107. Every id MUST have a corresponding GameCI Docker image at unityci/editor:ubuntu--base-3 since both CI (game-ci/unity-test-runner@v4) and local --docker mode pull from there. Verify availability before bumping: https://hub.docker.com/v2/repositories/unityci/editor/tags/?name=\",\n \"$coverageGap\": \"UNITY_6000_5_OR_NEWER and UNITY_6000_6_OR_NEWER branches are NOT exercised by this matrix because GameCI has not yet published Docker images for Unity 6000.5+/6000.6+. Bump the 'rolling' row to a 6000.5+/6000.6+ patch once https://hub.docker.com/r/unityci/editor publishes one. Tracked branches in code: UnityObjectIdCompat.cs (EntityId path).\",\n \"defaultVersion\": \"6000.0.75f1\",\n \"$defaultVersionComment\": \"Unity version used when CI runs the narrow matrix (default PR feedback path). Must be one of the ids in 'versions' below. Today's pick is 6.0 LTS — the version most users target. The 'floor' role still identifies the package's minimum supported version separately.\",\n \"versions\": [\n {\n \"id\": \"2021.3.45f2\",\n \"role\": \"floor\",\n \"notes\": \"Package minimum (matches MCPForUnity/package.json 'unity' field and TestProjects/UnityMCPTests/ProjectSettings/ProjectVersion.txt). Legacy branch: all UNITY_2022_*/UNITY_6000_* flags OFF.\"\n },\n {\n \"id\": \"2022.3.62f1\",\n \"role\": \"lts\",\n \"notes\": \"Last 2022 LTS. Exercises UNITY_2022_1/2/3_OR_NEWER branches; UNITY_2023_*/UNITY_6000_* OFF. Catches FindObjectsByType-style regressions (the #1105 path).\"\n },\n {\n \"id\": \"6000.0.75f1\",\n \"role\": \"lts\",\n \"notes\": \"Unity 6.0 LTS (latest patch on GameCI). UNITY_6000_0_OR_NEWER ON (27 files), UNITY_2023_*_OR_NEWER ON, UNITY_6000_3/4/5/6 OFF.\"\n },\n {\n \"id\": \"6000.4.8f1\",\n \"role\": \"rolling\",\n \"notes\": \"Latest 6.x available on GameCI. UNITY_6000_0/1/2/3/4_OR_NEWER ON; UNITY_6000_5/6 OFF (no GameCI image yet — see $coverageGap).\"\n }\n ]\n}\n","unity-mcp-skill/references/tools-reference.md":"# Unity-MCP Tools Reference\n\nEvery built-in MCP tool, with its main actions, parameters, and usage examples. For a tool's full parameter table, open its generated page: `https://coplaydev.github.io/unity-mcp/reference/tools//` (tools with no group, such as `manage_tools`, are under `core`).\n\nEach section names the tool's group when it is not `core`. A tool outside `core` can be hidden (over HTTP, only `core` starts enabled); enable its group with `manage_tools(action=\"activate\", group=\"\")`.\n\n> **Template warning:** Examples in this file are skill templates and may be inaccurate for some Unity versions, packages, or project setups. Validate parameters and payload shapes against your active tool schema and runtime behavior.\n\n## Table of Contents\n\n- [Infrastructure Tools](#infrastructure-tools)\n- [Scene Tools](#scene-tools)\n- [GameObject Tools](#gameobject-tools)\n- [Script Tools](#script-tools)\n- [Asset Tools](#asset-tools)\n- [Material & Shader Tools](#material--shader-tools)\n- [UI Tools](#ui-tools)\n- [Editor Control Tools](#editor-control-tools)\n- [Build Tools](#build-tools)\n- [Testing Tools](#testing-tools)\n- [Search Tools](#search-tools)\n- [Custom Tools](#custom-tools)\n- [Camera Tools](#camera-tools)\n- [Graphics Tools](#graphics-tools)\n- [Package Tools](#package-tools)\n- [Physics Tools](#physics-tools)\n- [ProBuilder Tools](#probuilder-tools)\n- [Profiler Tools](#profiler-tools)\n- [Docs Tools](#docs-tools)\n- [Animation Tools](#animation-tools)\n- [VFX Tools](#vfx-tools)\n- [Scripting Extension Tools](#scripting-extension-tools)\n- [Asset Generation Tools](#asset-generation-tools)\n\n---\n\n## Project Info Resource\n\nRead `mcpforunity://project/info` to detect project capabilities before making assumptions about UI, input, or rendering setup.\n\n**Returned fields:**\n\n| Field | Type | Description |\n|-------|------|-------------|\n| `projectRoot` | string | Absolute path to project root |\n| `projectName` | string | Project folder name |\n| `unityVersion` | string | e.g. `\"2022.3.20f1\"` |\n| `platform` | string | Active build target e.g. `\"StandaloneWindows64\"` |\n| `assetsPath` | string | Absolute path to Assets folder |\n| `renderPipeline` | string | `\"BuiltIn\"`, `\"Universal\"`, `\"HighDefinition\"`, or `\"Custom\"` |\n| `activeInputHandler` | string | `\"Old\"`, `\"New\"`, or `\"Both\"` |\n| `packages.ugui` | bool | `com.unity.ugui` installed (Canvas, Image, Button, etc.) |\n| `packages.textmeshpro` | bool | `com.unity.textmeshpro` installed (TMP_Text, TMP_InputField) |\n| `packages.inputsystem` | bool | `com.unity.inputsystem` installed (InputAction, PlayerInput) |\n| `packages.uiToolkit` | bool | Always `true` for Unity 2021.3+ (UIDocument, VisualElement, UXML/USS) |\n| `packages.screenCapture` | bool | `com.unity.modules.screencapture` enabled (ScreenCapture API for screenshots) |\n\n**Key decision points:**\n\n- **UI system**: If `packages.uiToolkit` is true (always for Unity 2021+), use `manage_ui` for UI Toolkit workflows (UXML/USS). If `packages.ugui` is true, use Canvas + uGUI components via `batch_execute`. UI Toolkit is preferred for new UI — it uses a frontend-like workflow (UXML for structure, USS for styling).\n- **Text**: If `packages.textmeshpro` is true, use `TextMeshProUGUI` instead of legacy `Text`.\n- **Input**: Use `activeInputHandler` to decide EventSystem module — `StandaloneInputModule` (Old) vs `InputSystemUIInputModule` (New). See [workflows.md — Input System](workflows.md#input-system-old-vs-new).\n- **Shaders**: Use `renderPipeline` to pick correct shader names — `Standard` (BuiltIn) vs `Universal Render Pipeline/Lit` (URP) vs `HDRP/Lit` (HDRP).\n\n---\n\n## Infrastructure Tools\n\n### batch_execute\n\nExecute multiple MCP commands in a single batch (10-100x faster).\n\n```python\nbatch_execute(\n commands=[ # list[dict], required, max 25\n {\"tool\": \"tool_name\", \"params\": {...}},\n ...\n ],\n parallel=False, # bool, optional - advisory only (Unity may still run sequentially)\n fail_fast=False, # bool, optional - stop on first failure\n max_parallelism=None # int, optional - max parallel workers\n)\n```\n\n`batch_execute` is not transactional: earlier commands are not rolled back if a later command fails.\n\n### set_active_instance\n\nRoute commands to a specific Unity instance (multi-instance workflows).\n\n```python\nset_active_instance(\n instance=\"ProjectName@abc123\" # str, required - Name@hash or hash prefix\n)\n```\n\n### refresh_unity\n\nRefresh asset database and trigger script compilation.\n\n```python\nrefresh_unity(\n mode=\"if_dirty\", # \"if_dirty\" | \"force\"\n scope=\"all\", # \"assets\" | \"scripts\" | \"all\"\n compile=\"none\", # \"none\" | \"request\"\n wait_for_ready=True # bool - wait until editor ready\n)\n```\n\n### manage_tools\n\nShow, enable, or hide tool groups for the current session. Always visible (no group).\n\n```python\nmanage_tools(action=\"list_groups\") # every group, whether it is on, and its tools\nmanage_tools(action=\"activate\", group=\"animation\") # \"deactivate\" hides a group again\nmanage_tools(action=\"sync\") # re-read the tool toggles in the Unity editor\nmanage_tools(action=\"reset\") # back to the defaults\n```\n\nGroups: `core`, `animation`, `asset_gen`, `docs`, `probuilder`, `profiling`, `scripting_ext`, `testing`, `ui`, `vfx`. The `mcpforunity://tool-groups` resource lists the same catalog read-only. [Full parameters](https://coplaydev.github.io/unity-mcp/reference/tools/core/manage_tools)\n\n### debug_request_context\n\nDiagnostics: returns the request's `client_id`, `session_id` and meta, the session's active Unity instance, and the server version. No parameters; always visible (no group).\n\n```python\ndebug_request_context()\n```\n\n[Full parameters](https://coplaydev.github.io/unity-mcp/reference/tools/core/debug_request_context)\n\n---\n\n## Scene Tools\n\n### manage_scene\n\nScene CRUD operations, hierarchy queries, multi-scene editing, validation, and scene view control. Screenshots are `manage_camera` actions (see [Camera Tools](#camera-tools)); build-settings scenes are `manage_build(action=\"scenes\")`.\n\n```python\n# Get hierarchy (paginated)\nmanage_scene(\n action=\"get_hierarchy\",\n page_size=50, # int, default 50, max 500\n cursor=0, # int, pagination cursor\n parent=None, # str|int, optional - filter by parent\n include_transform=False # bool - include local transforms\n)\n\n# Frame scene view on target\nmanage_scene(\n action=\"scene_view_frame\",\n scene_view_target=\"Player\" # str|int - GO name, path, or instance ID to frame\n)\n\n# Other actions\nmanage_scene(action=\"get_active\") # Current scene info\nmanage_scene(action=\"get_build_settings\") # Build settings\nmanage_scene(action=\"create\", name=\"NewScene\", path=\"Assets/Scenes/\")\nmanage_scene(action=\"load\", path=\"Assets/Scenes/Main.unity\")\nmanage_scene(action=\"save\")\n\n# Scene templates: \"empty\" (no objects), \"default\", \"3d_basic\", \"2d_basic\"\nmanage_scene(action=\"create\", name=\"Level1\", path=\"Assets/Scenes/\", template=\"3d_basic\")\n\n# Multi-scene editing\nmanage_scene(action=\"load\", path=\"Assets/Scenes/Level2.unity\", additive=True) # keep current scene\nmanage_scene(action=\"get_loaded_scenes\")\nmanage_scene(action=\"set_active_scene\", scene_name=\"Level2\")\nmanage_scene(action=\"move_to_scene\", target=\"Player\", scene_name=\"Level2\") # moves a root GameObject\nmanage_scene(action=\"close_scene\", scene_name=\"Level2\", remove_scene=True) # remove_scene=False only unloads\n\n# Validation: missing scripts, broken prefabs\nmanage_scene(action=\"validate\")\nmanage_scene(action=\"validate\", auto_repair=True) # also removes missing scripts (undoable)\n```\n\n### find_gameobjects\n\nSearch for GameObjects (returns instance IDs only).\n\n```python\nfind_gameobjects(\n search_term=\"Player\", # str, required\n search_method=\"by_name\", # \"by_name\"|\"by_tag\"|\"by_layer\"|\"by_component\"|\"by_path\"|\"by_id\"\n include_inactive=False, # bool|str\n page_size=50, # int, default 50, max 500\n cursor=0 # int, pagination cursor\n)\n# Returns: {\"ids\": [12345, 67890], \"next_cursor\": 50, ...}\n```\n\n---\n\n## GameObject Tools\n\n### manage_gameobject\n\nCreate, modify, delete, duplicate GameObjects.\n\n```python\n# Create\nmanage_gameobject(\n action=\"create\",\n name=\"MyCube\", # str, required\n primitive_type=\"Cube\", # \"Cube\"|\"Sphere\"|\"Capsule\"|\"Cylinder\"|\"Plane\"|\"Quad\"\n position=[0, 1, 0], # list[float] or JSON string \"[0,1,0]\"\n rotation=[0, 45, 0], # euler angles\n scale=[1, 1, 1],\n components_to_add=[\"Rigidbody\", \"BoxCollider\"],\n save_as_prefab=False,\n prefab_path=\"Assets/Prefabs/MyCube.prefab\"\n)\n\n# Prefab instantiation — place a prefab instance in the scene\nmanage_gameobject(\n action=\"create\",\n name=\"Enemy_1\",\n prefab_path=\"Assets/Prefabs/Enemy.prefab\",\n position=[5, 0, 3],\n parent=\"Enemies\" # optional parent GameObject\n)\n# Smart lookup — just the prefab name works too:\nmanage_gameobject(action=\"create\", name=\"Enemy_2\", prefab_path=\"Enemy\", position=[10, 0, 3])\n\n# Modify\nmanage_gameobject(\n action=\"modify\",\n target=\"Player\", # name, path, or instance ID\n search_method=\"by_name\", # how to find target\n position=[10, 0, 0],\n rotation=[0, 90, 0],\n scale=[2, 2, 2],\n set_active=True,\n layer=\"Player\",\n components_to_add=[\"AudioSource\"],\n components_to_remove=[\"OldComponent\"],\n component_properties={ # nested dict for property setting\n \"Rigidbody\": {\n \"mass\": 10.0,\n \"useGravity\": True\n }\n }\n)\n\n# Delete\nmanage_gameobject(action=\"delete\", target=\"OldObject\")\n\n# Duplicate\nmanage_gameobject(\n action=\"duplicate\",\n target=\"Player\",\n new_name=\"Player2\",\n offset=[5, 0, 0] # position offset from original\n)\n\n# Move relative\nmanage_gameobject(\n action=\"move_relative\",\n target=\"Player\",\n reference_object=\"Enemy\", # optional reference\n direction=\"left\", # \"left\"|\"right\"|\"up\"|\"down\"|\"forward\"|\"back\"\n distance=5.0,\n world_space=True\n)\n\n# Look at target (rotates GO to face a point or another GO)\nmanage_gameobject(\n action=\"look_at\",\n target=\"MainCamera\", # the GO to rotate\n look_at_target=\"Player\", # str (GO name/path) or list[float] world position\n look_at_up=[0, 1, 0] # optional up vector, default [0,1,0]\n)\n```\n\n### manage_components\n\nAdd, remove, or set properties on components.\n\n```python\n# Add component\nmanage_components(\n action=\"add\",\n target=12345, # instance ID (preferred) or name\n component_type=\"Rigidbody\",\n search_method=\"by_id\"\n)\n\n# Remove component\nmanage_components(\n action=\"remove\",\n target=\"Player\",\n component_type=\"OldScript\"\n)\n\n# Set single property\nmanage_components(\n action=\"set_property\",\n target=12345,\n component_type=\"Rigidbody\",\n property=\"mass\",\n value=5.0\n)\n\n# Set multiple properties\nmanage_components(\n action=\"set_property\",\n target=12345,\n component_type=\"Transform\",\n properties={\n \"position\": [1, 2, 3],\n \"localScale\": [2, 2, 2]\n }\n)\n\n# Set object reference property (reference another GameObject by name)\nmanage_components(\n action=\"set_property\",\n target=\"GameManager\",\n component_type=\"GameManagerScript\",\n property=\"targetObjects\",\n value=[{\"name\": \"Flower_1\"}, {\"name\": \"Flower_2\"}, {\"name\": \"Bee_1\"}]\n)\n\n# Object reference formats supported:\n# - {\"name\": \"ObjectName\"} → Find GameObject in scene by name\n# - {\"instanceID\": 12345} → Direct instance ID reference\n# - {\"guid\": \"abc123...\"} → Asset GUID reference\n# - {\"path\": \"Assets/...\"} → Asset path reference\n# - \"Assets/Prefabs/My.prefab\" → String shorthand for asset paths\n# - \"ObjectName\" → String shorthand for scene name lookup\n# - 12345 → Integer shorthand for instanceID\n# - {\"guid\": \"...\", \"spriteName\": \"Hero_0\"} or {\"guid\": \"...\", \"fileID\": 12345}\n# → Sprite sub-asset of a sliced sheet (single-sprite textures resolve from guid/path alone)\n```\n\n---\n\n## Script Tools\n\n### create_script\n\nCreate a new C# script.\n\n```python\ncreate_script(\n path=\"Assets/Scripts/MyScript.cs\", # str, required\n contents='''using UnityEngine;\n\npublic class MyScript : MonoBehaviour\n{\n void Start() { }\n void Update() { }\n}''',\n script_type=\"MonoBehaviour\", # optional hint\n namespace=\"MyGame\" # optional namespace\n)\n```\n\n### script_apply_edits\n\nApply structured edits to C# scripts (safer than raw text edits).\n\n```python\nscript_apply_edits(\n name=\"MyScript\", # script name (no .cs)\n path=\"Assets/Scripts\", # folder path\n edits=[\n # Replace entire method\n {\n \"op\": \"replace_method\",\n \"methodName\": \"Update\",\n \"replacement\": \"void Update() { transform.Rotate(Vector3.up); }\"\n },\n # Insert new method\n {\n \"op\": \"insert_method\",\n \"afterMethod\": \"Start\",\n \"code\": \"void OnEnable() { Debug.Log(\\\"Enabled\\\"); }\"\n },\n # Delete method\n {\n \"op\": \"delete_method\",\n \"methodName\": \"OldMethod\"\n },\n # Anchor-based insert\n {\n \"op\": \"anchor_insert\",\n \"anchor\": \"void Start()\",\n \"position\": \"before\", # \"before\" | \"after\"\n \"text\": \"// Called before Start\\n\"\n },\n # Regex replace\n {\n \"op\": \"regex_replace\",\n \"pattern\": \"Debug\\\\.Log\\\\(\",\n \"text\": \"Debug.LogWarning(\"\n },\n # Prepend/append to file\n {\"op\": \"prepend\", \"text\": \"// File header\\n\"},\n {\"op\": \"append\", \"text\": \"\\n// File footer\"}\n ]\n)\n```\n\n### apply_text_edits\n\nApply precise character-position edits (1-indexed lines/columns).\n\n```python\napply_text_edits(\n uri=\"mcpforunity://path/Assets/Scripts/MyScript.cs\",\n edits=[\n {\n \"startLine\": 10,\n \"startCol\": 5,\n \"endLine\": 10,\n \"endCol\": 20,\n \"newText\": \"replacement text\"\n }\n ],\n precondition_sha256=\"abc123...\", # optional, prevents stale edits\n strict=True # optional, stricter validation\n)\n```\n\n### validate_script\n\nCheck script for syntax/semantic errors.\n\n```python\nvalidate_script(\n uri=\"mcpforunity://path/Assets/Scripts/MyScript.cs\",\n level=\"standard\", # \"basic\" | \"standard\"\n include_diagnostics=True # include full error details\n)\n```\n\n### get_sha\n\nGet file hash without content (for preconditions).\n\n```python\nget_sha(uri=\"mcpforunity://path/Assets/Scripts/MyScript.cs\")\n# Returns: {\"sha256\": \"...\", \"lengthBytes\": 1234}\n```\n\n### delete_script\n\nDelete a script file.\n\n```python\ndelete_script(uri=\"mcpforunity://path/Assets/Scripts/OldScript.cs\")\n```\n\n### manage_script\n\nLegacy whole-file router with three actions: `create`, `read`, `delete`. `name` is the class name without `.cs`; `path` is its folder under `Assets/`. There is no update action: edit with `script_apply_edits` or `apply_text_edits`.\n\n```python\nmanage_script(action=\"read\", name=\"PlayerController\", path=\"Assets/Scripts\") # returns the file contents\n```\n\n[Full parameters](https://coplaydev.github.io/unity-mcp/reference/tools/core/manage_script)\n\n### manage_script_capabilities\n\nLists the edit ops `script_apply_edits` supports (structured and text), the max edit payload size, and the active guards. No parameters; always visible (no group).\n\n```python\nmanage_script_capabilities()\n```\n\n[Full parameters](https://coplaydev.github.io/unity-mcp/reference/tools/core/manage_script_capabilities)\n\n---\n\n## Asset Tools\n\n### manage_asset\n\nAsset operations: search, import, create, modify, delete.\n\n```python\n# Search assets (paginated)\nmanage_asset(\n action=\"search\",\n path=\"Assets\", # search scope\n search_pattern=\"*.prefab\", # glob or \"t:MonoScript\" filter\n filter_type=\"Prefab\", # optional type filter\n page_size=25, # keep small to avoid large payloads\n page_number=1, # 1-based\n generate_preview=False # avoid base64 bloat\n)\n\n# Get asset info\nmanage_asset(action=\"get_info\", path=\"Assets/Prefabs/Player.prefab\")\n\n# Create asset\nmanage_asset(\n action=\"create\",\n path=\"Assets/Materials/NewMaterial.mat\",\n asset_type=\"Material\",\n properties={\"color\": [1, 0, 0, 1]}\n)\n\n# Duplicate/move/rename\nmanage_asset(action=\"duplicate\", path=\"Assets/A.prefab\", destination=\"Assets/B.prefab\")\nmanage_asset(action=\"move\", path=\"Assets/A.prefab\", destination=\"Assets/Prefabs/A.prefab\")\nmanage_asset(action=\"rename\", path=\"Assets/A.prefab\", destination=\"Assets/B.prefab\")\n\n# Create folder\nmanage_asset(action=\"create_folder\", path=\"Assets/NewFolder\")\n\n# Delete\nmanage_asset(action=\"delete\", path=\"Assets/OldAsset.asset\")\n```\n\n### manage_prefabs\n\nPrefab assets: headless edits with `modify_contents`, or interactive editing in a prefab stage.\n\n```python\n# Get prefab info\nmanage_prefabs(action=\"get_info\", prefab_path=\"Assets/Prefabs/Player.prefab\")\n\n# Get prefab hierarchy\nmanage_prefabs(action=\"get_hierarchy\", prefab_path=\"Assets/Prefabs/Player.prefab\")\n\n# Create prefab from scene GameObject\nmanage_prefabs(\n action=\"create_from_gameobject\",\n target=\"Player\", # GameObject in scene\n prefab_path=\"Assets/Prefabs/Player.prefab\",\n allow_overwrite=False\n)\n\n# Modify prefab contents (headless)\nmanage_prefabs(\n action=\"modify_contents\",\n prefab_path=\"Assets/Prefabs/Player.prefab\",\n target=\"ChildObject\", # object within prefab\n position=[0, 1, 0],\n components_to_add=[\"AudioSource\"]\n)\n\n# Delete child GameObjects from prefab\nmanage_prefabs(\n action=\"modify_contents\",\n prefab_path=\"Assets/Prefabs/Player.prefab\",\n delete_child=[\"OldChild\", \"Turret/Barrel\"] # single string or list\n)\n\n# Create child GameObject in prefab\nmanage_prefabs(\n action=\"modify_contents\",\n prefab_path=\"Assets/Prefabs/Player.prefab\",\n create_child={\"name\": \"SpawnPoint\", \"primitive_type\": \"Sphere\", \"position\": [0, 2, 0]}\n)\n# A list creates several children in one save; \"source_prefab_path\" instead of\n# \"primitive_type\" nests a prefab instance: {\"name\": \"Gun\", \"source_prefab_path\": \"Assets/Prefabs/Gun.prefab\"}\n\n# Set component properties on prefab contents\nmanage_prefabs(\n action=\"modify_contents\",\n prefab_path=\"Assets/Prefabs/Player.prefab\",\n target=\"ChildObject\",\n component_properties={\"Rigidbody\": {\"mass\": 5.0}, \"MyScript\": {\"health\": 100}}\n)\n\n# Interactive: open a prefab stage, edit with manage_gameobject/manage_components, save, close\nmanage_prefabs(action=\"open_prefab_stage\", prefab_path=\"Assets/Prefabs/Enemy.prefab\")\nmanage_prefabs(action=\"save_prefab_stage\")\nmanage_prefabs(action=\"close_prefab_stage\") # back to the main scene\n```\n\n---\n\n## Material & Shader Tools\n\n### manage_material\n\nCreate and modify materials.\n\n```python\n# Create material\nmanage_material(\n action=\"create\",\n material_path=\"Assets/Materials/Red.mat\",\n shader=\"Standard\",\n properties={\"_Color\": [1, 0, 0, 1]}\n)\n\n# Get material info\nmanage_material(action=\"get_material_info\", material_path=\"Assets/Materials/Red.mat\")\n\n# Set shader property\nmanage_material(\n action=\"set_material_shader_property\",\n material_path=\"Assets/Materials/Red.mat\",\n property=\"_Metallic\",\n value=0.8\n)\n\n# Set color\nmanage_material(\n action=\"set_material_color\",\n material_path=\"Assets/Materials/Red.mat\",\n property=\"_BaseColor\",\n color=[0, 1, 0, 1] # RGBA\n)\n\n# Assign to renderer\nmanage_material(\n action=\"assign_material_to_renderer\",\n target=\"MyCube\",\n material_path=\"Assets/Materials/Red.mat\",\n slot=0 # material slot index\n)\n\n# Set renderer color directly\nmanage_material(\n action=\"set_renderer_color\",\n target=\"MyCube\",\n color=[1, 0, 0, 1],\n mode=\"create_unique\" # Creates a unique .mat asset per object (persistent)\n # Other modes: \"property_block\" (default, not persistent),\n # \"shared\" (mutates shared material — avoid for primitives),\n # \"instance\" (runtime only, not persistent)\n)\n```\n\n### manage_texture\n\nCreate procedural textures. Group: `vfx`.\n\n```python\nmanage_texture(\n action=\"create\",\n path=\"Assets/Textures/Checker.png\",\n width=64,\n height=64,\n fill_color=[255, 255, 255, 255] # or [1.0, 1.0, 1.0, 1.0]\n)\n\n# Apply pattern\nmanage_texture(\n action=\"apply_pattern\",\n path=\"Assets/Textures/Checker.png\",\n pattern=\"checkerboard\", # \"checkerboard\"|\"stripes\"|\"dots\"|\"grid\"|\"brick\"\n palette=[[0,0,0,255], [255,255,255,255]],\n pattern_size=8\n)\n\n# Apply gradient\nmanage_texture(\n action=\"apply_gradient\",\n path=\"Assets/Textures/Gradient.png\",\n gradient_type=\"linear\", # \"linear\"|\"radial\"\n gradient_angle=45,\n palette=[[255,0,0,255], [0,0,255,255]]\n)\n```\n\n### manage_shader\n\nCreate, read, update, or delete `.shader` files. Group: `vfx`. `name` is the file name without `.shader`; `path` is its folder under `Assets/`. To use the shader, pass the name declared in its `Shader \"...\"` line to `manage_material`.\n\n```python\nmanage_shader(action=\"create\", name=\"UnlitTint\", path=\"Assets/Shaders\",\n contents='Shader \"Custom/UnlitTint\" { ... }')\n```\n\n[Full parameters](https://coplaydev.github.io/unity-mcp/reference/tools/vfx/manage_shader)\n\n---\n\n## UI Tools\n\n### manage_ui\n\nManage Unity UI Toolkit elements: UXML documents, USS stylesheets, UIDocument components, and visual tree inspection. Group: `ui`.\n\n```python\n# Create a UXML file\nmanage_ui(\n action=\"create\",\n path=\"Assets/UI/MainMenu.uxml\",\n contents=''\n)\n\n# Create a USS stylesheet\nmanage_ui(\n action=\"create\",\n path=\"Assets/UI/Styles.uss\",\n contents=\".title { font-size: 32px; color: white; }\"\n)\n\n# Read a UXML/USS file\nmanage_ui(\n action=\"read\",\n path=\"Assets/UI/MainMenu.uxml\"\n)\n# Returns: {\"success\": true, \"data\": {\"contents\": \"...\", \"path\": \"...\"}}\n\n# Update an existing file\nmanage_ui(\n action=\"update\",\n path=\"Assets/UI/Styles.uss\",\n contents=\".title { font-size: 48px; color: yellow; -unity-font-style: bold; }\"\n)\n\n# Attach UIDocument to a GameObject\nmanage_ui(\n action=\"attach_ui_document\",\n target=\"UICanvas\", # GameObject name or path\n source_asset=\"Assets/UI/MainMenu.uxml\",\n panel_settings=\"Assets/UI/Panel.asset\", # optional, auto-creates if omitted\n sort_order=0 # optional, default 0\n)\n\n# Create PanelSettings asset\nmanage_ui(\n action=\"create_panel_settings\",\n path=\"Assets/UI/Panel.asset\",\n scale_mode=\"ScaleWithScreenSize\", # optional: \"ConstantPixelSize\"|\"ConstantPhysicalSize\"|\"ScaleWithScreenSize\"\n reference_resolution={\"width\": 1920, \"height\": 1080} # optional, for ScaleWithScreenSize\n)\n\n# Inspect the visual tree of a UIDocument\nmanage_ui(\n action=\"get_visual_tree\",\n target=\"UICanvas\", # GameObject with UIDocument\n max_depth=10 # optional, default 10\n)\n# Returns: hierarchy of VisualElements with type, name, classes, styles, text, children\n```\n\n**UI Toolkit workflow:**\n\n1. Create UXML (structure, like HTML) and USS (styling, like CSS) files\n2. Create a PanelSettings asset (or let `attach_ui_document` auto-create one)\n3. Create an empty GameObject and attach UIDocument with the UXML source\n4. Use `get_visual_tree` to inspect the result\n\n**Important:** Always use `` (with the `ui:` namespace prefix) in UXML files, not bare `