Write Mode
Write Mode is a focused text editing environment for authoring the content inside Sequence nodes. Switch to it by double-clicking a Sequence node, pressing Enter on a selected Sequence node, or clicking "Write" in the mode switcher.
The Block Editor
Write Mode presents sequence content as a vertical list of blocks. Each block corresponds to a single step in the sequence. Blocks come in two forms:
- Text blocks — Dialog and narration steps. These use a rich text editor where you type and format content directly.
- Action blocks — Compact one-line representations for SFX, BGM, wait, effects, portrait changes, enter/exit, notify, and item operations. These show a summary of the step's configuration with inline controls.
Blocks are displayed in execution order, top to bottom. Each block has a drag handle on the left and a type indicator icon.
Slash Commands
Type / at the beginning of an empty block to open the command palette. There are 13 block types available:
| Command | Description |
|---|---|
/dialog | Character dialog line |
/narration | Narrator text |
/sfx | Play a sound effect |
/bgm | Background music control |
/wait | Pause (timed or click-to-continue) |
/effect | Screen effect (shake, flash, fade, tint) |
/portrait | Change a character's displayed portrait |
/background | Change the scene background |
/enter | Character enters the stage |
/exit | Character leaves the stage |
/notify | Show a popup notification |
/add_item | Give an item to the player |
/remove_item | Take an item from the player |
Type to filter the list, then press Enter or click to insert the block.
Dialog Blocks
A dialog block has:
- Character — Select from the characters defined in your project.
- Portrait — Choose which portrait (expression) to display.
- Text — The dialog line, editable with rich text formatting.
- Voice file — Optional audio asset for voice acting.
The character and portrait are selected in the right-side Inspector panel when the block is focused. The character's name color is displayed inline.
Narration Blocks
A narration block has:
- Text — The narration content, editable with rich text formatting.
- Style — One of three styles:
default,thought(typically italicized), orsystem(monospace font).
Rich Text Editor
Dialog and narration blocks use a rich text editor that supports inline formatting. You can apply bold, italic, color, and text effects using the toolbar or tag syntax. Variable interpolation works in all text fields: {playerName} will display the variable's value at runtime.
Drag Reorder
Blocks can be reordered by clicking the drag handle on the left side of any block and dragging it to a new position. A drop indicator shows where the block will land.
Character and Portrait Selection
When a dialog block is focused, the Inspector panel on the right shows:
- A character picker with all defined characters.
- A portrait grid showing all available portraits for the selected character.
- Click a portrait to assign it to the current dialog step.
Sidebar
The left sidebar in Write Mode shows:
- Node list — An ordered list of Sequence nodes in your project, sorted by graph traversal order (the order they would execute starting from the Start node). Click a node to switch to editing it.
- Word count and stats — A summary of the current sequence's content: total words, dialog lines, narration blocks, and action steps.
Breadcrumb Navigation
A breadcrumb bar at the top shows your current position: project name, subgraph (if any), and the current Sequence node. Click any breadcrumb to navigate to that level.
Keyboard Shortcuts
| Shortcut | Action |
|---|---|
| Alt+Up | Navigate to the previous block |
| Alt+Down | Navigate to the next block |
| Ctrl+Shift+Up | Move the focused block up |
| Ctrl+Shift+Down | Move the focused block down |
| Ctrl+Shift+Backspace | Delete the focused block |
| Ctrl+Alt+Up | Jump to the previous Sequence node |
| Ctrl+Alt+Down | Jump to the next Sequence node |
| / | Open slash command palette (at start of empty block) |
| Ctrl+Z | Undo |
| Ctrl+Shift+Z | Redo |