Table of Contents

Scene Editing

A scene or level is a document like all assets. To edit a scene there are multiple tools available. This page gives a broad overview what tools there are and in what order to try them out.


Open a Project and Scene

You can start editing an existing project and scene, or you can create your own. See the article about projects for how to do so. We suggest to start by looking at the Testing Chambers project, even if you then use an empty scene, as there are some useful prefabs in that project.

If you don't have a scene open yet, the easiest way is to set the Filter in the asset browser to Scene and then double click one of the scenes that belong to that project.

First Steps

The very first thing you should familiarize yourself with is how to move the editor camera around the scene. The chapter about camera controls lists all the available options.

Next, try out selecting objects.

With one or multiple objects selected, you can try out the editing gizmos.

Add Objects

The easiest way to add objects to a scene is to drag and drop existing items from the asset browser into the scene. You would mostly do this for meshes and prefabs, but it works for many asset types. If you want to get your own assets into the editor, you should read up on how to import assets.

Create Objects

You can, of course, also build objects from the ground up by creating empty game objects and components. Game objects mostly specify the position of an object, components give objects behavior.

The easiest way to create a new game object is to point somewhere with the mouse cursor and press Ctrl + Shift + X. This will create a new game object at the position you pointed at. It also attaches a Shape Icon component, whose sole purpose is to make that new object visible and selectable. You can remove that component as soon as you have no need for it anymore.

You can also right-click anywhere in the scene tree and select Create Empty Child Object.

When you copy an object (Ctrl + C), you can also point anywhere and paste (Ctrl + V) to create a duplicate at that position.

Editing Object Hierarchies

The way objects are parented to each other is often very important. There are multiple ways to change the hierarchy:

  • Drag and drop: In the Scenegraph panel, you can drag and drop a node onto another node to parent it to that.

  • Right-click -> Detach: Selecting Detach from the context menu, will make a node a top-level game object that has no parent.

  • Right-click -> Attach to This: Selecting Attach to This from the context menu, will make the selected node a child of the object that you pointed at in the viewport.

  • Paste As Child: When you copied an object, you can select a desired parent node and then use Paste As Child from the context menu, to paste a new object and attach it to the selected object right away.

Video: How to parent objects


Blocking Out a Scene

To get some geometry into your scene, you can use the greyboxing tool. The nice thing about greyboxing geometry is, that it automatically sets up colliders, as well, thus once you try to play your game, you won't fall through the geometry.


You can now try to run your scene. If you use the Testing Chambers sample project, and you created an empty scene, make sure to add a Player Start Point and make it reference the Player prefab. This way when you use Play-the-Game mode, you get a first person shooter game play experience.


Now that you know the basics, you can explore some of the more advanced functionality.


Apart from the single 3D perspective view, there are also orthographic views and different types of render modes. This article describes all the details.


Materials are what is used to give objects a texture. There is much more to this and the chapter about materials lists all the details, but for the time being you can get away with just the most simple material setup. For instance, when you import a mesh, it may add materials automatically for you. Usually you just need to make sure that the paths to the referenced textures are correct.


The fun really starts once you get to play around with physics. Read up on the Jolt Physics integration for this. For a basic setup you always need at least an actor component (static for scene geometry, dynamic for stuff that should fall down) and a shape component to give the object a physical shape.

Advanced Editing

Once you have one physically correct falling box, you may want to have one hundred. Using these tools, you are only a few clicks away from that.

Scene Layers

Once your scene starts to become bigger, you may want to use scene layers for better organization.


ezEngine Overview

Next Steps

Now that you are familiar with how to create, edit and test a basic scene, there are many other things to explore. Decals and particle effects can make your scene more interesting. Proper sounds add a lot of atmosphere. And finally, by writing custom code, either in C++ or through scripting, you will bring your own game idea to life.

See Also