Choice
Choice is the node you use when the player should decide what happens next.
Use Insert > Dialogue & Logic > Ask a Choice when a route branches because of player intent.
Properties
Node-specific properties
| Field | What it does |
|---|---|
| Prompt | Text shown above the choices. Supports variable templates. |
| Choices | Up to 4 options, each with text and a next node. |
| Store Selection In Variable | Optional Text variable that receives the selected option ID. |
Inherited/common properties
| Field | What it does |
|---|---|
| Name | Optional label used in the editor and Story Map. Leave it empty to use VNC's automatic node name. |
Conditional Options
Each option can also include a condition and locked text. If the condition does not pass, the option appears disabled and can show its locked text instead of the normal option text.
Timeout Path
Choice nodes can have a timeout path. When enabled, the runtime waits for the configured number of seconds, then follows the timeout target if the player has not picked an option.
| Timeout field | Default |
|---|---|
| Seconds | 5 |
| Stored choice ID | timeout |
| Display text | No choice made |
The timeout only runs when it has a positive duration and a timeout target.
Example Setup
| Field | Example value |
|---|---|
| Prompt | Three route lights pulse in the dust. |
| Store Selection In Variable | favoriteColor |
| Choice 1 | ID red, text Take the red emergency stairwell, condition hasBadge Is True, locked text Locked: the archive badge is missing., then set Next to the next node in your route. |
| Choice 2 | ID green, text Follow the green service hall, then set Next to the next node in your route. |
| Choice 3 | ID blue, text Trust the blue maintenance lift, then set Next to the next node in your route. |
| Timeout path | Seconds 8, stored choice ID alarm_timeout, display text The alarm chooses for you., then set Next to the next node in your route. |
Runtime Behavior
When the node runs, VNC resolves the prompt and visible option text, checks option conditions, then waits for the player. The selected option's target becomes the next node.
If Store Selection In Variable is set, the selected option ID is written into that Text variable. See Variables & Text for how stored option IDs work with later conditions.
Common Mistakes
| Problem | Fix |
|---|---|
| A choice option does nothing | Set that option's Next target. |
| An option is always locked | Check its variable condition and expected value. |
| The selected option is not remembered | Set Store Selection In Variable to a Text variable. |
| Timeout never fires | Set both a timeout duration and a timeout target. |
Choice nodes are easiest to maintain when each option leads to a short, named branch that returns to a clear merge point.