Version: 2023.1
Language : English
Creating scene templates
Customizing new scene creation

Editing scene templates

To edit a 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
template, select it in the Project windowA window that shows the contents of your Assets folder (Project tab) More info
See in Glossary
, then open it in an Inspector window.

Note:
When you first create an empty scene template, you must edit its properties to associate it with a scene before you can use it. Templates that you create from the active scene, or an existing scene asset, have some properties set by default.

The scene template Inspector
The scene template Inspector

The scene template InspectorA Unity window that displays information about the currently selected GameObject, asset or project settings, allowing you to inspect and edit the values. More info
See in Glossary
has the following sections:

  1. Details: Specifies which scene the template uses, and contains the template description that appears in the New Scene dialog.
  2. Thumbnail: Provides options for creating a preview image for the template.
  3. Scene Template Pipeline: Specifies an optional custom script to run when Unity creates a new scene from the template.
  4. Dependencies: Lists the template scene’s dependencies, and specifies whether Unity clones them when it creates a new scene from the template.

Details

Use the Details section to specify which scene to use for a template, and control how the template appears in the New Scene dialog.


Property: Description:
Template Scene Specifies the scene to use as a template. This can be any scene in the Project.
Title The template name. The name you enter here appears in the New Scene dialog.
Description The template description. The description you enter here appears in the New Scene dialog.
Pin in New Scene Dialog Controls whether this template is pinned in the New Scene dialog.

Pinned templates always appear at the top of the Scene Templates in Project list.

Thumbnail

The Thumbnail section contains options for creating a preview image for the template. The preview image appears in the New Scene dialog.

The scene template Inspector

Property: Description:
Texture Specifies a Texture asset to use as a thumbnail for this template. You can use any Texture asset in the Project.

If you don’t assign a Texture, the template uses the default scene template asset icon.
[Thumbnail Preview] Displays the template’s thumbnail texture, if it has one.
Snapshot Provides options for capturing a thumbnail image for this template.
View Specifies whether to capture the Main CameraA component which creates an image of a particular viewpoint in your scene. The output is either drawn to the screen or captured as a texture. More info
See in Glossary
view or the Game View.
Take Snapshot Click this button to capture the selected View.

Scene Template Pipeline

Use these properties to add a Scene Template Pipeline script to this template.


A Scene Template Pipeline script lets you execute custom code when you create a new scene from the template. See Customizing new scene creation.

Dependencies

This section lists all of the template scene’s Dependencies. You can specify whether or not to Clone each dependency when you create a new scene from the template.

To search for a dependency by name, enter text in the search bar.

To sort the Dependencies list:

  • Click the Dependencies heading to sort by the name of the dependency in alphabetical order.
  • Click the Type heading to sort by the dependency Type.
  • Click the Clone heading to sort by dependencies that are cloned and not cloned.


For each dependency in the list, toggle the Clone option on to clone the dependency, or off to reference the dependency. When you clone a dependency, you create a copy. When you reference a dependency, all changes made to the original will affect the dependency.

When you create a new scene from the template, Unity checks whether the template scene has cloneable dependencies. If it does, Unity creates a folder with the same name as the new scene, and puts any cloned dependencies in that folder.

For more information about cloned and referenced dependencies, see Templates and scene dependencies.

To specify which types of asset Unity clones by default, edit the scene template Project settings.


Creating scene templates
Customizing new scene creation