Update with building moved to manage_build

Author: Scriptwonder

.claude/skills/unity-mcp-skill/SKILL.md

@@ -178,7 +178,7 @@ uri="file:///full/path/to/file.cs"
 
 | Category | Key Tools | Use For |
 |----------|-----------|---------|
-| **Scene** | `manage_scene`, `find_gameobjects` | Scene operations, finding objects. Multi-scene editing (additive load, close, set active, move GO between scenes), `modify_build_settings`, scene templates (`3d_basic`, `2d_basic`, `empty`, `default`), scene validation with `auto_repair`. |
+| **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")`. |
 | **Objects** | `manage_gameobject`, `manage_components` | Creating/modifying GameObjects |
 | **Scripts** | `create_script`, `script_apply_edits`, `validate_script` | C# code management (auto-refreshes on create/edit) |
 | **Assets** | `manage_asset`, `manage_prefabs` | Asset operations. **Prefab instantiation** is done via `manage_gameobject(action="create", prefab_path="...")`, not `manage_prefabs`. |

.claude/skills/unity-mcp-skill/references/tools-reference.md

@@ -190,11 +190,7 @@ manage_scene(action="close_scene", scene_name="Level2")             # Unload sce
 manage_scene(action="close_scene", scene_name="Level2", remove_scene=True)  # Fully remove
 manage_scene(action="move_to_scene", target="Player", scene_name="Level2")  # Move root GO
 
-# Build settings management (consolidated)
-manage_scene(action="modify_build_settings", scene_path="Assets/Scenes/Level2.unity", operation="add")
-manage_scene(action="modify_build_settings", scene_path="Assets/Scenes/Old.unity", operation="remove")
-manage_scene(action="modify_build_settings", scene_path="Assets/Scenes/Debug.unity",
-             operation="set_enabled", enabled=False)
+# Build settings — use manage_build(action="scenes") instead
 
 # Scene validation
 manage_scene(action="validate")                    # Detect missing scripts, broken prefabs

MCPForUnity/Editor/Tools/ManageScene.cs

@@ -61,8 +61,6 @@ private sealed class SceneCommand
             public string target { get; set; }           // GO reference for move_to_scene
             public bool? removeScene { get; set; }       // for close_scene
             public bool? additive { get; set; }          // for load additive mode
-            public bool? enabled { get; set; }           // for modify_build_settings set_enabled
-            public string operation { get; set; }        // for modify_build_settings
             public string template { get; set; }         // for create with template
             public bool? autoRepair { get; set; }        // for validate with auto-repair
         }
@@ -140,8 +138,6 @@ private static SceneCommand ToSceneCommand(JObject p)
                 target = (p["target"])?.ToString(),
                 removeScene = ParamCoercion.CoerceBoolNullable(p["removeScene"] ?? p["remove_scene"]),
                 additive = ParamCoercion.CoerceBoolNullable(p["additive"]),
-                enabled = ParamCoercion.CoerceBoolNullable(p["enabled"]),
-                operation = (p["operation"])?.ToString()?.ToLowerInvariant(),
                 template = (p["template"])?.ToString()?.ToLowerInvariant(),
                 autoRepair = ParamCoercion.CoerceBoolNullable(p["autoRepair"] ?? p["auto_repair"]),
             };
@@ -283,15 +279,17 @@ public static object HandleCommand(JObject @params)
                 case "move_to_scene":
                     return MoveToScene(cmd);
                 case "modify_build_settings":
-                    return ModifyBuildSettings(cmd);
+                    return new ErrorResponse(
+                        "Build settings management has moved to manage_build (action='scenes'). "
+                        + "Use manage_build to add, remove, or configure scenes in build settings.");
 
                 // Scene validation
                 case "validate":
                     return ValidateScene(cmd.autoRepair == true);
 
                 default:
                     return new ErrorResponse(
-                        $"Unknown action: '{action}'. Valid actions: create, load, save, get_hierarchy, get_active, get_build_settings, screenshot, scene_view_frame, close_scene, set_active_scene, get_loaded_scenes, move_to_scene, modify_build_settings, validate."
+                        $"Unknown action: '{action}'. Valid actions: create, load, save, get_hierarchy, get_active, get_build_settings, screenshot, scene_view_frame, close_scene, set_active_scene, get_loaded_scenes, move_to_scene, validate. For build settings, use manage_build."
                     );
             }
         }
@@ -1606,67 +1604,7 @@ private static object MoveToScene(SceneCommand cmd)
             return new SuccessResponse($"Moved '{go.name}' to scene '{targetScene.Value.name}'.");
         }
 
