Table of Contents

Edit a scene

Beginner Level designer

Scenes are a complex asset, meaning that they require the use of a dedicated editor — the Scene editor.

Opening the Scene editor

  1. Locate your scene asset in the Asset view.

  2. Double click the scene or right click and select 🖉 Edit asset...

  3. The Scene editor should now appear.

Tip

You can have multiple Scene editors opened and switch between them using tabs.

The Scene editor consists of two components: the Entity tree and the Viewport.

Entity tree

The Entity tree shows the contents of a scene in a tree-like structure. It allows you to change the order of entities and their parents, as well as quickly find specific elements.

Selecting an element will make the Property grid display its properties.

For more information about other features of the Entity tree, read Entity tree.

Viewport

The Viewport displays a 3D or 2D preview of a scene, without running the game. It allows you to look at the environment from different angles and change the transform of entities in an intuitive and visual way.

There are many ways of controlling the Viewport camera. Each has its own use-cases, so it's a good idea to familiarize yourself with all of them.

Keys Description
Right mouse button Pan the camera
Scroll Zoom
F Focus on an object
Alt + Left mouse button Orbit around a focused object
Middle + Left mouse button Walk

You can also move the camera around similarly to a video game, by holding down the Right mouse button and pressing additional keys:

Keys Description
W/A/S/D or arrow keys Move forwards/left/backwards/right
Q/E Move down/up
Shift Increase speed
Tip

All Viewport keybinds can be changed in the settings.

You can change the camera speed in the 🎥 menu.

You can find the camera menu on the right side of the top toolbar

Entities can be selected from the Viewport by just clicking on them.

For more information on how to use the Viewport, read Viewport.

Modifying the scene structure

The Entity tree supports drag & drop, meaning that you can easily rearrange entities with your mouse.

Note

Depending on where you drop the selection, its resulting location might differ. For example: dropping between two elements of the same parent will move the selection between them (A), while dropping onto an element will make the selection its children (B).

You can see a detailed preview of where the selection will end up in the tooltip next to your mouse.

Editing entities

The Property grid displays a list of properties of the selected entities. It let's you add new components and manage their values.

For more information about components, visit Components.

Transforming entities

The Viewport displays a transformation gizmo next to selected entities. You can use it to move, rotate and scale objects in a visual way by clicking on a part of the gizmo and dragging it.

You can also set explicit values by editing properties of an entity's transform component in the Property grid.

For more information about how to use the Viewport, visit Viewport.

See also