Docs/Story foundations

Story Canvas

Once your story has more than a couple of branches, it stops fitting in your head. The Story Canvas draws the whole book from top to bottom, the way it reads: every Chapter, its Headers, and every Trigger at its place, with the forks a Trigger opens laid out under it. From the Story Canvas you can start reading in the middle of the book, at the part you want to test.

Where to find it

The Story Canvas is the compass icon near the top of the icon rail, under the gear for Book Settings. It is on the rail in Reading Simulation too, under Back to reading. In the simulation, Restart Story at the top of the Triggers tab opens the same window.

The canvas draws your book from its latest Snapshot. Opened from the editor, it shows a line at the top when you've changed the book since that Snapshot, with New snapshot beside it, and a card's Open in the editor takes you to that Chapter, Header or Trigger. Play from here, which starts reading partway into the book, runs inside Reading Simulation. A new Snapshot taken there redraws the canvas, and the simulation starts over on it.

What's on the Story Canvas

  • Chapters are bands, in book order. A Chapter's Headers are rows inside its band, and a level 3 Header sits indented under its level 2. A Chapter or Header that is hidden by default is held back: its border is dashed, a Header carries the editor's stripes, and its row says what reveals it.
  • Trigger cards sit under their Header, one card for each Trigger. The title is the Trigger's name, or the editor's summary of it when it has none. Under the title, one line says what it does and when. A Trigger whose checks fail where your Reader reaches it says Won't run, and one with no checks and no changes yet is drawn faint.
  • Outcome cards sit in a tray under a Trigger that opens a Decision Template, a Dice Template, a Combat Template or a Dialogue Template: one card for each choice, each roll result, each way a combat ends, each reply. An outcome that opens another template has that template's outcomes under it. A result the outcome applies only when its checks pass says so on its line ("only when The Greenhand's Silver > 3").
  • Trade Screen cards sit in the same tray when a Trigger or an outcome opens a Trade Screen.

Pressing a card shows its details beside the canvas. For a Chapter or a Header, that is when the Reader sees it and what reveals it. For a Trigger, it is the checks it makes and what it does. When a Trigger won't run, Why won't it run opens the same check-by-check view as the simulation's Trigger log.

The lines between cards

  • A line with an arrow is a reveal. It runs from the card whose result reveals a Chapter or Header to that Chapter's or Header's row. A short one drops straight down; a longer one runs along the canvas's right edge.
  • The lines from a Trigger to its outcomes are the fork: the ways the story can go from there.

Reading on is not a line. The canvas reads from top to bottom, like the book. A hide is not a line either: the card says Hides and what it hides, and the hidden Chapter or Header says what hides it again.

Play from here

The back half of a long book is hard to test. To reach it you normally replay the front half: pick the same options, roll the same dice, re-read Chapters you already know. Story Canvas skips that.

Tip
Play from here starts from the Chapter, Header or Trigger you select. With a choice, a roll or a Trade Screen selected, the button is greyed out and the details name the Trigger it comes from. First, the details list every fork on the way there, and each one needs an outcome. For example: the choice your Reader makes, or how a roll lands. Pick a way for me chooses outcomes that get there. It keeps the ones you chose, unless they close every way. The list says whether your Reader reaches the card that way, and whether its Trigger runs.
  • Reading Simulation then opens with everything on that way applied: hidden Chapters, Headers and Glossary Items revealed, Facts set, and the Triggers before the card run. You land in the middle of the book, in the state you want to test. A Trade Screen on the way is passed by, unless you choose to make the trade.

When no Chapter, Header or Trigger is selected, the button at the bottom is Start from the beginning. It starts the simulation over from the first page.