scene-create

Scene / Create

Create new scene in the project assets. Use 'scene-list-opened' tool to list all opened scenes after creation.

Inputs

• path — must end with .unity. Non-empty.
• newSceneSetup (default DefaultGameObjects) — Unity's NewSceneSetup flag (EmptyScene or DefaultGameObjects).
• newSceneMode (default Single) — Single closes other scenes, Additive keeps them open.

Behavior

Calls EditorSceneManager.NewScene + SaveScene(path) on the main thread, repaints editor windows, and returns a SceneDataShallow for the newly created scene.

How to Call

unity-mcp-cli run-tool scene-create --input '{
  "path": "string_value",
  "newSceneSetup": "string_value",
  "newSceneMode": "string_value"
}'

For complex input (multi-line strings, code), save the JSON to a file and use:

unity-mcp-cli run-tool scene-create --input-file args.json

Or pipe via stdin (recommended):

unity-mcp-cli run-tool scene-create --input-file - <<'EOF'
{"param": "value"}
EOF

Troubleshooting

If unity-mcp-cli is not found, either install it globally (npm install -g unity-mcp-cli) or use npx unity-mcp-cli instead. Read the /unity-initial-setup skill for detailed installation instructions.

Input

Input JSON Schema

{
  "type": "object",
  "properties": {
    "path": {
      "type": "string"
    },
    "newSceneSetup": {
      "$ref": "#/$defs/UnityEditor.SceneManagement.NewSceneSetup"
    },
    "newSceneMode": {
      "$ref": "#/$defs/UnityEditor.SceneManagement.NewSceneMode"
    }
  },
  "$defs": {
    "UnityEditor.SceneManagement.NewSceneSetup": {
      "type": "string",
      "enum": [
        "EmptyScene",
        "DefaultGameObjects"
      ]
    },
    "UnityEditor.SceneManagement.NewSceneMode": {
      "type": "string",
      "enum": [
        "Single",
        "Additive"
      ]
    }
  },
  "required": [
    "path"
  ]
}