Scene Editor

When opening a scene (or an external layout), the Scene Editor opens.

The Scene Editor is where you can design and build the game levels, menus, inventories or any other screen in the game. The Scene Editor allows you to create and add objects to the scene. Gameplay and rules of the game can be created using events in the Events Editor.

There are a number of tools and editors available on the scene editor's top toolbar.

Objects editor

You will find the Objects Editor on the right side of the Scene Editor's interface. This is where you can see all of the objects used in your scene. You can also add new objects using this editor.

If you close the Object Editor panel, you can reopen it by using this button on the toolbar:

Read about the generic features available for all objects and then look at the help about the objects types to learn more about the different kind of objects that you can use in your game.

Instance Properties panel

You can find the Instance Properties panel on the left side of the Scene Editor's interface. If the Instance Properties panel is not visible, close the Project manager. Then, select an object in your scene. The Instance Properties panel will open on the left.

An object that you put on the scene is called an instance. The Properties panel allows you to change the properties of the selected instance(s):

  • This can be the instance coordinates on the scene, scale, and Z-order. All objects share common properties (as well as common actions and conditions in events). You can learn about these here.
  • Some objects can also have special properties. For example, a Sprite object allow you to set the initial animation of each instance on the scene (the default animation being the first). Read about objects to see all the objects that you can use in GDevelop.
While the difference between an instance and an object can be fuzzy if you're new to GDevelop, it's important to understand that an object is like a blueprint (it's also called a “Class” in some programming languages). You can have multiple objects living on the scene: these are called instances.

If you have closed this panel, you can open it again by clicking the button in the toolbar:

GDevelop panels can be moved by dragging them to any place on the screen. Simply drag the panel using the title bar.

Objects Groups editor

In the Objects Groups editor, you can find the list of groups of objects that are present in the scene.

To open the editor, click this button in the toolbar:

Object groups contain objects and can be used in events to refer to multiple objects, using a single event. Read more about them on the page about common features for all objects.

Instances editor

The instances editor displays the list of all of an object's instances living in the scene. It can be used to quickly select any instance. In the list, you can see the position, angle, layer and Z order in the scene of any instance.

You can open the Instances editor by clicking this button in the toolbar:

Layers editor

A layer acts as a virtual container for objects displayed on the screen. Objects are drawn on a layer, which is by default the “base layer”, and the layer is then drawn on the screen. A scene can have multiple layers. For example, there can be a layer to display controls on the screen and another layer for a background.

Read more about layers and cameras here.

You can open the layers editor by clicking this button in the toolbar:

Other tools

Toggle/Edit grid

By clicking the grid button in the toolbar, you get multiple options:

  • Toggle mask: this option displays or hides a black border on the scene. It represents the size of the game window.
  • Toggle grid: this option turns the grid off or on within the scene editor. Having a grid is useful when we need to place objects accurately.
  • Setup grid: this option opens a window that allows you to setup the size and position of the grid.

Change editor zoom

By clicking on the zoom button, you can change the zoom level inside the scene editor:

Launch a preview of the scene

By clicking on the “Preview” button, you can launch a preview of your game.

The preview will open in a separate window. Read more about launching a preview here.