Skip to content

The writing surface

The centre column is where you write. It reads like a film script, character cues, dialogue, and stage directions, and you type into it much like a good word processor. A lot of what makes it fast stays out of sight until you want it; this page walks through the whole thing.

A run of dialogue and narration that plays together is a snippet, drawn as a soft rounded card, a “bubble”. Quiet space sits between bubbles, so the shape of a scene reads at a glance without the page turning into boxes and lines.

A snippet bubble showing the three beat kinds: dialogue lines with a coloured GUIDE cue, a speaker-less prose line, a line carrying a (warmly) direction, and a game-event chip, with a jump to The Crossroads at the foot.
One snippet "bubble" holding all three beat kinds: lines (a coloured GUIDE cue beside the words), a text beat (prose with no speaker), a line carrying an inline (warmly) direction, and a silent ⚙ game event. The ↪ The Crossroads chip is a jump; the grip reorders the bubble and opens its action menu.

Inside a bubble are beats, and there are only three kinds:

  • a line: someone speaks, with their name beside the words;
  • a text beat: narration or description, with no speaker;
  • a game event: a silent cue to your game (play a sound, move the camera) that the player never sees.

A character’s name is a coloured tag, not something you retype each time. Each character keeps their own colour, so you can see who’s speaking as you skim. An empty line shows a faint <character>: until you name a speaker.

Click or arrow into a name and a small picker opens:

  • type to filter your cast;
  • ↑ / ↓ to move through the matches;
  • Enter or Tab to accept the highlighted name;
  • + Add "<name>" adds someone new;
  • Esc (or a click away) closes it.

Anyone you name is added to the cast for you, so there’s no cast list to set up first.

Most of writing is just typing. These keys cover the rest:

KeyWhat it does
EnterA new line in the same bubble
Shift-EnterStart a new bubble
TabTurn a plain line into dialogue (and open the name picker); also finishes a name or a (direction)
⌘T / Alt-TSwitch the current line between dialogue and narration, keeping the words
Space at the start of a lineTurn it into plain narration
()Add an inline (direction) to a spoken line
⌘B / ⌘IBold / italic the selected words

You rarely need to memorise these: the hint bar along the bottom always shows the few keys that matter right where your cursor is.

A direction is a note to the performer that the player never hears, like (warmly) or (under her breath). Write it in round brackets inside a spoken line. It isn’t part of the spoken words, so it’s never translated or voiced; it’s just guidance for whoever reads the line.

Bold and italic are available when formatting is turned on for the project (Project Settings ▸ General); names and directions always stay plain. Your styling travels with the words into every language and on into your game, which draws it in its own style.

A direction is not the same as a closed caption. An inline caption uses square brackets, [sighs], and is shown to the player unless they switch captions off; a (direction) is only ever for the performer and the player never sees it. That’s a writer’s call, covered in Closed captions ▸ Authoring.

Pasting a block of dialogue lays each line out as its own beat automatically.

Beyond the usual arrows and clicks, two things are worth knowing:

  • The left and right arrows walk through a line a piece at a time, name, direction, words, and carry on to the next line at the end.
  • Undo and redo (⌘Z / ⇧⌘Z) cover everything, including structural changes like splitting or reordering a bubble, so you can always step back cleanly.

You rarely need a menu to add something:

  • A ”+” in the gap under a bubble adds another bubble.
  • An empty bubble shows a faint ”+”; click it to start writing.
  • On a blank line, / opens a quick menu: add a game event or a jump, split here, or follow on with a snippet, a branch, a choice, or one of the sequence presets (once each, cycle, or shuffle).

The full set of structural tools, choices, selectors, jumps, and the ⋯ menu, lives in Structure & branching.

You can grab whole bubbles and groups, one or many:

  • Shift-click to select a range.
  • ⌘ / Ctrl-click to add or remove one at a time (so you can pick, say, the first, second, and fourth).
  • Click the empty background to clear the selection.
  • With something selected, deletes it (with a quick confirm), and right-click ▸ Wrap in groups it.

To reorder, grab the grip on the left and drag a bubble, group, or block; the page opens a gap to show where it will land, and Esc cancels mid-drag. Dragging an option out of a choice turns it back into a plain bubble.

  • The scene title at the top is editable in place. Right-click it for a scene note, or to set the writing status of the whole scene at once.
  • Each block is a section with its own heading (which also names the place jumps land). ”+ block” adds another, the grip reorders, and right-click adds a note.

Once the scene title scrolls away, the top bar keeps showing the scene name, so you always know where you are.

MIT-licensed open source · Made by · patterkit.com