The Defold scene editor

The Scene Editor is the visual editor used to build and edit scenes such as collections, game objects, and other visual assets.

The initial camera view depends on the resource. 3D resources such as models and glTF scenes default to perspective, while 2D resources such as sprites, tilemaps and GUI scenes default to orthographic. You can change the camera orientation, projection and grid through the scene toolbar.

Opening the Scene Editor

Open the Scene Editor by double-clicking a visual resource in the Assets pane, such as:

Remembered scene views

The editor remembers the camera state for each scene resource when its tab is closed or the editor exits. Reopening the same resource restores its view, so different collections or models can retain different camera positions, orientations and projections.

Visibility filters are also remembered per scene. Hiding models or component guides in one scene does not require using the same filters in another. These are editor view settings and do not change the game’s camera or runtime visibility.

For resources without a saved camera state, model, mesh and glTF resources start in perspective. Collision objects choose their view from the project’s 2D/3D physics setting; collections and game objects choose an initial view based on their scene geometry.

Scene view navigation (camera controls)

The Scene Editor camera can be controlled with mouse and keyboard. The available controls depend on whether you are using the standard camera navigation or Free Camera Mode.

Standard navigation (all visual editors)

These controls are available in visual editors:

You may also use Frame Selection (F) to focus the camera on the current selection.

Axis gizmo

The Scene View Axis Gizmo appears in the bottom-right corner of the scene view in 3D mode. It shows the camera’s orientation relative to the world axes: X is red, Y is green and Z is blue.

Control Action
Left Mouse Click on an axis handle Align the camera to view along that axis. The opposite handles provide views from the other side.
Click an already aligned axis handle Switch to the opposite view along the same axis.
Hold Left Mouse Button and drag the gizmo Orbit around the camera’s current focus point. You can drag from an axis handle or the circular area around the handles, without holding a modifier key.

Axis alignment preserves the camera’s focus point, distance and projection. Use Frame Selection (F) first to focus on an object, then use the gizmo to inspect it from different directions. Standard pan, zoom and Ctrl/^ Control + Left Mouse Button orbit controls remain available.

The gizmo is available with both perspective and orthographic projection in 3D mode. In 2D mode it is hidden; use Align/Realign Camera 2D/3D in the toolbar, or press ., to switch to 3D. Use the separate camera projection toggle to choose perspective or orthographic projection. The gizmo controls the Scene Editor’s view of your scene.

2D and 3D scene orientation

The scene view can be used in both 2D and 3D workflows:

You can access these functions via the toolbar and the View menu. Use the axis gizmo in 3D mode to align the view to an axis or orbit with the mouse.

Toolbar overview

In the top-right of the scene view there is a toolbar with commonly used tools and view options (left to right):

Selecting and manipulating objects

Selecting objects

Left Mouse Click on objects in the main window to select them. The rectangle (or cuboid) surrounding the object in the editor view will highlight with cyan to indicate what item is selected. The selected object is also highlighted in the Outline view as in the picture above.

You can also select objects by:

Move tool

To move objects, use the Move Tool. You can find it in the Toolbar in the top right corner of the scene editor, or by pressing the W key.

The gizmo changes and shows a set of manipulators - squares and arrows (selected manipulator will turn to orange color) that you can Drag to move:

Rotate tool

To rotate objects, use the Rotate Tool by selecting it in the Toolbar, or by pressing the E key.

This tool consists of four circular manipulators (selected manipulator will turn to orange color) that you can Drag to rotate:

Scale tool

To scale objects, use the Scale Tool by selecting it in the toolbar, or by pressing the R key.

This tool consists of a set of square/cube manipulators (selected manipulator will turn to orange color) that you can Drag to scale:

Visibility filters

Click on the Visibility Eye Icon (👁) in the Toolbar to toggle visibility of various component types as well as bounding boxes and guide lines (Component Guides or shortcut Ctrl + H (Win/Linux) or ^ Ctrl + ⌘ Cmd + H(Mac)).

Grid settings

The grid can be customized to match your workflow (especially useful in 3D). Click the Grid Settings button (▦) to open the grid settings popup.

The editor keeps separate grid settings for 2D and 3D views. Set the size, plane and appearance while the desired mode is active; switching modes restores that mode’s grid settings. Reset to Defaults resets the active mode’s settings.

Settings include:

Camera type: Perspective vs Orthographic

The Scene Editor supports both:

Use the camera toggle in the toolbar to switch. In 3D scenes, perspective navigation usually feels more natural.

Free Camera Mode

For fast 3D navigation, the Scene Editor provides Free Camera Mode, a first-person / “FPS-style” camera.

Activating Free Camera Mode

On some keyboard layouts (e.g. Swedish) the backtick key is a dead key and may not trigger the shortcut as expected. You can rebind this shortcut in File ▸ Preferences ▸ Keys and enter a shortcut for Scene -> Free Camera -> Activate

When Free Camera Mode is active the Scene View is highlighted with a line around the edges.

Exiting Free Camera Mode

Looking around (mouse look)

While Free Camera Mode is active, these keys control camera movement (instead of editor tools):

You can also optionally invert the Y axis (see Free camera settings below).

Moving

While Free Camera Mode is active:

All movement keys can be rebound in File ▸ Preferences ▸ Keys. Then search for Scene -> Free Camera

Speed modifiers:

Walking mode (optional)

Free Camera Mode supports Walking Mode.

When enabled:

Camera settings popup

The perspective camera button in the toolbar has a settings popup for camera-related preferences.

The popup contains: