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 the Objects 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.

Object properties

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

Using the Properties Editor allows you to change the properties of the selected scene object. Such things as an object's position, scale, and Z-order can be changed using the Properties Editor. You can read more about properties of objects on this page.

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 select any instance from the list to see the instance's position, angle, layer and Z order in the scene.

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.

Launch a Network preview (Preview over WiFi/LAN)

By clicking the “Network preview (Preview over WiFi/LAN)” button, you can preview your game on mobile devices (or any other computer) connected on the same network as the editor:

After clicking the button, a window will appear showing the address the preview is being launched on:

You can now enter the given address in your smartphone browser (or your other computer browser). The preview will load:

Note: You can close the pop-up window in the editor and continue to edit your game. If you launch a new preview, the mobile devices and any connected computer will automatically refresh the game to show the changes made!

Launch a preview with Debugger

A Debugger is a tool that can be used to inspect the content of your game (values of variables, existing instances and their properties…) and even do some real-time editing.

You can launch the debugger using this icon:

See this page to learn more about the Debugger usage.