Docs/Testing & publishing

Reading Simulation

Reading Simulation replaces the editor view with the Reader view. Triggers run, decisions open, dice roll, combat plays out turn by turn, and trades open at the right moments. It's the closest you can get to seeing your book the way a Reader will, without leaving the editor.

Where to find it

Every book's sidebar has a Simulate Reading button at the bottom. Right above it is a small dropdown for picking a playable character to read as. Picking one is optional (see below). The button swaps the editor for the Reader view and opens the book at Chapter 1.

Starting a session

The session behaves like a real read. Paragraphs appear in order, Triggers run, and Dynamic Components open when the story reaches them. Nothing is faked: the simulation runs the same code your Readers will.

A simulation runs with or without a playable character:

  • What one adds. The word Reader in a rule, which stands for whichever character the Reader is playing as. Without one, a rule about the Reader has nobody to ask about and quietly does nothing. The dropdown above the button picks who to read as, and shows only Characters and Creatures with Playable turned on.
  • Without one. A branching story that never uses Reader runs fine with no character picked, and the sidebar asks for nothing.

The session doesn't read your live draft. When it starts, it binds to your latest Snapshot of the book, taking one automatically if you have none, and reads from that frozen copy. Later edits stay out of the session until you bind it to a fresh Snapshot; the Triggers tab shows how old the current one is.

State accumulates as you go

A reading session isn't a dry run. Everything that happens is recorded against it:

  • Facts changed by decisions, dice rolls, combat outcomes, or trades.
  • Glossary Items that were revealed or hidden.
  • Chapters and Headers that Triggers opened.
  • Your position: last Chapter and last section. You can leave the simulation, edit a Chapter, and return to where you left off.

The in-book sidebar with the Chapter list also has a Triggers tab. While you're simulating, it shows a live log of every Trigger that ran, along with your decisions, rolls, and outcomes. The log helps you work out why a branch went the way it did.

Jumping into the middle

Tip
Any Chapter, Header or Trigger on the Story Canvas can be a Play from here starting point. You choose an outcome for each fork on the way, and the session begins at that card with the way before it already played: Glossary Items revealed, Facts set, Triggers run. It is the fastest way to test the back half of a long book without playing the front every time.

Rewinding and resetting

The simulation's Triggers tab logs every Trigger that runs as you read. You can do two things during a session:

  • Rewind to a logged Trigger. Pick any entry in the log to roll the session back to that moment. That Trigger and everything after it are undone. The session lands at the Trigger's position, so you can play forward again with different choices.
  • Switch playable character. Pick a different character from the sidebar dropdown. Each playable character has its own session against the same book, so you can keep multiple run-throughs side by side and jump between them without losing state.