Documentation / PATH Studio

Automatic Routers and fallback

Available now

A Router tests rules in priority order and follows the required fallback when none match.

On this page

When should I use a Router?

Use a Router to choose an outcome automatically from run state, rather than displaying a new viewer decision. A score earned by earlier choices can select a destination. The viewer’s Paths simplifies the route and omits technical Router nodes, but public story JSON remains inspectable.

Set one up in Studio

  1. Declare a numeric variable under Project / variables and add a score effect to an earlier Decision choice.
  2. Choose + router on the canvas; connect the prior section or choice to it. Select the Router to open its Inspector.
  3. Under Rule 1, set Available when to Numeric comparison (this run); choose the variable, At least ≥, and a Compare to threshold. Choose the rule destination.
  4. Use + Add rule for another case if needed. Move rules up or down to set priority: the first true rule wins. Under Required fallback, connect a destination for cases where none match.
  5. Connect both destinations to an Ending (directly or through video sections). Expand issues and resolve empty conditions, missing destinations, cycles or nonterminating routes before preview/export. Simulated Router diagnostic is a creator-only check, not a live run.

Routers are supported only in runtime story version 1.2.0. A Router can have zero rules, but always needs a fallback. Follow the scored-route tutorial · Read about variables.

Back to all documentation