Manual

Manual

The Scene view

The Scene view is your view of the scene, through the editor's own camera rather than the game's. This page covers moving around it, picking what is in it, moving, turning and resizing what is picked with handles and the Rect tool, snapping, the draw modes and the grid, the 2D view, the orientation gizmo, and dropping files into the scene. Open it with Window ▸ Scene (Ctrl+1).

On a Mac, Cmd takes the place of Ctrl in every shortcut on this page.

The row of tools

A row along the top of the panel holds the tools and how the scene is drawn. Resting the pointer on a button says what a click will do.

ButtonKeyWhat it does
MoveWMoves what is picked, by arrows and squares
RotateETurns what is picked, by circles
ScaleRResizes what is picked, by axes ending in cubes
RectTMoves, turns and resizes by a rectangle round what is picked; see The Rect tool
Center or PivotZPuts the handle at the middle of what is picked, or at the entity picked last
Local or GlobalXTurns the handle as the entity picked last is turned, or as the world is
The magnetSnaps without Ctrl; see Snapping
The arrow beside the magnetOpens the steps the handles snap to
2D LightsLights the scene by its 2D lights, as the game draws it, or shows its art unlit
GridDraws the world's grid, or hides it
BonesDraws every skin's bones over the scene
2D2Switches the 2D view on or off; see The 2D view
Wireframe, Shaded Wireframe, ShadedHow the scene is drawn; see Draw modes

While exactly one entity with a Tilemap is picked, the tools for painting it come after Rect: Select (S), Paint (B), Rectangle (U), Fill (G), Erase (D) and Pick (I). See Tilemaps.

The tool keys work wherever the keyboard is, except while you type, while the camera flies, or while the playing game has the keyboard. They go by where the key is on the keyboard, so they work with any keyboard layout. The editor keeps the draw mode, 2D Lights, Grid, Bones, the 2D view and the magnet as you left them.

Move around

Do this in the Scene viewTo
Hold the right mouse buttonFly: the mouse turns the camera, W, A, S and D move it, E goes up and Q down
Alt and drag with the left buttonOrbit round the pivot
Drag with the middle buttonPan, four times faster with Shift
Alt and drag with the right buttonZoom in and out
Turn the wheelZoom toward the pivot, or toward the pointer with Alt
Arrow keysMove the camera, while the Scene view has the keyboard
F, or a double-click on a row in the HierarchyFrame what is picked
Keypad 5Switch between perspective and orthographic

Flying. A move starts at 9 meters a second and goes 1.8 times faster for every second it goes on. Shift makes it five times faster. The wheel, while you fly, sets the speed, from 0.01 to 2 times; the speed is shown in the middle of the view for a moment, such as 0.50x. The pointer is hidden while you fly and comes back where it was. Escape stops flying. In an orthographic view, the right button orbits instead of flying.

Framing. F moves the pivot to the middle of what is picked and what is under it, and backs the camera off until all of it is in view, keeping the way the camera faces. The camera eases there in half a second; any move of your own stops it.

Orthographic. The camera narrows its field of view as it switches, and draws orthographic once the view is nearly flat. Zooming an orthographic view changes how much it shows.

Each scene is looked at from where you left it, in 2D or 3D as it was. The editor keeps this in your game's cache/scene-views.json, which version control leaves out, so a scene renamed or moved keeps it.

Pick what is in the scene

Click something to pick it. The Hierarchy opens to it and scrolls to it.

  • Click again at the same spot to go further: the first click picks the outermost instance of a prefab under the pointer, the next the entity itself, then each one under it in turn, back to the first.
  • Shift+click adds to what is picked.
  • Ctrl+click adds or takes away.
  • Click on nothing lets go of everything.

What can be picked is what is drawn: nothing hidden, switched off or on a layer the camera leaves out, and not the back of a one-sided surface. A sprite is picked where its image shows, not in its clear corners. A light's or a camera's icon is picked before what is behind it.

Pick with a rectangle

Drag from empty space to draw a rectangle. As you drag, it picks everything with a part showing inside it: an instance of a prefab whole, and the light and camera icons it touches, but nothing hidden behind something else.

  • Shift adds what it covers to what was picked.
  • Ctrl takes it away.
  • Escape puts back what was picked before.

