Menu and shortcuts
Every command in the editor menu bar is listed below, grouped by its menu and shown with its keyboard shortcut. Shortcuts use macOS glyphs (⌘ Cmd, ⇧ Shift, ⌥ Option, ⏎ Return). On Windows and Linux, substitute Ctrl for ⌘; the rest of the shortcut is unchanged.
A blank Shortcut cell means the command has no keyboard binding and is accessible only via the menu.
Two kinds of entries are intentionally absent from the tables below:
- The Open Recent submenu is populated at runtime with your recent projects. It exists in the File menu but has no fixed contents to document.
- Developer-only Tools entries (visible only in dev builds of the editor) are excluded.
File
| Command | Shortcut | Notes |
|---|---|---|
| New | Start a new project. (⌘N creates a new node instead; see Keyboard-only shortcuts.) | |
| Open | ⌘O | Open an existing project’s bonsai.json. |
| Save | ⌘S | Save changes. If the project has no on-disk location yet, prompts for one. |
| Save As… | ⇧⌘S | Save to a new on-disk location. |
| Export Runtime JSON… | Validate the project then export a single-file runtime JSON for handoff to the studio’s Unity project. Blocked if validation errors remain. | |
| Export Localization… | Export the localization tables as a CSV bundle for translator handoff. | |
| Import Localization… | Re-import a translated CSV bundle. See Localization. |
Edit
| Command | Shortcut | Notes |
|---|---|---|
| Undo | ⌘Z | Step backward in the per-project undo history. |
| Redo | ⇧⌘Z | Step forward in the per-project undo history. |
| Command Palette | ⌘K | Open the searchable command palette. |
| Find and Replace | ⇧⌘F | Open the Find and Replace panel scoped to the current project. |
View
The first five entries are mode toggles. The active mode is marked with a filled dot in the menu; inactive modes show an open dot. Pressing a mode shortcut while already in that mode returns to the previous view.
| Command | Shortcut | Notes |
|---|---|---|
| Node Graph | ⇧⌘N | Open the Node Graph, where each scene’s nodes are laid out and the Connections and Dependencies between them are drawn. |
| World Graph | ⇧⌘W | Open the World Graph, where the project’s scenes and locations sit together and the Connections between them are drawn. |
| Data View | ⇧⌘D | Switch to the tabular data view (variables, scenes, characters, and so on). |
| Simulator | ⇧⌘P | Switch to the simulator. |
| Tools | ⇧⌘T | Switch to the tools view (path tester, validator, tests). |
| Focus Selection | F | Center the view on the selection, zooming out if it does not fit. With nothing selected, fits everything. Works in the Node Graph and the World Graph, including right after picking an entry in the Sidebar. |
| Fit to Screen | ⌘0 | Fit the whole Node Graph into the view. |
| Zoom In | ⌘+ | Zoom in on the current graph. |
| Zoom Out | ⌘− | Zoom out from the current graph. |
| Toggle Project Tree | ⌘1 | Show or hide the left panel. |
| Toggle Inspector | ⌘2 | Show or hide the right panel. |
| Dark Theme | Force the dark theme. | |
| Light Theme | Force the light theme. | |
| System Theme | Follow the operating system theme. | |
| Settings | Open the editor settings panel. |
Tools
The Tools menu opens the corresponding tool. The Simulator entry also appears in the View menu, where its ⇧⌘P shortcut lives. From the Tools menu, clicking Simulator toggles: a second click returns to the previous view. From the View menu, clicking Simulator only enters simulator mode.
| Command | Shortcut | Notes |
|---|---|---|
| Simulator | Open the simulator. A second click returns to the previous view. | |
| Path Tester | Open the path tester. | |
| Validator | Open the validator. | |
| Tests | Open the tests panel. |
Project
Most Project entries are shortcuts into the data view scoped to a specific entity type. Selecting one switches the editor to the data view for that entity. The two exceptions are Project Settings (opens a separate panel) and Export Scene (writes a portable JSON snippet for the currently active scene).
| Command | Shortcut | Notes |
|---|---|---|
| Project Settings | Open the Project Settings panel. | |
| Export Scene… | Export the active scene as a portable JSON snippet. See Branching dialogue. | |
| Node Graph | Same destination as View → Node Graph. | |
| Scenes | Data view: scenes. | |
| Locations | Data view: locations. | |
| Nodes | Data view: nodes. | |
| Choice Groups | Data view: choice groups. | |
| Media | Data view: media definitions. | |
| Audio Cues | Data view: audio cues. | |
| Variables | Data view: variables. | |
| Characters | Data view: characters. | |
| Activities | Data view: activities. | |
| Tags | Data view: tags. | |
| Items | Data view: items. | |
| Codex | Data view: codex entries. | |
| Skills | Data view: skills. | |
| Time | Data view: time configuration. | |
| Localization | Data view: localization. |
Help
| Command | Shortcut | Notes |
|---|---|---|
| Keyboard Shortcuts | ⌘? | Open the keyboard shortcuts cheat sheet overlay. |
| Update License… | Open the license update modal. | |
| Manual | Open this manual in your default browser. | |
| About StoryBonsai | Show the editor version and credits. |
Keyboard-only shortcuts
These shortcuts have no menu entry. They appear in the in-app cheat sheet (Help → Keyboard Shortcuts, or ⌘?).
| Command | Shortcut | Notes |
|---|---|---|
| New Node | ⌘N | Add a node to the active scene and select it. |
| Copy Node | ⌘C | Copy the selected node or nodes. |
| Paste | ⌘V | Paste copied nodes into the active scene, with jumps and references between pasted nodes re-linked to the copies. |
| Duplicate Node | ⌘D | Copy and paste in one step. |
| Delete Node | ⌫ | Delete the selected node or nodes. Selected Connections take priority: if any are selected, Delete removes those instead. |
| Select All Nodes | ⌘A | Select every node shown on the Node Graph. |
| Previous Result | ⌘G | Step backward through Find and Replace results while the panel is open. |
| Next Result | ⇧⌘G | Step forward through Find and Replace results. |
| Find in World Graph | ⌘F | Open the World Graph finder overlay (World Graph only). |
| Deselect / Return | Esc | Clear the selection. An open menu or overlay closes first, then an in-progress drag cancels, then the selection clears. In the tools view, returns to the previous view instead. |
Zoom In, Zoom Out, and Fit to Screen respond to their keyboard shortcuts only while the graph has focus; click the graph first, or use the View menu. Focus Selection (F) works from anywhere, including right after clicking an entry in the Sidebar.
See also
- Error messages: Export is blocked by unresolved errors: panel-driven dialog when File → Export runtime JSON is blocked by any Error row.