Larch Visual Novel Maker

Story board

Choices, conditions and variables: a story that remembers

Use player input, variables and line conditions so the story remembers names and choices and leads to different endings.

Choices, conditions and variables: a story that remembers

Variables are your story’s memory. For example: the player’s name, an affection score, or which choices they made.

Example: enter a name → choose → Trust +1 → different routes by trust
Example: enter a name → choose → Trust +1 → different routes by trust

1. Create a variable

Press Player variables (the key icon) in the toolbar at the bottom. Press “Add variable” and fill in the label, name, type and default value.

Player variables: the whole project’s memory in one place
Player variables: the whole project’s memory in one place

Global variables work everywhere in the project. Board only variables exist on the current board alone.

2. Let the player type

A Player input card asks the player to type, and saves the answer into a variable. Write {{playerName}} in a line and it becomes the player’s name when the game plays.

Player input: text, number, password or voice
Player input: text, number, password or voice
{{playerName}} in the line became “Leaf”
{{playerName}} in the line became “Leaf”

3. Change a variable

A Set variable card can set, add, flip or randomise a value. Players never see this card — it just applies as they pass.

A Set variable card: Trust + 1
A Set variable card: Trust + 1

4. Let a condition pick the line

  1. Click a line to open its actions.
  2. Under “When to take this line”, choose Variable.
  3. Set the condition, for example Trust ≥ 1.
Line actions: take this line only when the condition holds
Line actions: take this line only when the condition holds

When a card has several lines going out, lines whose condition holds go first. If none holds, the line without a condition is taken (the blue “default” line on the board).

Options can have conditions too

On a choice card, turn on the condition for an option. If it does not hold, the option stays visible but cannot be picked.

A choice card: every option can have a condition
A choice card: every option can have a condition

Set variables on card entry

Dialogue and scene cards also have “Set variables on card entry” under Advanced. The card records the change as it plays — no extra card needed.