Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
69 commits
Select commit Hold shift + click to select a range
ee6d67f
fix: use 127.0.0.1 instead of localhost to avoid IPv4/IPv6 ambiguity …
dsarno Feb 5, 2026
2f63fd8
fix: map :: to ::1 instead of 127.0.0.1 and add HTTP default tests
dsarno Feb 5, 2026
ed200ed
fix: prevent duplicate TCP listeners after domain reload on Windows
dsarno Feb 6, 2026
573a761
fix: harden reload resume and localhost reconnect fallbacks
dsarno Feb 7, 2026
f319983
Fix UnityMCPTests connection URI expectations
dsarno Feb 7, 2026
ac45e6f
Use relative path for local Unity package
dsarno Feb 7, 2026
9b70437
Restore minimal SampleScene
dsarno Feb 7, 2026
5610890
Revert SampleScene to match main
dsarno Feb 7, 2026
bb447e2
chore: sync main (v9.4.4) into beta
actions-user Feb 11, 2026
be1fc59
chore: set beta version to 9.4.5-beta.1 after release v9.4.4
actions-user Feb 11, 2026
43c5fd3
Merge pull request #721 from CoplayDev/sync/main-v9.4.4-into-beta-218…
github-actions[bot] Feb 11, 2026
c513072
fix: preserve tool enabled/disabled state across Unity restarts
whatevertogo Feb 11, 2026
09c61e1
fix: avoid duplicate reregistration and harden tool preference tests
whatevertogo Feb 11, 2026
10754e5
feat: implement tool filtering based on Unity session state in on_lis…
whatevertogo Feb 11, 2026
fb17aea
chore: delete State.meta file
whatevertogo Feb 11, 2026
3b624c1
fix: update tool filtering logic to handle user-specific tool lookups…
whatevertogo Feb 11, 2026
c67e9f2
fix: add user_id param to execute_custom_tool for remote-hosted mode
whatevertogo Feb 11, 2026
fc81d9e
fix: preserve tool state and filter tools in client listings (fixes #…
whatevertogo Feb 11, 2026
1a9b083
fix: add unity_target parameter to mcp_for_unity_tool for improved to…
whatevertogo Feb 11, 2026
f9d6f39
[skill update] Update for UI instructions in the skills (#726)
Scriptwonder Feb 12, 2026
ad3756e
Bug fix and batch customization (#727)
Scriptwonder Feb 12, 2026
86af416
chore: update Unity package to beta version 9.4.5-beta.2
actions-user Feb 12, 2026
038a39e
Merge pull request #728 from CoplayDev/beta-version-9.4.5-beta.2-2192…
github-actions[bot] Feb 12, 2026
18e7a32
Fix execute_custom_tool bypassed when unity_instance is specified (#724)
whatevertogo Feb 12, 2026
16fe15f
chore: update Unity package to beta version 9.4.5-beta.3
actions-user Feb 12, 2026
47458b0
Merge pull request #729 from CoplayDev/beta-version-9.4.5-beta.3-2192…
github-actions[bot] Feb 12, 2026
6da232f
[feature] Animation and AnimController (#696)
Scriptwonder Feb 12, 2026
568b783
chore: update Unity package to beta version 9.4.5-beta.4
actions-user Feb 12, 2026
5608665
Merge pull request #730 from CoplayDev/beta-version-9.4.5-beta.4-2192…
github-actions[bot] Feb 12, 2026
07fee1b
fix: update tool filtering logic to defer filtering when no tools are…
whatevertogo Feb 12, 2026
174c634
fix: accept JSON strings for list parameters in manage_gameobject and…
whatevertogo Feb 12, 2026
8a580bb
feat: enhance string list normalization to support plain strings in m…
whatevertogo Feb 12, 2026
254fc93
fix: validate JSON syntax in normalize_string_list to catch malformed…
whatevertogo Feb 12, 2026
6347c97
fix: add missing using UnityEditor.UIElements for IntegerField
dsarno Feb 12, 2026
ee41cd1
Merge pull request #688 from dsarno/fix/localhost-ipv6-resolution
dsarno Feb 12, 2026
a89a043
chore: update Unity package to beta version 9.4.5-beta.5
actions-user Feb 12, 2026
de2902c
Merge pull request #732 from CoplayDev/beta-version-9.4.5-beta.5-2196…
github-actions[bot] Feb 12, 2026
85bf8c1
fix: improve tool descriptions with explicit cross-references
HivemindOverlord Feb 6, 2026
61e9a7f
Merge pull request #733 from dsarno/fix/694-rebased
dsarno Feb 12, 2026
9825992
chore: update Unity package to beta version 9.4.5-beta.6
actions-user Feb 12, 2026
e6d179f
Merge pull request #734 from CoplayDev/beta-version-9.4.5-beta.6-2196…
github-actions[bot] Feb 12, 2026
eeaecba
Merge branch 'fix/preserve-tool-toggle-state-restarts' of https://git…
dsarno Feb 12, 2026
73f2295
Merge pull request #735 from dsarno/fix/723-rebased
dsarno Feb 12, 2026
6f488b1
chore: update Unity package to beta version 9.4.5-beta.7
actions-user Feb 12, 2026
fedf42a
Merge pull request #736 from CoplayDev/beta-version-9.4.5-beta.7-2196…
github-actions[bot] Feb 12, 2026
f933afe
Merge pull request #731 from whatevertogo/feat/tools-support-json-input
dsarno Feb 12, 2026
86f916a
chore: update Unity package to beta version 9.4.5-beta.8
actions-user Feb 12, 2026
68eb569
Merge pull request #737 from CoplayDev/beta-version-9.4.5-beta.8-2196…
github-actions[bot] Feb 12, 2026
96283de
fix(test): align clip name with asset filename in ClipGetInfo test
dsarno Feb 12, 2026
5908d34
Merge pull request #738 from dsarno/fix/animation-clip-test-name
dsarno Feb 12, 2026
3a1a34b
Add Cline configurator and auto-select server channel (#739)
dsarno Feb 12, 2026
074e763
chore: update Unity package to beta version 9.4.5-beta.9
actions-user Feb 12, 2026
ad2f637
Merge pull request #740 from CoplayDev/beta-version-9.4.5-beta.9-2196…
github-actions[bot] Feb 12, 2026
0d2d10c
fix: enforce tool toggle checks in batch_execute (#741)
dsarno Feb 13, 2026
99225e3
chore: update Unity package to beta version 9.4.5-beta.10
actions-user Feb 13, 2026
0c0a68d
Merge pull request #742 from CoplayDev/beta-version-9.4.5-beta.10-219…
github-actions[bot] Feb 13, 2026
8d62d97
fix: handle bare Assets/ path in manage_shader (#743)
dsarno Feb 13, 2026
837ce89
chore: update Unity package to beta version 9.4.5-beta.11
actions-user Feb 13, 2026
a88e9e2
Merge pull request #744 from CoplayDev/beta-version-9.4.5-beta.11-219…
github-actions[bot] Feb 13, 2026
22951d9
fix: catch ArgumentException from Path.IsPathRooted in IsLocalServerP…
dsarno Feb 13, 2026
9a83571
chore: update Unity package to beta version 9.4.5-beta.12
actions-user Feb 13, 2026
41e5efa
Merge pull request #747 from CoplayDev/beta-version-9.4.5-beta.12-219…
github-actions[bot] Feb 13, 2026
cda07f7
fix: ManageScript delimiter checking for C# string variants (#745)
dsarno Feb 13, 2026
b497125
chore: update Unity package to beta version 9.4.5-beta.13
actions-user Feb 13, 2026
14bc7b8
Merge pull request #748 from CoplayDev/beta-version-9.4.5-beta.13-219…
github-actions[bot] Feb 13, 2026
e9dac01
Harden HTTP defaults and improve stop-server fallback (#751)
dsarno Feb 14, 2026
7bc0a14
chore: update Unity package to beta version 9.4.5-beta.14
actions-user Feb 14, 2026
c18a376
Merge pull request #752 from CoplayDev/beta-version-9.4.5-beta.14-220…
github-actions[bot] Feb 14, 2026
7167d99
chore: bump version to 9.4.6
actions-user Feb 15, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 13 additions & 2 deletions .claude/skills/unity-mcp-skill/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,14 @@ description: Orchestrate Unity Editor via MCP (Model Context Protocol) tools and

This skill helps you effectively use the Unity Editor with MCP tools and resources.

## Template Notice

Examples 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.

Before applying a template:
- Validate targets/components first via resources and `find_gameobjects`.
- Treat names, enum values, and property payloads as placeholders to adapt.

## Quick Start: Resource-First Workflow

**Always read relevant resources before using tools.** This prevents errors and provides the necessary context.
Expand Down Expand Up @@ -41,11 +49,11 @@ batch_execute(
{"tool": "manage_gameobject", "params": {"action": "create", "name": "Cube2", "primitive_type": "Cube"}},
{"tool": "manage_gameobject", "params": {"action": "create", "name": "Cube3", "primitive_type": "Cube"}}
],
parallel=True # Read-only operations can run in parallel
parallel=True # Hint only: Unity may still execute sequentially
)
```

**Max 25 commands per batch.** Use `fail_fast=True` for dependent operations.
**Max 25 commands per batch by default (configurable in Unity MCP Tools window, max 100).** Use `fail_fast=True` for dependent operations.

### 3. Use `screenshot` in manage_scene to Verify Visual Results

Expand Down Expand Up @@ -82,6 +90,8 @@ read_console(

## Parameter Type Conventions

These 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.

### Vectors (position, rotation, scale, color)
```python
# Both forms accepted:
Expand Down Expand Up @@ -124,6 +134,7 @@ uri="file:///full/path/to/file.cs"
| **Editor** | `manage_editor`, `execute_menu_item`, `read_console` | Editor control |
| **Testing** | `run_tests`, `get_test_job` | Unity Test Framework |
| **Batch** | `batch_execute` | Parallel/bulk operations |
| **UI** | `batch_execute` with `manage_gameobject` + `manage_components` | Canvas, Panel, Button, Text, Slider, Toggle, Input Field (see [UI workflows](references/workflows.md#ui-creation-workflows)) |

## Common Workflows

Expand Down
6 changes: 5 additions & 1 deletion .claude/skills/unity-mcp-skill/references/tools-reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@

Complete reference for all MCP tools. Each tool includes parameters, types, and usage examples.

> **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.

## Table of Contents

- [Infrastructure Tools](#infrastructure-tools)
Expand All @@ -27,12 +29,14 @@ batch_execute(
{"tool": "tool_name", "params": {...}},
...
],
parallel=False, # bool, optional - run read-only ops in parallel
parallel=False, # bool, optional - advisory only (Unity may still run sequentially)
fail_fast=False, # bool, optional - stop on first failure
max_parallelism=None # int, optional - max parallel workers
)
```

`batch_execute` is not transactional: earlier commands are not rolled back if a later command fails.

### set_active_instance

Route commands to a specific Unity instance (multi-instance workflows).
Expand Down
Loading