unity-scene-ops

Unity 场景操作

通过 run_unity_python 工具操控 Unity Editor 中的场景。

调用方式

所有操作通过 MCP 工具 run_unity_python 提交 C# 代码片段到 Unity 主线程执行。

# MCP 调用格式
run_unity_python(code="<C# 代码>")

---

操作示例

获取当前场景信息

var scene = UnityEngine.SceneManagement.SceneManager.GetActiveScene();
return Newtonsoft.Json.JsonConvert.SerializeObject(new {
    name = scene.name,
    path = scene.path,
    isDirty = scene.isDirty,
    rootCount = scene.rootCount,
    isLoaded = scene.isLoaded
});

获取场景层级（所有 GameObject）

var scene = UnityEngine.SceneManagement.SceneManager.GetActiveScene();
var roots = scene.GetRootGameObjects();
var result = new System.Collections.Generic.List<object>();
foreach (var go in roots) {
    result.Add(new {
        name = go.name,
        active = go.activeSelf,
        childCount = go.transform.childCount,
        tag = go.tag,
        layer = go.layer
    });
}
return Newtonsoft.Json.JsonConvert.SerializeObject(result);

按名称查找 GameObject

var go = UnityEngine.GameObject.Find("Player");
if (go == null) return "{\"found\": false}";
return Newtonsoft.Json.JsonConvert.SerializeObject(new {
    found = true,
    name = go.name,
    path = UnityEditor.AnimationUtility.CalculateTransformPath(go.transform, null),
    position = new { x = go.transform.position.x, y = go.transform.position.y, z = go.transform.position.z },
    active = go.activeSelf
});

按 Tag 查找所有 GameObject

var objects = UnityEngine.GameObject.FindGameObjectsWithTag("Enemy");
var result = new System.Collections.Generic.List<object>();
foreach (var go in objects) {
    result.Add(new { name = go.name, active = go.activeSelf });
}
return Newtonsoft.Json.JsonConvert.SerializeObject(new { count = objects.Length, objects = result });

保存当前场景

UnityEditor.SceneManagement.EditorSceneManager.SaveScene(
    UnityEngine.SceneManagement.SceneManager.GetActiveScene()
);
return "{\"saved\": true}";

新建场景

var scene = UnityEditor.SceneManagement.EditorSceneManager.NewScene(
    UnityEditor.SceneManagement.NewSceneSetup.DefaultGameObjects,
    UnityEditor.SceneManagement.NewSceneMode.Single
);
return Newtonsoft.Json.JsonConvert.SerializeObject(new { name = scene.name, created = true });