Keys

While the Scene view has the keyboard, these act on what is picked, as in the Hierarchy: Delete (Cmd+Backspace on a Mac), Ctrl+D to duplicate, Ctrl+X, Ctrl+C and Ctrl+V to cut, copy and paste, Ctrl+Shift+V to paste as a child, and Ctrl+A to pick everything. See The Hierarchy.

Move, rotate and scale

The handle of the Move, Rotate or Scale tool is drawn on what is picked, the same size on the screen however far away it is. X is red, Y green and Z blue. The part under the pointer is drawn stronger, and the part you hold turns yellow. An axis that points nearly straight at the camera fades out and cannot be held.

ToolIts handleDrag
MoveAn arrow along each axis, and a square across each pair of axesAn arrow moves along its axis, a square across its two. With Shift held, a square in the middle moves across the view.
RotateA circle about each axis, an outer circle, and the space insideA circle turns about its axis, the outer circle about the way the view faces, and the inside freely.
ScaleAn axis ending in a cube for each axis, and a cube in the middleAn axis scales along itself, and the middle cube scales evenly.

Dragging changes everything picked: each entity moves from its own parent, and one under another picked entity goes with it. With Pivot, each entity turns and scales about itself; with Center, about the middle of them all.

A drag is one Ctrl+Z. Escape, while you hold the drag, puts everything back as it was.

There is no handle on the top entity of a prefab open on its own, since each instance places it, nor on a model's prefab, nor while you edit a component's shape or paint a Tilemap.

Snapping

Hold Ctrl while you drag a handle to snap it to steps, the same at every zoom:

ToolStep, to begin with
MoveA quarter of a meter along each axis it moves along
Rotate15 degrees about the circle's axis
ScaleA tenth; scaled evenly, the largest axis lands on it

A move lands the entity picked first on a multiple of the step, in its Position as the Inspector shows it, so a child lands in its parent's units. Along an arrow that lies along none of its parent's axes, it moves by whole steps instead. Everything else picked moves with the first. Let go of Ctrl during the drag and it goes free. The inside of the Rotate circles never snaps.

The magnet snaps without Ctrl, and Ctrl then lets a drag go free. The arrow beside it opens the steps: Move in meters, Rotate in degrees and Scale, each a number to drag or type. The project keeps them in settings/snapping.json, for everyone working on it, and a built game never carries the file.

The Rect tool

The Rect tool (T) draws a rectangle round what is picked: across a sprite's own X and Y, and across the two axes of anything else that the camera sees most of. Several picked share one rectangle. The rectangle fades as it turns edge on.

DragWhat it does
A cornerResizes from the opposite corner
A sideResizes one way
Just outside a cornerTurns about the pivot
The insideMoves, once the pointer has gone three pixels; a shorter press picks what is under it
The pivot's circleOn one sprite, moves its Pivot, the image staying where it is; on anything else, moves where the tool turns and resizes about

Hold keys while you drag to change what it does:

  • Shift keeps the proportions as you resize, turns by 15 degrees, and moves along one side.
  • Alt resizes about the pivot.
  • Space resizes a sprite by its scale instead of its Size.

A sprite is resized by its Size, whatever it is drawn as, and keeps its scale. What follows a sprite's size, such as a 2D collider on it, follows. Anything else is resized by its scale. A sprite's pivot keeps to the nine places of its rectangle, the corners, the sides' middles and the center, when it is near one.

The Rect tool's move and turn snap as the handles do, a snapped turn landing on the Rotate step in place of Shift's 15 degrees. Its resize does not snap. A drag is one Ctrl+Z, and Escape while you hold it puts it back.

Dots on shapes

A picked light, camera and some other components draw their shape, with dots on it to drag:

PickedIts dots set
Point lightIts range
Spot lightIts range, by the dot in the middle of its end, and its angle, by the four round it
CameraIts field of view, or the size of an orthographic one
Audio SourceIts min and max distances
Particle EmitterThe numbers of its shape, such as its radius or angle
Point Light 2DIts range, inner range and angle
Camera Bounds 2DIts width and height

The shape follows the dot as you drag it. A drag is one Ctrl+Z, and Escape puts it back.

Edit a component's shape

