Choices & Branching

Choices let players decide how the story continues. When a node has choices, the VN overlay displays a set of buttons and the player selects one. Each choice can link to a different node, creating branching story paths.

Adding Choices to a Node

  1. Select a node in the Interaction Editor.
  2. Click Add Branch in the toolbar or the Properties Panel.
  3. Enter the choice text in the prompt dialog.
  4. A branch bar appears on the graph, connected to the parent node.
  5. Drag from the branch bar's output connector to the target node.

When a node has one or more choices, its direct "next" link is removed. Flow continues exclusively through the chosen branch.

Choice Properties

Each choice has the following properties, editable in the Properties Panel:

Property Description
Text The label shown on the choice button
Next The target node this choice leads to
Condition An optional flag-based condition (see below)
Unmet Behavior What happens when the condition is not met
Hint Text Text shown when the condition is not met and Unmet Behavior is "Show Hint"

Conditional Choices

You can make choices appear or disappear based on runtime flag values. Enable the condition toggle on a choice to configure it.

Condition Fields

Field Description
Key The flag name to check
Operator Comparison: ==, !=, >, <, >=, <=
Value The value to compare against

Example: If you set a flag "metGuard" to "true" earlier in the story, you can add a choice with condition Key="metGuard", Operator="==", Value="true". This choice only appears if the player has met the guard.

Unmet Behavior

When a condition is not met, the choice can behave in three ways:

Behavior Effect
Hidden The choice does not appear at all
Disabled The choice is visible but grayed out and not clickable
Show Hint The choice is visible but disabled, and the hint text replaces the choice text