2.1 KiB
2.1 KiB
name, description
| name | description |
|---|---|
| scene-save | Save an opened scene back to its asset file (or to a new path when `path` is provided). When `openedSceneName` is empty, saves the currently active scene. Use 'scene-list-opened' to find the scene name first. |
Scene / Save
Save Opened scene to the asset file. Use 'scene-list-opened' tool to get the list of all opened scenes.
Inputs
openedSceneName(optional) — name of an opened scene to save. Empty/null = active scene.path(optional) — destination.unitypath. Empty/null = save back to the scene's existing path.
Validation
Throws if the scene cannot be resolved, has no existing path AND no override path was supplied, or the supplied path does not end with .unity. On EditorSceneManager.SaveScene failure, surfaces an error with the current opened-scenes list for diagnosis.
How to Call
unity-mcp-cli run-tool scene-save --input '{
"openedSceneName": "string_value",
"path": "string_value"
}'
For complex input (multi-line strings, code), save the JSON to a file and use:
unity-mcp-cli run-tool scene-save --input-file args.jsonOr pipe via stdin (recommended):
unity-mcp-cli run-tool scene-save --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
| Name | Type | Required | Description |
|---|---|---|---|
openedSceneName |
string |
No | Name of the opened scene that should be saved. Could be empty if need to save the current active scene. |
path |
string |
No | Path to the scene file. Should end with ".unity". If null or empty save to the existed scene asset file. |
Input JSON Schema
{
"type": "object",
"properties": {
"openedSceneName": {
"type": "string"
},
"path": {
"type": "string"
}
}
}
Output
This tool does not return structured output.