Skip to main content

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:

CommandDescription
/dialogCharacter dialog line
/narrationNarrator text
/sfxPlay a sound effect
/bgmBackground music control
/waitPause (timed or click-to-continue)
/effectScreen effect (shake, flash, fade, tint)
/portraitChange a character's displayed portrait
/backgroundChange the scene background
/enterCharacter enters the stage
/exitCharacter leaves the stage
/notifyShow a popup notification
/add_itemGive an item to the player
/remove_itemTake 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), or system (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.

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.

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

ShortcutAction
Alt+UpNavigate to the previous block
Alt+DownNavigate to the next block
Ctrl+Shift+UpMove the focused block up
Ctrl+Shift+DownMove the focused block down
Ctrl+Shift+BackspaceDelete the focused block
Ctrl+Alt+UpJump to the previous Sequence node
Ctrl+Alt+DownJump to the next Sequence node
/Open slash command palette (at start of empty block)
Ctrl+ZUndo
Ctrl+Shift+ZRedo