Legacy Documentation: Version 5.5
LanguageEnglish
  • C#
  • JS

Script language

Select your preferred scripting language. All code snippets will be displayed in this language.

EditorSceneManager.SaveScene

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

public static function SaveScene(scene: SceneManagement.Scene, dstScenePath: string = "", saveAsCopy: bool = false): bool;
public static bool SaveScene(SceneManagement.Scene scene, string dstScenePath = "", bool saveAsCopy = false);

Parameters

scene The Scene to be saved.
dstScenePath The file path to save the Scene to. If the path is empty, the current open Scene is overwritten. If it has not yet been saved at all, a save dialog is shown.
saveAsCopy If set to true, the Scene is saved without changing the current Scene, and without clearing the unsaved changes marker.

Returns

bool True if the save succeeded, otherwise false.

Description

Save a Scene.

All paths are relative to the project folder, such as: "Assets/MyScenes/MyScene.unity". Folders specified in the path must already exist before calling the function. If no path is specified, the path of the current open scene is used, except if it was never saved before, in which case a save dialog is shown.

The function returns false if the save failed. This can happen if the specified path is invalid or if the user cancels in the case of a save dialog.

See Also: EditorSceneManager.GetActiveScene

Example:
Simple Editor Window that saves each 300 seconds the current scene.

#pragma strict
import UnityEditor.SceneManagement;
public class SimpleAutoSaveJS extends EditorWindow {
	public var saveTime: float = 300;
	public var nextSave: float = 0;
	@MenuItem("Example/Simple autoSave JS")
	static function Init() {
		var window: SimpleAutoSaveJS = EditorWindow.GetWindowWithRect(SimpleAutoSaveJS, new Rect(0, 0, 200, 50));
		window.Show();
	}
	function OnGUI() {
		EditorGUILayout.LabelField("Save Each:", saveTime + " Secs");
		var timeToSave: float = nextSave - EditorApplication.timeSinceStartup;
		EditorGUILayout.LabelField("Next Save:", timeToSave.ToString() + " Sec");
		Repaint();
		if (EditorApplication.timeSinceStartup > nextSave) {
			var path: String[] = EditorSceneManager.GetActiveScene().path.Split(char.Parse("/"));
			path[path.Length - 1] = "AutoSave_" + path[path.Length - 1];
			var saveOK: boolean = EditorSceneManager.SaveScene(EditorSceneManager.GetActiveScene(), String.Join("/", path));
			Debug.Log("Saved Scene " + (saveOK ? "OK" : "Error!"));
			nextSave = EditorApplication.timeSinceStartup + saveTime;
		}
	}
}
using UnityEditor;
using UnityEngine;
using System.Collections;
using UnityEditor.SceneManagement;

public class SimpleAutoSave : EditorWindow { public float saveTime = 300; public float nextSave = 0; [MenuItem("Example/Simple autoSave")] static void Init() { SimpleAutoSave window = (SimpleAutoSave)EditorWindow.GetWindowWithRect(typeof(SimpleAutoSave), new Rect(0, 0, 200, 50)); window.Show(); } void OnGUI() { EditorGUILayout.LabelField("Save Each:", saveTime + " Secs"); float timeToSave = nextSave - (float)EditorApplication.timeSinceStartup; EditorGUILayout.LabelField("Next Save:", timeToSave.ToString() + " Sec"); Repaint(); if (EditorApplication.timeSinceStartup > nextSave) { string[] path = EditorSceneManager.GetActiveScene().path.Split(char.Parse("/")); path[path.Length - 1] = "AutoSave_" + path[path.Length - 1]; bool saveOK = EditorSceneManager.SaveScene(EditorSceneManager.GetActiveScene(),string.Join("/",path)); Debug.Log("Saved Scene "+(saveOK ? "OK" : "Error!")); nextSave = (float)EditorApplication.timeSinceStartup + saveTime; } } }