-        private static object ModifyBuildSettings(SceneCommand cmd)
-        {
-            string op = cmd.operation;
-            string scenePath = cmd.scenePath;
-
-            if (string.IsNullOrEmpty(scenePath))
-                return new ErrorResponse("'scenePath' is required for modify_build_settings.");
-            if (string.IsNullOrEmpty(op))
-                return new ErrorResponse("'operation' is required. Valid operations: add, remove, set_enabled.");
-
-            var current = new List<EditorBuildSettingsScene>(EditorBuildSettings.scenes);
-
-            switch (op)
-            {
-                case "add":
-                    if (current.Exists(s => s.path == scenePath))
-                        return new ErrorResponse($"Scene '{scenePath}' is already in build settings.");
-                    current.Add(new EditorBuildSettingsScene(scenePath, true));
-                    EditorBuildSettings.scenes = current.ToArray();
-                    return new SuccessResponse($"Added '{scenePath}' to build settings at index {current.Count - 1}.", new
-                    {
-                        scenePath,
-                        buildIndex = current.Count - 1,
-                        totalScenes = current.Count
-                    });
-
-                case "remove":
-                    int removed = current.RemoveAll(s => s.path == scenePath);
-                    if (removed == 0)
-                        return new ErrorResponse($"Scene '{scenePath}' is not in build settings.");
-                    EditorBuildSettings.scenes = current.ToArray();
-                    return new SuccessResponse($"Removed '{scenePath}' from build settings.", new
-                    {
-                        scenePath,
-                        totalScenes = current.Count
-                    });
-
-                case "set_enabled":
-                    if (!cmd.enabled.HasValue)
-                        return new ErrorResponse("'enabled' (true/false) is required for set_enabled operation.");
-                    bool found = false;
-                    var scenes = EditorBuildSettings.scenes;
-                    for (int i = 0; i < scenes.Length; i++)
-                    {
-                        if (scenes[i].path == scenePath)
-                        {
-                            scenes[i].enabled = cmd.enabled.Value;
-                            found = true;
-                            break;
-                        }
-                    }
-                    if (!found)
-                        return new ErrorResponse($"Scene '{scenePath}' is not in build settings.");
-                    EditorBuildSettings.scenes = scenes;
-                    string state = cmd.enabled.Value ? "enabled" : "disabled";
-                    return new SuccessResponse($"Scene '{scenePath}' is now {state} in build settings.");
-
-                default:
-                    return new ErrorResponse($"Unknown operation: '{op}'. Valid operations: add, remove, set_enabled.");
-            }
-        }
+        // ModifyBuildSettings removed — use manage_build(action="scenes") instead.
 
         // ── Scene templates ────────────────────────────────────────────────
 

README.md

@@ -20,7 +20,7 @@
 <details>
 <summary><strong>Recent Updates</strong></summary>
 
-* **v9.6.1 (beta)** — QoL extensions: `manage_editor` gains undo/redo actions. `manage_scene` gains multi-scene editing (additive load, close, set active, move GO between scenes), `modify_build_settings`, scene templates (3d_basic, 2d_basic, etc.), and scene validation with auto-repair. New `manage_build` tool: trigger player builds, switch platforms, configure player settings, manage build scenes and profiles (Unity 6+), run batch builds across multiple platforms, and async job tracking with polling. New `MaxPollSeconds` infrastructure for long-running tool operations.
+* **v9.6.1 (beta)** — QoL extensions: `manage_editor` gains undo/redo actions. `manage_scene` gains multi-scene editing (additive load, close, set active, move GO between scenes), scene templates (3d_basic, 2d_basic, etc.), and scene validation with auto-repair. New `manage_build` tool: trigger player builds, switch platforms, configure player settings, manage build scenes and profiles (Unity 6+), run batch builds across multiple platforms, and async job tracking with polling. New `MaxPollSeconds` infrastructure for long-running tool operations.
 * **v9.5.4** — New `unity_reflect` and `unity_docs` tools for API verification: inspect live C# APIs via reflection and fetch official Unity documentation (ScriptReference, Manual, package docs). New `manage_packages` tool: install, remove, search, and manage Unity packages and scoped registries. Includes input validation, dependency checks on removal, and git URL warnings.
 * **v9.5.3** — New `manage_graphics` tool (33 actions): volume/post-processing, light baking, rendering stats, pipeline settings, URP renderer features. 3 new resources: `volumes`, `rendering_stats`, `renderer_features`.
 * **v9.5.2** — New `manage_camera` tool with Cinemachine support (presets, priority, noise, blending, extensions), `cameras` resource, priority persistence fix via SerializedProperty.

Server/src/cli/commands/scene.py

@@ -318,36 +318,6 @@ def move_to(target: str, scene_name: str):
         print_success(f"Moved '{target}' to scene '{scene_name}'")
 
 
