Docs/Dynamic Components

Dynamic Components

Dynamic Components are the interactive parts of a story: a choice, a dice roll, a conversation, a combat, the scene it all happens in. You build each one once, give it a name, and open it through a Trigger wherever the story needs it.

What a Dynamic Component is

A Dynamic Component is an interactive moment you prepare in advance. You set it up once: the dice to roll, the choices to offer, the stock in a merchant's shop. Then you can open the same component from anywhere in the book, as many times as you need.

You build each one by filling out a form. Some of what you type is for your Reader: the words on a choice, what a character says, the description under a die. The rest is for you alone, such as a group's name or a combat's location. A Decision Template's name, for one, is the heading the Reader sees. Every page below says which is which, and each has a What your Reader sees section that describes the window from their side.

The seven kinds

Which one do I need?

Three questions sort almost every case:

  1. Does the Reader decide, or does chance? If the Reader decides, it is a Decision Template. If chance decides, it is a Dice Template. If both (they try, and the try might fail), it is a Decision Template with Roll a dice on that choice.
  2. Is someone talking? A choice made inside a conversation, with a character answering each line, is a Dialogue Template. A one-off choice with no one answering is a Decision Template, even if the choices are things the Reader says.
  3. Is it a contest with health and moves, or an exchange of things? A combat is a Combat Template. A shop, a chest or a swap is a Trade Screen.

Two kinds are not moments at all. A Calculation is a number the others read, and a Background is the scene behind the words. Neither opens a window.

One story beat, four ways
Ishmael needs a bed for the night and Peter Coffin has one room left. As a Decision Template: "Pay for the room" or "Sleep in the stable". As a Dice Template: a roll to talk the price down. As a Dialogue Template: haggling line by line, with Coffin warming to Ishmael or not. As a Trade Screen: the room is an Item on Coffin's shelf, priced in Coins. The right one depends on how much of the moment you want the Reader to play.

A good order to learn them in

Each kind builds on an idea the one before it introduced, so this order keeps every new page short:

  • Decision Templates first. They teach the one thing everything else uses: a result that reveals a Chapter or changes a Fact.
  • Dice Templates next. Same results, now hung on an outcome instead of a choice.
  • Calculations, once you want a roll or a price to follow a Fact.
  • Trade Screens, which introduce bags: Container Facts on two Glossary Items.
  • Combat Templates, which use bags too, plus each fighter's own Combat Settings.
  • Dialogue Templates last. A conversation is a tree of small decisions, each with the same prerequisites and results, so by now every piece of it is familiar.

Where they live

The sidebar has a Dynamic Components tab, and every component you've built for this book lives there, one kind per sub-page. Each template gets its own row. Pressing the row opens the template for editing, and the duplicate and delete actions sit beside it.

Dynamic Components belong to one book. A Dice Template you build for one story is not available in another.

Three of the seven need something on a Glossary Item first. A combat needs fighters with a bag, a shop needs two traders with a bag each, and a Calculation needs a Numeric Fact. Results everywhere need Facts to change. Those all live on Glossary Items, and each page below says what its kind needs under Before you start.

How they reach the Reader

A Dynamic Component always reaches the Reader through a Trigger. The Trigger sits in the Chapter where the story should pause, and one of its results points at the component. When your Reader reaches that spot and the conditions you set are met, the component opens.

Note
A Trigger's result list can open one Dynamic Component at a time. A Decision Template's choices can't open one directly. They can only set a Fact or reveal another part of the book. A component chains off a choice through a Fact that another Trigger watches for.

Calculations are the exception: nothing opens them. Another Dynamic Component asks them for a number. A dice roll might use your Reader's seamanship plus their ship's bonus as its Modifier. The Calculation works that number out from Facts the story already tracks and returns it.

The shape every page follows

Each component has its own page below. Every page uses the same structure, so you always know where to look:

  • Where to find it: the sidebar path and the list view.
  • Before you start: what has to exist in the book already, with a link to where you make it.
  • The modals: the window where you build it, running live on the sample book.
  • The template: the settings that apply to the whole template.
  • The parts: what is unique to each kind, such as choices, Modifiers, and outcomes.
  • What your Reader sees: the same window from the other side.
  • Published templates: what a publish locks, and how an Edition changes it.
  • Validation: what stops a save and what stops a publish.
  • Questions writers ask: the same answers as the "?" inside the window.

Questions writers ask

How this fits your story

Can I open the same Decision Template in two Chapters?

Yes. A Dynamic Component is built once and belongs to the book, not to a Chapter. Any number of Triggers, in any number of Chapters, can open the same one. When you edit it, every Trigger that opens it shows the new version.

Each opening starts fresh: the choices are all offered again, and their prerequisites are checked against the story as it stands now. What carries over is what the first pick changed: the Facts and the reveals. So a second opening can look different.

Can one Trigger open a dice roll and then a combat?

Not directly: a Trigger opens one Dynamic Component. The way to chain them is through a Fact. The Dice Template's Success outcome gets a result that sets a Fact, say Bold to True. A second Trigger, a little further down the Chapter, opens the Combat Template only when Bold is True.

The same pattern chains anything off anything: a choice into a shop, a combat into a conversation. The one shortcut is a dice roll on a Decision Template choice, which rolls inside the decision.

Do I need Glossary Items before I can build these?

For three of them, yes. A combat needs fighters with a bag each. A shop needs two traders with a bag each, and Items to sell. A Calculation needs a Numeric Fact to add up. The other four can be built with none, but their results only get interesting once there are Facts to change.

Every page below has a Before you start section. It lists exactly what has to exist first, and where on the Glossary Items page to make it. When something is missing, the picker in the window says so instead of showing an empty list.