Editor

The Hierarchy

EditorPreview

Editor docs

The Hierarchy shows the open scene's entities as a tree: create, select, rename, reparent, copy and delete them here, or drop assets onto it to place them. Every change is one step on the scene's undo history. The editor is a preview.

Preview: the Create menu, asset drops, Cut and Paste as Sibling shipped on 15 November 2026 and have not yet been through an end-to-end test pass or tried in a running editor.

Create an entity#

The + button in the Hierarchy's header opens the Create menu:

  • As child of selection, a check box, off by default and unavailable with nothing selected: when it is on, the new entity is a child of the selected one; otherwise it is a root.
  • Empty Entity and Empty Child.
  • The objects below, grouped. The menu lists an object only when the open project registers its component, so a project without audio, say, has no Audio Source.
GroupObjectWhat it creates
3D ObjectBox, Sphere, Plane (vertical), Ground, CylinderA MeshRenderer whose mesh is the primitive's file in assets/primitives/ (below), with the default material. Box, Sphere and Cylinder rest on y = 0.
LightDirectional, Point, Spot, Hemispheric LightA Light of that type. The directional light takes the 3D templates' sun angle; the point and spot lights stand 3 m up, and the spot light points down. From engine 0.20.0 its Bake mode starts as realtime.
CameraCameraA Camera, or a Camera2D in a 2D scene.
2DSpriteA SpriteRenderer with no atlas yet.
RenderingLight Probe Volume, Reflection ProbeThe component with its defaults. See Baked lighting.
AudioAudio SourceAn AudioSource with its defaults.

Each object is one undo step. The components its component requires are added with it, as Add Component adds them. The new entity is named after the object, with (1), (2)… when a sibling already has that name, and is selected.

Edit → Create Object lists the same objects, one submenu per group (Edit → Create Object → 3D Object → Box and so on), and creates them at the root.

Primitive mesh files#

The engine has no built-in mesh setting on a MeshRenderer: its mesh is an asset. So the first time you create a Box, the editor writes assets/primitives/box.mesh.json (and likewise sphere, plane, ground and cylinder), and every Box after that uses the same file. A file already there is used as it is, so if you edit one, every object that uses it changes. Their sizes:

ObjectSize
Box1 m on each side
Sphere1 m across, 32 segments
Plane1 × 1 m, standing upright
Ground10 × 10 m, flat on the XZ plane
Cylinder2 m high, 1 m across, 24 sides

Drop assets onto the Hierarchy#

Drag an asset from the Assets panel onto a row to make it that entity's child, or below the rows to make it a root. It makes the entity a drop on the scene view makes: a glTF model, a .mesh.json, a sprite atlas or a prefab instance, at its parent's origin, selected. An asset the Hierarchy cannot place is refused, with the reason.

Dragging rows still reparents and reorders them; hold Alt (Option) while dropping to keep an entity's local transform.

Commands and keys#

The keys work while the Hierarchy has the focus. The Edit menu holds the same commands. On Windows and Linux it shows the keys of Create Empty Entity, Create Empty Child, Duplicate, Delete, Cut Entities and Paste Entities as Sibling; it shows none for Copy Entities and Paste Entities, and none at all on macOS.

CommandKeys
Create Empty EntityShift+Ctrl+N
Create Empty ChildAlt+Shift+Ctrl+N
DuplicateCtrl+D
DeleteDelete or Backspace
Cut EntitiesCtrl+X: copies the selection, then deletes it
Copy EntitiesCtrl+C
Paste EntitiesCtrl+V
Paste Entities as SiblingShift+Ctrl+V: right after the selected entity, under the same parent

Cut is one undo step for the delete. If the scene changes while the editor writes the clipboard, Cut deletes nothing and says so. Duplicate and Paste rename a copy that would share its name with a sibling: Player becomes Player (1).

Undo after clicking a check box, such as an entity's active toggle, now undoes the scene's last step instead of doing nothing. Text fields keep their own undo.

On macOS the keys use ⌘ where this page says Ctrl.

Known limitations#

  • Plane stands upright, as its label says: the engine's plane is a quad facing −Z, not a floor. Use Ground for a floor.
  • The primitives are written under assets/primitives/. If you delete one, the next object that needs it writes it again.
  • There is no Capsule or Torus yet.
  • Edit → Create Object always shows every object and creates at the root. An object whose component the project does not register is refused, with the reason.
  • On engine 0.19.0 the light-probe bake skips primitives, so the Create menu's 3D objects neither cast nor bounce light into baked probes. From engine 0.20.0 the bake traces them.
  • Agents create the same objects with ignifx_create_entity, but for a primitive an agent must name a .mesh.json itself (see Agents and MCP).