-@scene.command("build-modify")
-@click.argument("scene_path")
-@click.option("--op", required=True, type=click.Choice(["add", "remove", "set_enabled"]),
-              help="Operation to perform.")
-@click.option("--enable/--disable", "enabled", default=None,
-              help="For set_enabled: enable or disable.")
-@handle_unity_errors
-def build_modify(scene_path: str, op: str, enabled: Optional[bool]):
-    """Add, remove, or enable/disable a scene in build settings.
-
-    \b
-    Examples:
-        unity-mcp scene build-modify "Assets/Scenes/Level2.unity" --op add
-        unity-mcp scene build-modify "Assets/Scenes/OldLevel.unity" --op remove
-        unity-mcp scene build-modify "Assets/Scenes/Debug.unity" --op set_enabled --disable
-    """
-    config = get_config()
-    params: dict[str, Any] = {
-        "action": "modify_build_settings",
-        "scenePath": scene_path,
-        "operation": op,
-    }
-    if enabled is not None:
-        params["enabled"] = enabled
-    result = run_command("manage_scene", params, config)
-    click.echo(format_output(result, config.format))
-    if result.get("success"):
-        print_success(f"Build settings updated: {op} {scene_path}")
-
-
 # ── Scene validation ─────────────────────────────────────────────────
 
 

Server/src/services/tools/manage_scene.py

@@ -16,7 +16,8 @@
         "Performs CRUD operations on Unity scenes. "
         "Read-only actions: get_hierarchy, get_active, get_build_settings, get_loaded_scenes, scene_view_frame. "
         "Modifying actions: create (with optional template), load (with optional additive flag), save, "
-        "close_scene, set_active_scene, move_to_scene, modify_build_settings, validate (with optional auto_repair). "
+        "close_scene, set_active_scene, move_to_scene, validate (with optional auto_repair). "
+        "For build settings management (add/remove/enable scenes), use manage_build(action='scenes'). "
         "For screenshots, use manage_camera (screenshot, screenshot_multiview actions)."
     ),
     annotations=ToolAnnotations(
@@ -38,7 +39,6 @@ async def manage_scene(
         "set_active_scene",
         "get_loaded_scenes",
         "move_to_scene",
-        "modify_build_settings",
         "validate",
     ], "Perform CRUD operations on Unity scenes and control the Scene View camera."],
     name: Annotated[str, "Scene name."] | None = None,
@@ -74,10 +74,6 @@ async def manage_scene(
                             "For close_scene: true to fully remove, false to just unload."] | None = None,
     additive: Annotated[bool | str,
                         "For load: true to open scene additively (keeps current scene)."] | None = None,
-    enabled: Annotated[bool | str,
-                       "For modify_build_settings set_enabled operation."] | None = None,
-    operation: Annotated[str,
-                         "For modify_build_settings: 'add', 'remove', or 'set_enabled'."] | None = None,
     # --- Scene template ---
     template: Annotated[str,
                         "For create: scene template ('empty', 'default', '3d_basic', '2d_basic'). Omit for empty scene."] | None = None,
@@ -141,12 +137,6 @@ async def manage_scene(
         coerced_additive = coerce_bool(additive, default=None)
         if coerced_additive is not None:
             params["additive"] = coerced_additive
-        coerced_enabled = coerce_bool(enabled, default=None)
-        if coerced_enabled is not None:
-            params["enabled"] = coerced_enabled
-        if operation is not None:
-            params["operation"] = operation
-
         # Scene template
         if template is not None:
             params["template"] = template

Server/tests/test_manage_scene.py

@@ -41,7 +41,7 @@ async def fake_send(send_fn, unity_instance, tool_name, params):
     "create", "load", "save", "get_hierarchy",
     "get_active", "get_build_settings", "scene_view_frame",
     "close_scene", "set_active_scene", "get_loaded_scenes",
-    "move_to_scene", "modify_build_settings",
+    "move_to_scene",
     "validate",
 ]
 
@@ -86,29 +86,6 @@ def test_move_to_scene_passes_target(mock_unity):
     assert mock_unity["params"]["sceneName"] == "Level2"
 
 
-def test_modify_build_settings_passes_operation_and_path(mock_unity):
-    result = asyncio.run(manage_scene(
-        SimpleNamespace(), action="modify_build_settings",
-        scene_path="Assets/Scenes/Debug.unity",
-        operation="set_enabled", enabled=False,
-    ))
-    assert result["success"] is True
-    assert mock_unity["params"]["operation"] == "set_enabled"
-    assert mock_unity["params"]["scenePath"] == "Assets/Scenes/Debug.unity"
-    assert mock_unity["params"]["enabled"] is False
-
-
-def test_add_to_build_passes_scene_path(mock_unity):
-    result = asyncio.run(manage_scene(
-        SimpleNamespace(), action="modify_build_settings",
-        scene_path="Assets/Scenes/NewLevel.unity",
-        operation="add",
-    ))
-    assert result["success"] is True
-    assert mock_unity["params"]["scenePath"] == "Assets/Scenes/NewLevel.unity"
-    assert mock_unity["params"]["operation"] == "add"
-
-
 # ── Template param passthrough ───────────────────────────────────────
 
 
