Editor
The editor is where a game is made: a hierarchy, an inspector, a scene view with move, rotate, and scale tools, an asset browser, undo and redo, and a play mode that runs the game inside the editor. It runs in the browser. In a Project online, several Members work in it at the same time, and ask an Agent to build.
Start here
Section titled “Start here”- Start a Project: sign in, and make a Project from a name.
- Your first scene: ten minutes through the editor by hand.
- The Agent: ask for something to be built, and see what it cost.
- Checkpoints and Versions: the Project as it was before each Run, and at moments you named.
- Working together: invite someone, and see where they are.
What you can do
Section titled “What you can do”| Area | Available now |
|---|---|
| Scenes | Open and edit. Every change is written to the Project by itself: there is no save step in a Project online. |
| Entities | Create, rename, delete, duplicate, copy, cut, paste, reparent, and reorder. A reparented entity stays where it is in the scene. Switch one off with the eye at the end of its hierarchy row, or On/Off beside its name in the inspector: off, its systems skip it and everything under it, and they aren’t drawn; it stays in the scene, and is saved off (Switched off). One undo step each. |
| Components | Add (type to search), remove, reset, and edit fields; copy a component’s values to another entity. Field widgets follow the component’s schema and metadata. With several entities selected, the inspector shows the components they share and an edit applies to all of them. |
| Scene view | Pan, zoom, frame, click and marquee selection (click again to reach what is underneath), move, rotate, and scale handles with snapping, and the Pivot tool (Y), which moves the point an entity turns about and leaves its picture where it is. The Path tool (P) draws a Path: a click adds a point, a press dragged curves it, Alt-drag makes a corner, and Close the Path joins its ends; Follow path puts another entity on it, as far along as its Progress, which is keyed like any field. The Collider tool (C), there while an entity with a collider is chosen, sizes a box or circle collider by its handles and moves its offset by the ring in the middle: Alt sizes from the middle, Shift keeps a box’s proportions; a solid collider is drawn green, one whose Trigger is on dashed orange. Fit Collider to Sprite, beside it and in a collider’s ⋯ menu, sizes the collider to the sprite’s picture and centres it there; a collider added to an entity with a picture starts fitted. Its tools are in its top right corner. |
| Assets | Folders on the left (All assets, the Project’s folders, In code for prefabs of the project’s code), the files of the folder chosen in the middle, and a preview on the right. A prefab shows its picture and a texture its image; the slider sets their size, and at its smallest the files are a list with their kind and path. The preview shows a prefab’s or a scene’s entities, a sound’s waveform and length, a clip as its timeline. Open a scene, pick assets in component fields, find a file in every folder by name. Create folders and scenes, import files, rename, move (drag a file onto a folder), replace a file, and delete; the right-click menu’s + New opens the list the + New button does. Scenes, prefabs, presets, tilesets, clips and effects that refer to a moved asset are updated. A broken scene or prefab file is marked and reported. Files the Project names that are not there, as after a file is deleted or moved outside the editor, are listed above the files, each once, with the files that name it; a field that names one says Missing. A prefab file that instances follow, or that a clip is made on, is listed too, with what is lost: the instances follow nothing, the clip has no rig (Missing and moved files). |
| Prefabs | Open a prefab file and edit it like a scene. Add a prefab to a scene, from a file or from the project’s code, by dropping it on the scene view or on an entity in the hierarchy. Instances of a prefab file follow the file, except in what they changed and where they stand (their root’s position and rotation are their own); the inspector marks those fields and can revert them or apply them to the prefab. Create a prefab from an entity. |
| Scripts | Make a component or a system in the Scripts panel and write it in the Code panel, with types and completions. The project’s other code, such as src/project.ts and vite.config.ts, is under Core in the Scripts panel, to read. A string that names a file not in the asset folder is underlined as a warning (Missing and moved files). |
| Animation | New Animation in the Assets panel makes a clip file. The Timeline panel shows, plays and edits the selected entity’s clip: its tracks, its keys and their eases. Animate (in the Timeline, under an Animator in the Inspector, or a clip opened in the Assets panel) opens the clip in a tab of its own beside Scene: the scene view over the clip with the Timeline under it. In Animate what you change with the tools or the Inspector is a key at the playhead and the scene is not changed, and each row of the Inspector ends with a diamond that keys it; in Setup it is an edit of the scene, and the Inspector shows no keys. With Auto key off a change is a pose until K keys it, and moving the playhead drops it. Alone draws only the animated entity. Bring forward and Send back change a part’s place in the draw order (its z): in Animate as a key that steps at the playhead. The Rig panel beside the Hierarchy hides a part in the editor (the game still draws it) or locks it so that a click passes it by. Onion skin shows the poses before the playhead in blue and after it in orange, and Motion trail the path of the selected part, whose squares you drag to move its keys. See Clips. |
| Undo | Every change to the scene is one undo step, including drags and the order of root entities. Undo takes back your own steps, not another Member’s. Moving, renaming and deleting files in Assets and Scripts is one step too, however many you chose (Shift, Cmd/Ctrl): undo puts them back, deleted ones from the trash. |
| Play | Play, pause, step, and stop the game in a Game view, with live values in the inspector. The console filters by level and source. |
| Appearance | Twenty-seven Themes: four of the editor’s own (Ink Light by day and Ink Dark by night, by default) and the known ones (Solarized, Gruvbox, Dracula, Nord, GitHub, One, Rosé Pine, Everforest, Ayu, Night Owl, Monokai, Tokyo Night, Catppuccin). Three Shapes (Sharp, Soft, Round), chosen apart from the Theme in a popup of their own. |
| Project Settings | File › Project Settings… (Mod+,): the Project’s settings, one of each kind, such as the physics’ gravity and layers, the UI’s scaling and the splash, and your own scripts’ (This Project). Each field as the Inspector draws it, a search over all of them, and Reset to defaults. A change reaches a game that plays, is saved, and is one undo step. |
| Preferences | Rebindable shortcuts with conflicts flagged (Shift+Mod+,). |
| Menus | Some entries are in a submenu, such as Entity › Create › Empty Entity. The pointer over it opens it, or a click; with the keys, → or Enter opens it and ← or Esc closes it. The command palette finds every action by its whole name: “create entity” finds Create Empty Entity. |
| Panels | View › Panels turns off what you do not use. Console, Scripts and the Agent start on; History, Systems, Save and the Gamedoc start off. The Timeline is not among them: it comes with an Animate tab in front, and goes with it. A panel turned on is back where it was, and opening it another way turns it on. Reset Layout brings back the starting set. |
| View | View › Gizmos switches the scene view’s Grid and each gizmo layer that is drawn on (such as Colliders). View › Game View switches FPS, the frames per second over a game that plays, which is off until switched on. |
| Layout | Drag a panel by its tab: among the tabs of another group, to an edge of a group to split it, or to an edge of the editor. The menu on a tab (right-click, or Shift+F10) does the same from the keyboard. The layout is remembered; View > Reset Layout takes it back. |
Settings and presets
Section titled “Settings and presets”Settings are numbers the whole game shares: one of each kind in a Project, set in File › Project Settings…. They start at their defaults, and the first change writes their file in the settings folder; the Assets panel does not show it. Code reads them with resources.get('settings').get(GameSettings). New › Settings in the Scripts panel makes a kind of your own; it shows under This Project, with Open script.
Presets are many values of a kind, each found by its name, such as a shop’s prices or a terrain’s data: .preset.json files, made with New › Preset… in the Assets panel and edited in the Inspector. An entity points at one with an asset field.
Adding files from your computer
Section titled “Adding files from your computer”Drag files, or whole folders, from your computer onto any part of the editor. They go into the folder chosen in Assets, or into the folder whose row you drop them on (“Drop into park/”). A folder keeps its layout.
- The files are added one at a time, and a note shows how far it has come. Stop the rest keeps what has been added so far.
- Names that are taken are asked about once, for all of them: Skip them, Keep both (adds “bench 2.png”) or Replace, which keeps every scene that uses the file pointing at the new one.
- A file of a kind the game doesn’t use, or one over 32 MB, is left out, and the message says which.
- Undo in the message, or Cmd+Z, takes the whole drop back. New files are marked “new” in Assets until you choose them.
- + New ▸ Import files… in Assets adds files the same way, from the keyboard too.
- To put a file of another name in place of one, as hero_v2.png for hero.png, right-click the file in Assets and choose Replace…. The file keeps its name and folder, so every scene and tileset that uses it shows the new one. It takes a file of the same ending, and Cmd+Z puts the old one back.
Play mode
Section titled “Play mode”Play builds a second world from the Project, the way the game itself starts: its engine and plugins, startup systems, then the scene as it is in the editor. It renders in the Game view. Stop disposes that world.
- The scene you are editing is never touched by play, so there is nothing to restore when it stops.
- While playing, the hierarchy and the inspector show the running game with live values. Changes made there take effect at once and are not kept: they are gone when play stops.
- Undo history is unaffected by a play session.
- Warnings and errors the game writes to the browser console also appear in the editor’s Console, marked
play. - In a Project with a shared scene (
sharedScene), play loads it first, then the scene you are editing as the level. With the shared scene open, it plays the shared scene and the first level. The hierarchy shows each loaded scene as a heading, the active level marked, and what the game spawns under the scene it belongs to. A level change to the scene you are editing plays it as it is in the editor, unsaved changes included. - Click the Game view to give the game the keyboard. Editor shortcuts are then off, except the play controls;
Escapehands the keyboard back.
Keyboard
Section titled “Keyboard”Mod is Cmd on macOS and Ctrl elsewhere.
| Keys | Action |
|---|---|
Mod+S | Save the open script, in the Code panel |
Mod+K | Command palette: find and run any action by name |
Mod+, | Project Settings |
Shift+Mod+, | Preferences: keyboard shortcuts |
Mod+. | Appearance: the Theme and the Shape |
Mod+Z, Shift+Mod+Z | Undo, redo |
Mod+C, Mod+X, Mod+V | Copy, cut, paste entities |
Mod+D | Duplicate |
Delete or Backspace | Delete |
Shift+Mod+N | Create an empty entity |
F2 | Rename the focused hierarchy row |
Alt+Up, Alt+Down | Move the selected entities among their siblings |
Shift+Alt+Right, Shift+Alt+Left | Move into the entity above, move out of the parent |
Q, W, E, R | Select, move, rotate, scale tool |
X | Toggle local axes |
F, Shift+F | Frame the selection, frame everything |
Middle drag, or Space + drag | Pan the scene view |
Mod+P | Play, stop |
Shift+Mod+P | Pause, resume |
F10 | Step one frame |
Escape | Cancel a drag or a field edit; otherwise deselect |
These are the defaults; every shortcut can be changed, removed, or reset in Preferences (Shift+Ctrl/Cmd+,). Keys typed in a text field belong to the field. In the hierarchy, a letter jumps to the next entity starting with it.
Running the editor on your own machine
Section titled “Running the editor on your own machine”A developer with the engine’s packages adds the editor to a project of their own: see Project setup. There a scene is saved with Mod+S, to a file of the project.