ErrLookup › CoplayDev/unity-mcp
CoplayDev/unity-mcp
Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity. · C# · 853 source files
Analyzed at c21bf496bc on 2026-08-13. 209 documented errors.
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| Cherry Studio uses UI-based configuration. Please use the Ma | exception | error | configuration, client-config, cherry-studio, design-by-contract |
| OpenClaw config contains non-JSON content and cannot be safe | exception | error | configuration, openclaw, json, data-integrity, file-io |
| uvx not found. Install uv/uvx or set the override in Advance | exception | error | configuration, openclaw, uvx, stdio, dependency |
| uvx not found. Install uv/uvx or set the override in Advance | exception | error | configuration, opencode, uvx, stdio, dependency |
| uvx not found. Install uv/uvx or set the override in Advance | exception | error | configuration, uvx, dependency, base-class, shared |
| {result} | exception | error | configuration, json-config, uvx, config-lock, shared |
| Failed to unregister: {ex.Message} | exception | error | configuration, json-config, unregister, file-io, shared |
| Claude CLI not found. Please install Claude Code first. | exception | error | configuration, claude-cli, dependency, registration, thread-safe |
| Failed to register with Claude Code: {stderr} {stdout} | exception | error | configuration, claude-cli, subprocess, registration, thread-safe |
| No detector available for current platform: {RuntimeInformat | exception | critical | platform, dependency, unsupported-os, runtime |
| Captured Scene view viewport is empty. | exception | error | screenshot, scene-view, viewport, headless, editor |
| Failed to resolve Scene view viewport rect. | exception | error | screenshot, scene-view, viewport, initialization, editor |
| Active Scene View has no camera to derive viewport size from | exception | error | screenshot, scene-view, camera, initialization, editor |
| Failed to resolve Scene view host view. | exception | error | screenshot, scene-view, hostview, reflection, internal-api, editor |
| {hostView.GetType().FullName}.GrabPixels(RenderTexture, Rect | exception | critical | screenshot, reflection, internal-api, unity-version, forward-compat, breaking-change |
| Could not generate a unique screenshot filename for '{fullPa | exception | warning | screenshot, filesystem, unity-editor, io |
| Color array must have 3 or 4 elements. | exception | error | material, color, json, validation, parsing |
| Failed to write config file '{path}': {ex.Message} | exception | error | config, filesystem, io, atomic-write |
| Port must be positive. | exception | error | port, network, validation, argument |
| Port {port} is already in use. | exception | error | port, network, concurrency, validation |
| No available ports found in range {DefaultPort}-{DefaultPort | exception | error | port, network, resource-exhaustion |
| CredWrite failed (Win32 {GetLastWin32Error}) | exception | error | security, credentials, windows, pinvoke, secrets |
| uid required | validation | error | assetgen, marketplace, validation, argument |
| provider returned a disallowed file type '.{ext}' | exception | error | assetgen, security, file-type, validation, allowlist |
| zipPath required | validation | error | assetgen, zip, validation, argument |
| Unsafe zip entry rejected: {name} | exception | critical | assetgen, zip, security, path-traversal |
| Unsafe zip entry escapes destination: {name} | exception | critical | assetgen, zip, security, path-traversal |
| Unknown model provider '{id}'. | validation | error | assetgen, provider, validation |
| Unknown image provider '{id}'. | validation | error | assetgen, provider, validation |
| Unknown audio provider '{id}'. | validation | error | assetgen, provider, validation, audio |
| Unknown marketplace provider '{id}'. | validation | error | assetgen, provider, validation, marketplace |
| fal submit returned no request_id: {truncated_response} | exception | error | assetgen, fal, network, api, image |
| fal {phase} failed (status={res?.Status}): {detail} | exception | error | assetgen, fal, network, api, http, image |
| fal submit returned no request_id: {truncated_response} | exception | error | assetgen, fal, network, api, audio |
| fal {phase} failed (status={res?.Status}): {detail} | exception | error | assetgen, fal, network, api, http, audio |
| image_path must point to a file under the project's Assets f | validation | error | path-validation, asset-gen, security, image-input, path-confinement |
| Unsupported image type '{ext}' for image input. Use .png, .j | validation | error | file-format, image-input, asset-gen, validation |
| OpenRouter request failed (status={res?.Status}): {detail} | exception | error | openrouter, http-error, image-generation, asset-gen, network |
| {context}: refusing to send credentials to an unexpected hos | exception | error | security, ssrf, credential-leak, http, asset-gen, fail-fast |
| Sketchfab download returned no gltf url for '{uid}': {trunca | exception | error | sketchfab, api-contract, asset-gen, marketplace, permissions |
| Sketchfab {phase} failed (status={res?.Status}): {truncated_ | exception | error | sketchfab, http-error, asset-gen, marketplace, network |
| Sketchfab {phase} failed (status={res?.Status}): {detail} | exception | error | sketchfab, http-error, asset-gen, marketplace, permissions, network |
| Source path cannot be empty. | validation | error | package-deployment, validation, path |
| Selected folder does not exist. | exception | error | package-deployment, validation, path, filesystem |
| Folder must contain Editor and Runtime subfolders. | exception | error | package-deployment, validation, folder-structure |
| The selected uvx executable does not exist | exception | error | path-resolver, uvx, validation, config, filesystem |
| The selected Claude CLI executable does not exist | exception | error | path-resolver, claude-cli, validation, config, filesystem |
| A Unity test run is already in progress. | exception | error | test-runner, concurrency, state, lock |
| A Unity test run is already in progress. | exception | error | test-runner, concurrency, state, play-mode |
| Cannot start a test run while the Editor is in or entering P | exception | error | test-runner, play-mode, state, unity-editor |
| Invalid MCP base URL: {baseUrl} | exception | error | websocket, config, uri, transport |
| Failed to download {packageId}: {request.error} | exception | error | network, nuget, roslyn, install |
| Repo URL is not a recognized GitHub repository URL: {repoUrl | exception | error | github, config, url, validation |
| Failed to parse GitHub directory tree response. | exception | error | github, json, api, proxy |
| GitHub returned a truncated directory tree (incomplete snaps | exception | error | github, api, safety, limits |
| Remote directory not found: {normalizedSubdir} | exception | error | github, config, branch, missing |
| Failed to resolve branch head commit SHA for: {branch} | exception | error | github, branch, api, parse |
| GitHub request failed: {(int)response.StatusCode} {response. | exception | error | github, api, http, rate-limit |
| File download failed: {(int)response.StatusCode} {response.R | exception | error | github, download, http |
| Missing synced file: {remoteEntry.Key} | exception | error | filesystem, validation, windows |
| File hash mismatch: {remoteEntry.Key} ({ShortHash(localBlobS | exception | error | validation, hash, line-endings |
| Install Dir contains unmanaged files. Please choose an empty | validation | error | filesystem, safety, config |
| Install Dir is empty. | validation | error | config, validation, path |
| Install Dir contains invalid path characters: {installDir} | validation | error | config, validation, path |
| Install Dir is invalid and cannot be resolved: {installDir} | validation | error | config, path, filesystem |
| Install Dir resolved to an empty path. | validation | error | config, path, edge-case |
| Failed to parse 'properties' JSON string. Raw value: {token} | validation | error | json, animation, validation |
| 'output_folder' must resolve under the project's Assets fold | validation | error | assetgen, path, validation |
| Unknown or unsupported command type: {commandName} | validation | error | registry, tools, config |
| Failed to parse float at index {i}: '{arr[i]}' | validation | error | json, validation, scene |
| Parameter 'encodedContents' must be valid base64 when 'conte | validation | error | base64, encoding, ui-toolkit, validation, manage-ui |
| Unknown layer name: '{layerMaskStr}'. Use a valid layer name | validation | error | physics, layer-mask, validation, tag-manager |
| Target GameObject not found. | exception | error | probuilder, gameobject, not-found, resolution, reflection |
| GameObject '{go.name}' does not have a ProBuilderMesh compon | validation | error | probuilder, component, missing-component, mesh, reflection |
| Could not read faces from ProBuilderMesh. | exception | error | probuilder, faces, reflection, null-reference, version-mismatch |
| Face index {indices[i]} out of range (0-{facesList.Count - 1 | validation | error | probuilder, faces, index-out-of-range, validation, bounds-check |
| Edge index {idx} out of range (0-{allEdges.Count - 1}). | validation | error | probuilder, edges, index-out-of-range, validation, bounds-check |
| edgeIndices or edges parameter is required. | validation | error | probuilder, edges, missing-parameter, validation |
| Unknown shape type '{shapeTypeStr}'. Valid types: {validType | validation | error | probuilder, shape-type, enum, validation, create |
| Could not find internal type UnityEditor.LogEntry during Get | exception | critical | console, reflection, internal-api, unity-version, read-console |
| Failed to parse 'properties' JSON string. Raw value: {token} | exception | error | vfx, json, parse-error, validation, manage-vfx |
| ScreenCapture.CaptureScreenshotAsTexture returned null and n | exception | error | screenshot, capture, camera, rendering, runtime |
| Screenshot folder '{folderOverride}' resolves outside the Un | validation | error | screenshot, path-traversal, security, validation, filesystem |
| Cannot deserialize Vector3 from {token.Type}: '{token}' | exception | error | serialization, vector3, json, deserialization, type-converter |
| Cannot deserialize Vector2 from {token.Type}: '{token}' | exception | error | serialization, vector2, json, deserialization, type-converter |
| Cannot deserialize Quaternion from {token.Type}: '{token}' | exception | error | serialization, quaternion, json, deserialization, type-converter, rotation |
| Cannot deserialize Vector4 from {token.Type}: '{token}' | exception | error | serialization, vector4, json, deserialization, type-converter |
| Expected JSON object or null when deserializing Matrix4x4, g | exception | error | serialization, matrix4x4, json, deserialization, type-converter |
| Export paths array cannot be empty | validation | error | unity, asset-store-tools, validation, packaging, argument-validation |
| Package Exporting failed: provided export paths are empty or | validation | error | unity, asset-store-tools, validation, packaging, asset-database |
| Width should be larger than 0 | validation | error | unity, asset-store-tools, preview, validation, screenshot |
| Height should be larger than 0 | validation | error | unity, asset-store-tools, preview, validation, screenshot |
| Depth should be larger than 0 | validation | error | unity, asset-store-tools, preview, validation, render-texture |
| Native width should be larger than 0 | validation | error | unity, asset-store-tools, preview, validation, render-texture |
| Native height should be larger than 0 | validation | error | unity, asset-store-tools, preview, validation, render-texture |
| Width must be larger than 0 | validation | error | unity, asset-store-tools, preview, validation, audio |
| Height must be larger than 0 | validation | error | unity, asset-store-tools, preview, validation, audio |
| Could not load audio data | exception | error | unity, asset-store-tools, preview, audio, asset-loading |
| Could not retrieve audio samples | exception | error | unity, asset-store-tools, preview, audio, asset-loading |
| Max width should be larger than 0 | validation | error | unity, asset-store-tools, preview, validation, texture |
| Max height should be larger than 0 | validation | error | unity, asset-store-tools, preview, validation, texture |
| Input path cannot be null | validation | error | unity, asset-store-tools, preview, validation, asset-database |
| Input path '{inputPath}' is not a valid ADB folder | validation | error | unity, asset-store-tools, preview, validation, asset-database, path |
| Output path cannot be null | validation | error | unity, asset-store-tools, preview, validation, path |
| Could not retrieve guid for object {obj} | exception | error | unity, asset-store-tools, preview, asset-database, guid |
| Screenshotter cannot be null | validation | error | unity, asset-store-tools, preview, validation, screenshot |
| Preview generation was aborted due to a change of the scene | exception | error | unity, asset-store-tools, preview, scene, cancellation, concurrency |
| Width should be larger than 0 | validation | error | unity, asset-store-tools, preview-generation, validation, argument-exception |
| Height should be larger than 0 | validation | error | unity, asset-store-tools, preview-generation, validation, argument-exception |
| Depth should be larger than 0 | validation | error | unity, asset-store-tools, preview-generation, validation, argument-exception |
| Native width should be larger than 0 | validation | error | unity, asset-store-tools, preview-generation, validation, argument-exception |
| Native height should be larger than 0 | validation | error | unity, asset-store-tools, preview-generation, validation, argument-exception |
| Chunk size must be larger than 0 | validation | error | unity, asset-store-tools, preview-generation, validation, argument-exception |
| Preview loading timed out. | exception | error | unity, asset-store-tools, preview-generation, assetpreview, timeout, runtime |
| Input paths cannot be null | validation | error | unity, asset-store-tools, preview-generation, validation, argument-exception |
| Output path cannot be null | validation | error | unity, asset-store-tools, preview-generation, validation, argument-exception |
| width and height must be positive | validation | error | python, cli, texture, validation, value-error |
| Invalid hex color: {value} | validation | error | python, cli, texture, color, validation, value-error |
| {context} is required | validation | error | python, cli, texture, color, validation, value-error |
| {context} dict values must be numeric, got {value} | validation | error | python, cli, texture, color, validation, value-error |
| {context} values must be numeric, got {value} | validation | error | python, cli, texture, color, validation, value-error |
| {context} must have 3 or 4 components, got {len(value)} | validation | error | python, cli, texture, color, validation, value-error |
| {context} must be a list or hex string | validation | error | python, cli, texture, color, validation, value-error, type-error |
| {context} must be a list of colors | validation | error | python, cli, texture, palette, validation, value-error |
| {context} must have {expected_count} entries, got {len(value | validation | error | python, cli, texture, pixels, validation, value-error |
| {context} must be a list or base64 string | validation | error | python, cli, texture, pixels, validation, value-error, type-error |
| set-pixels is required | validation | error | cli, validation, texture, input-validation |
| set-pixels must be a JSON object | validation | error | cli, validation, texture, input-validation, json |
| Path does not correspond to a valid package | validation | error | csharp, unity, asset-store, package, validation |
| Source directory not found: {dir.FullName} | exception | error | csharp, unity, filesystem, asset-store, validation |
| No validation paths were set | validation | error | csharp, unity, asset-store, validator, validation |
| The following directories do not exist: | validation | error | csharp, unity, asset-store, validator, filesystem, validation |
| Package was not found | validation | error | csharp, unity, asset-store, validator, validation |
| Could not find external project's validation results | exception | error | csharp, unity, asset-store, validator, caching |
| set-pixels requires width and height when pixels are provide | validation | error | cli, validation, texture, input-validation |
| set-pixels width and height must be positive | validation | error | cli, validation, texture, input-validation |
| set-pixels requires 'color' or 'pixels' | validation | error | cli, validation, texture, input-validation |
| {name} must be a boolean | validation | error | cli, validation, texture, input-validation, import-settings |
| import_settings must be a JSON object | validation | error | cli, validation, texture, input-validation, import-settings, json |
| Invalid UNITY_MCP_HTTP_PORT value: {port_raw!r} | validation | error | cli, config, environment, validation |
| Invalid UNITY_MCP_TIMEOUT value: {timeout_raw!r} | validation | error | cli, config, environment, validation |
| Cannot connect to Unity MCP server at {cfg.host}:{cfg.port}. | exception | error | cli, network, connection, http |
| Connection to Unity timed out after {timeout or cfg.timeout} | exception | error | cli, network, timeout, http |
| HTTP error from server: {e.response.status_code} - {e.respon | exception | error | cli, network, http, server-error |
| Unexpected error: {e} | exception | error | cli, network, http, unexpected |
| Connection to Unity timed out while listing instances. Unity | exception | error | network, timeout, cli, httpx, unity-busy |
| Failed to list Unity instances | exception | error | network, protocol-mismatch, cli, httpx, response-shape |
| Connection to Unity timed out after {cfg.timeout}s. Unity ma | exception | error | network, timeout, cli, httpx, configurable-timeout |
1 --http-remote-hosted requires --api-key-validation-url or UNITY_MCP_API_KEY_VALI | console | critical | config, startup, auth, remote-hosted, system-exit |
| PluginHub session missing required 'project' or 'hash' field | exception | error | data-integrity, pluginhub, session, validation, version-mismatch |
| 'commands' must be a non-empty list of command specification | validation | error | validation, batch-execute, input-shape, mcp-tool |
| batch_execute supports up to {max_commands} commands (config | validation | error | validation, batch-execute, limit, configurable, mcp-tool |
| Command at index {index} must be an object with 'tool' and ' | validation | error | validation, batch-execute, input-shape, mcp-tool |
| Command at index {index} is missing a valid 'tool' name | validation | error | validation, batch-execute, input-shape, tool-name, mcp-tool |
| Command '{tool_name}' must specify parameters as an object/d | validation | error | validation, batch-execute, input-shape, params, mcp-tool |
| Command '{tool_name}' at index {index} contains 'unity_insta | validation | error | validation, batch-execute, instance-routing, security, mcp-tool |
| op is required; allowed: {allowed}. Use 'op' (aliases accept | validation | error | validation, script-edit, edit-op, mcp-tool |
| anchor not found: {anchor} | exception | error | script-edit, anchor-insert, pattern-not-found, mcp-tool |
| replace_range out of bounds | validation | error | script-edit, replace-range, out-of-bounds, coordinates, mcp-tool |
| unknown edit op: {op}; allowed: {allowed}. Use 'op' (aliases | validation | error | script-edit, edit-op, unknown-op, validation, mcp-tool |
| Cannot reach {url}: {e} | exception | error | network, docs, fetch, offline, urllib |
| MCP for Unity requires FRAMING=1, got: {text!r} | exception | critical | handshake, framing, version-mismatch, stdio, protocol |
| Connection closed before reading expected bytes | exception | error | connection, framed, eof, socket, domain-reload |
| Unity sent heartbeat frames without payload within configure | exception | warning | heartbeat, timeout, framed, wedge, long-running |
| Invalid framed length: {payload_len} | exception | error | framed, protocol, corruption, desync |
| Timeout receiving Unity response | exception | error | timeout, framed, socket, unresponsive |
| Connection closed before receiving data | exception | error | connection, legacy, eof, socket |
| Command '{command_type}' exceeded total deadline of {total_t | exception | critical | deadline, timeout, wedge, retry, unresponsive |
| Could not connect to Unity | exception | critical | connection, port, bridge, discovery, deadline |
| Ping unsuccessful | exception | error | ping, protocol, handshake, wrong-port |
| No Unity Editor instances found. Please ensure Unity is runn | exception | critical | discovery, instance, bridge, not-running |
| Multiple Unity instances are connected and none is selected. | exception | error | instance, selection, ambiguity, security, multi-project |
| Project name '{identifier}' matches {len(name_matches)} inst | exception | error | instance, name, ambiguity, resolution |
| Hash '{identifier}' matches multiple instances: {[inst.id fo | exception | error | instance, hash, ambiguity, resolution |
| Unity instance '{identifier}' not found. Available instances | exception | error | instance, not-found, resolution, stale-id |
| Failed to connect to Unity instance '{target.id}' on port {t | exception | critical | connection, instance, port, bridge, stale-cache |
| Unity instance selection is required. Call set_active_instan | exception | error | http, instance, selection, remote-hosted, multi-tenant |
| Multiple Unity instances are connected. Call set_active_inst | exception | error | http, instance, ambiguity, selection, multi-project |
| No Unity plugins are currently connected | exception | error | no-session, connectivity, unity, transport |
| unity_instance value must not be empty. | validation | error | validation, input, unity-instance |
| Port-based targeting ('{value}') is not supported in HTTP tr | validation | error | validation, transport, http, unity-instance |
| No Unity instance found on port {value}. Available: {availab | validation | error | validation, stdio, port, unity-instance |
| Instance '{value}' not found. Available: {available}. Read m | validation | error | validation, unity-instance, stale-session |
| Hash prefix '{value}' is ambiguous ({ambiguous}). Provide th | validation | error | validation, unity-instance, ambiguous |
| No running Unity instance matches '{value}'. Available: {ava | validation | error | validation, unity-instance, not-found |
| API key authentication required. Provide a valid X-API-Key h | exception | critical | auth, api-key, remote-hosted, http |
| HTTP transport requires command arguments | validation | error | transport, http, validation, api-misuse |
| Command parameters must be a dict for HTTP transport | validation | error | transport, http, type-guard, api-misuse |
| git {args} failed | exception | error | git, subprocess, tooling, mcp-source |
| Could not find Packages/manifest.json from current directory | exception | error | tooling, filesystem, unity-project, mcp-source |
| Manifest template not found: {MANIFEST_TEMPLATE} | exception | error | tooling, release, filesystem, mcpb |
| Icon not found: {icon_path} | exception | error | tooling, release, filesystem, mcpb |
| MCPB file was not created: {output_path} | exception | error | tooling, release, mcpb, subprocess |
| No Unity editor binary found. Searched:\n {searched} | exception | critical | tooling, unity-editor, filesystem, harness |
| No Unity editor binary found. Searched:\n | exception | error | tooling, unity-editor, validation, harness |
| {path}: expected 1 replacement for pattern, got {n} | exception | error | tooling, release, regex, validation |
| {path}: expected to remove exactly 1 line '{line}', removed | exception | error | build-script, release-tooling, source-edit, validation |
| --remote-url must be a non-empty URL | exception | error | build-script, release-tooling, argument-validation, cli |
| Source MCPForUnity folder not found: {source_mcp} | exception | error | build-script, release-tooling, path-validation, filesystem |
| Assets folder not found: {assets_dir} | exception | error | build-script, release-tooling, path-validation, unity-project, filesystem |
| Expected file not found: {f} | exception | error | build-script, release-tooling, path-validation, source-edit, filesystem |
| Connection closed while reading | exception | warning | stress-test, network, tcp, unity-bridge, connection |
| Invalid frame length: {length} | validation | error | stress-test, network, tcp, protocol, framing, unity-bridge |
| Unexpected handshake from server: {line!r} | exception | error | stress-test, network, tcp, protocol, handshake, unity-bridge |
| Connection closed while reading | exception | warning | stress-test, network, tcp, unity-bridge, connection |
| Invalid frame length: {length} | validation | error | stress-test, network, tcp, protocol, framing, unity-bridge |
| Unexpected handshake from server: {line!r} | exception | error | stress-test, network, tcp, protocol, handshake, unity-bridge |
| Package file not found: {PACKAGE_JSON} | exception | error | release-tooling, version-management, path-validation, filesystem |
| No version found in package.json | validation | error | release-tooling, version-management, json-validation, config |