@@ -160,7 +137,5 @@ def test_none_params_omitted(mock_unity):
     assert "target" not in params
     assert "removeScene" not in params
     assert "additive" not in params
-    assert "enabled" not in params
-    assert "operation" not in params
     assert "template" not in params
     assert "autoRepair" not in params

TestProjects/UnityMCPTests/Assets/Tests/EditMode/Tools/ManageSceneMultiSceneTests.cs

@@ -63,43 +63,18 @@ public void MoveToScene_NonExistentGO_ReturnsError()
         }
 
         [Test]
-        public void ModifyBuildSettings_MissingPath_ReturnsError()
-        {
-            var p = new JObject
-            {
-                ["action"] = "modify_build_settings",
-                ["operation"] = "add"
-            };
-            var result = ManageScene.HandleCommand(p);
-            var r = result as JObject ?? JObject.FromObject(result);
-            Assert.IsFalse(r.Value<bool>("success"));
-        }
-
-        [Test]
-        public void ModifyBuildSettings_MissingOperation_ReturnsError()
-        {
-            var p = new JObject
-            {
-                ["action"] = "modify_build_settings",
-                ["scenePath"] = "Assets/Scenes/Test.unity"
-            };
-            var result = ManageScene.HandleCommand(p);
-            var r = result as JObject ?? JObject.FromObject(result);
-            Assert.IsFalse(r.Value<bool>("success"));
-        }
-
-        [Test]
-        public void ModifyBuildSettings_SetEnabled_MissingEnabled_ReturnsError()
+        public void ModifyBuildSettings_RedirectsToManageBuild()
         {
             var p = new JObject
             {
                 ["action"] = "modify_build_settings",
                 ["scenePath"] = "Assets/Scenes/Test.unity",
-                ["operation"] = "set_enabled"
+                ["operation"] = "add"
             };
             var result = ManageScene.HandleCommand(p);
             var r = result as JObject ?? JObject.FromObject(result);
             Assert.IsFalse(r.Value<bool>("success"));
+            Assert.IsTrue(r.Value<string>("message").Contains("manage_build"));
         }
 
         [Test]

docs/i18n/README-zh.md

@@ -20,7 +20,7 @@
 <details>
 <summary><strong>最近更新</strong></summary>
 
-* **v9.6.1 (beta)** — QoL 扩展：`manage_editor` 新增撤销/重做操作。`manage_scene` 新增多场景编辑（叠加加载、关闭、设置活动场景、跨场景移动物体）、`modify_build_settings`、场景模板（3d_basic、2d_basic 等）、场景验证与自动修复。新增 `manage_build` 工具：触发玩家构建、切换平台、配置玩家设置、管理构建场景和配置文件（Unity 6+）、跨多平台批量构建、异步任务跟踪与轮询。新增 `MaxPollSeconds` 基础设施，支持长时间运行的工具操作。
+* **v9.6.1 (beta)** — QoL 扩展：`manage_editor` 新增撤销/重做操作。`manage_scene` 新增多场景编辑（叠加加载、关闭、设置活动场景、跨场景移动物体）、场景模板（3d_basic、2d_basic 等）、场景验证与自动修复。新增 `manage_build` 工具：触发玩家构建、切换平台、配置玩家设置、管理构建场景和配置文件（Unity 6+）、跨多平台批量构建、异步任务跟踪与轮询。新增 `MaxPollSeconds` 基础设施，支持长时间运行的工具操作。
 * **v9.5.4** — 新增 `unity_reflect` 和 `unity_docs` 工具用于 API 验证：通过反射检查实时 C# API，获取官方 Unity 文档（ScriptReference、Manual、包文档）。新增 `manage_packages` 工具：安装、移除、搜索和管理 Unity 包及作用域注册表。包含输入验证、移除时依赖检查和 git URL 警告。
 * **v9.5.3** — 新增 `manage_graphics` 工具（33个操作）：体积/后处理、光照烘焙、渲染统计、管线设置、URP渲染器特性。3个新资源：`volumes`、`rendering_stats`、`renderer_features`。
 * **v9.5.2** — 新增 `manage_camera` 工具，支持 Cinemachine（预设、优先级、噪声、混合、扩展）、`cameras` 资源、通过 SerializedProperty 修复优先级持久化问题。