Some components have a button at the top of their section in the Inspector to edit them in the Scene view, such as Edit Collider on a physics collider, Edit Joint on a joint, Edit Points on a Line, and Edit Link and Edit Volume in the Navigation package. While it is on, the tools' handles are hidden and the component's dots are drawn instead:

  • Drag a dot to move it.
  • Click a line between dots to add one there, and drag it on.
  • Hold Ctrl to show which dots can go, in red, and click one to delete it.
  • Points such as a joint's anchors get a Move handle of their own, which snaps as the Move tool does.

The button again, Escape in the Scene view, picking a tool or picking something else stops it. Each drag is one Ctrl+Z.

Draw modes

The three buttons at the right end of the row draw the scene Shaded, the default, as a Wireframe, every edge of every triangle in white, or Shaded Wireframe, the edges faint over the shading. They change the Scene view alone: the Game view draws as the game does. Where the graphics card draws no lines, the two wireframes are grayed and say why.

The grid

Grid draws lines across the ground a unit apart, every tenth stronger, fading out round the camera and hidden behind what stands on them. Close to the ground they are a tenth of a unit apart, and ten or a hundred units far from it. In the 2D view the grid stands on the XY plane. It is the Scene view's alone, never a game's.

Icons, outlines and shapes

Each light has an icon in its own color, each camera a gray one, and audio sources, particle effects and camera bounds have icons of their own, the same size however far away. Click an icon to pick what it stands for.

What is picked is outlined in orange round the shape it makes on the screen, through whatever is in front of it, and what is under it in blue-gray. A picked light shows its reach, a sphere, a cone or a sun's rays, and a picked camera shows what it sees.

Bones draws the bones of every skinned mesh over the scene, a dot at each joint. Click a bone or a dot to pick its joint.

The 2D view

Press 2, or click 2D, to look at the XY plane from the front: orthographic and without turning, +Y up. In the 2D view:

  • the right button, and Alt with the left, pan;
  • the wheel zooms toward the pointer, or toward the pivot with Alt;
  • the Up and Down arrows move the view up and down;
  • the orientation gizmo is hidden.

Press 2 again to go back to the 3D view it left. A scene made from the 2D template opens in the 2D view (see Make, open and save scenes).

2D Lights switches between the scene lit by its 2D lights, as the game draws it, and its art unlit, to see it while you work. See 2D lights.

The orientation gizmo

The gizmo in the top-right corner shows which way the view faces: a cube with a cone on each side, the +X, +Y and +Z cones red, green and blue. The word under it names the side you look from, such as Top or Front, or says Persp or Iso when the view is not straight along an axis.

Do thisTo
Click a coneLook at the scene from that side
Shift+click or middle-click a coneLook from that side, orthographic
Click the cube or the wordSwitch between perspective and orthographic
Shift+click or middle-click the cubeLook from a little above, in perspective
Double-click the cubeFrame what is picked
Right-click the gizmoPick Free, Right, Top, Front, Left, Bottom, Back or Perspective from a menu
Click the padlockLock the view's turning, so the right button and Alt pan it; click again to unlock

Drop files into the scene

Drag a file from the Project panel into the Scene view:

FileWhat happens
A prefab or a modelAn instance is placed on what is drawn under the pointer, or on the ground where nothing is; in the 2D view, on the XY plane
An image, or one slice of an imageA sprite that draws it is made, on the XY plane under the pointer in the 2D view, or at the camera's pivot in 3D
Several images or slices togetherA sprite that plays them as frames is made; see Sprites
A materialIt is given to the mesh under the pointer

Inside a prefab open on its own, what you drop goes under its top entity. Where a drop cannot happen, the pointer says why. See Make a prefab and place instances.

Drawing from your code

Lines your game draws for whoever edits it appear in the Scene view, not in the Game view or a built game. A system in a plugin marked [EditorOnly] draws with context.Gizmos and reads what is picked from context.Selection; a game's Rust draws with Bevy's Gizmos. See Plugins and Rust in a game.

While a picked Particle Emitter plays as the scene is edited, a small overlay in the bottom-right corner has a button to play or pause it, Restart and Stop, with its Playback Time and how many Particles it has. See Particle Emitter.

In the Scripting API