Customizing new scene creation

To run custom code when Unity instantiates a new sceneA Scene contains the environments and menus of your game. Think of each unique Scene file as a unique level. In each Scene, you place your environments, obstacles, and decorations, essentially designing and building your game in pieces. More info
See in Glossary from a template, create a Scene Template Pipeline script and connect it to the template. Each time you create a new scene from the template, Unity creates a new instance of the pipeline script as well.

To connect the script to a template:

1. Inspect the template to edit its properties.
2. Set the Scene Template Pipeline property to point to your Scene Template Pipeline script.

You can also use the SceneTemplateAsset.templatePipeline method to connect the script to the template via C#.

A Scene Template Pipeline script must derive from the ISceneTemplatePipeline interface or SceneTemplatePipelineAdapter. It should implement the events you want to react to; for example, BeforeTemplateInstantiation or AfterTemplateInstantiation in the code below.

Example:

using UnityEditor.SceneTemplate;
using UnityEngine;
using UnityEngine.SceneManagement;
public class DummySceneTemplatePipeline : ISceneTemplatePipeline
{
    public void BeforeTemplateInstantiation(SceneTemplateAsset sceneTemplateAsset, bool isAdditive, string sceneName)
    {
        if (sceneTemplateAsset)
        {
            Debug.Log($"Before Template Pipeline {sceneTemplateAsset.name} isAdditive: {isAdditive} sceneName: {sceneName}");
        }
    }

    public void AfterTemplateInstantiation(SceneTemplateAsset sceneTemplateAsset, Scene scene, bool isAdditive, string sceneName)
    {
        if (sceneTemplateAsset)
        {
            Debug.Log($"After Template Pipeline {sceneTemplateAsset.name} scene: {scene} isAdditive: {isAdditive} sceneName: {sceneName}");
        }
    }
}

Scene Template instantiation sequence

When you create a new scene from a template with cloneable dependencies, Unity performs several file operations. Most of these operations trigger Unity events that you can listen for, and react to, in scriptsA piece of code that allows you to create your own Components, trigger game events, modify Component properties over time and respond to user input in any way you like. More info
See in Glossary.

After you create a new scene, Unity performs the following actions:

1. Creates a scene template asset, a template scene associated with the template, and a new instance of the template scene.

2. Triggers the ISceneTemplatePipeline.BeforeTemplateInstantiation event for the template asset, and binds the asset to a ISceneTemplatePipeline script that it triggers.

3. Triggers the SceneTemplate.NewTemplateInstantiating event.

4. Creates a new scene that’s a copy of the template scene.

5. Creates a folder with the same name as the new scene, and copies all cloneable dependencies into that folder.

6. Opens the new scene in memory, and triggers the following events:
   • EditorSceneManager.sceneOpening
   • MonoBehavior.OnValidate (on all GameObjects that implement it)
   • EditorSceneManager.sceneOpened

7. Remaps references to all cloneable assets, so the new scene points to the clones.

8. Saves the new scene, and triggers the following events:
   • EditorSceneManager.sceneSaving
   • EditorSceneManager.sceneSaved

9. Triggers the ISceneTemplatePipeline.AfterTemplateInstantiation for the template asset, and binds the asset to a ISceneTemplatePipeline script that it triggers.

10. Triggers the SceneTemplate.NewTemplateInstantiated event.

Additional resources

• Creating Scene templates
• Editing Scene templates