Creator Docs

Choices

The Choices action shows buttons on the screen. The reader taps one to pick what happens next. This is how the reader changes the story.

Each choice can continue the visual novel or move it to another section.

The scene editor on a phone with the Choices form open. The preview at the top shows the two choices over Day forest. The scene editor on desktop with the Choices form open on the left. The preview on the right shows the two choices over Day forest.

Add the Choices action to a line

This example adds two choices to line 5 of the Prologue scene. Line 5 asks, "Where should we go?" One choice goes to a section called Forest. The other goes to a section called Town.

Before you start, add the sections that the choices go to. Tap the three dots button (the button with three dots that opens more options) at the right of a section name. Then tap Add section below, type the name, and tap Create.

  1. Open the Prologue scene. See Scene Map: Open a scene.

  2. Tap line 5.

  3. Open the Actions menu.

    • Phone or tablet: Tap the + button in the bottom bar.
    • Desktop: Click the + button under Presentation state.
  4. Under Navigation, tap Choices.

    The Actions menu on a phone. Choices in the Navigation group is marked. The Actions menu on desktop. Choices in the Navigation group is marked.

    The Choices form opens. Its list of choices is empty.

Add a choice

  1. Tap + Add Choice.

    The Edit Choice form opens.

  2. In Choice Content, type the button text, such as "Go to the forest".

  3. Under Action, tap Move to section.

    The Scene and Section fields appear.

  4. In Scene, choose Prologue.

  5. In Section, choose Forest.

  6. Tap Save Choice.

    The Edit Choice form on a phone, filled in for Go to the forest with Move to section, Prologue, and Forest. The Save Choice button is marked. The Edit Choice form on desktop, filled in for Go to the forest with Move to section, Prologue, and Forest. The Save Choice button is marked.

    The choice appears in the list. The preview shows the new button.

  7. Add the second choice the same way. Type "Go to the town", and choose the Town section.

  8. Tap Submit.

The choices are saved on line 5. A choices icon appears at the right end of the line.

Choose the choice layout

Choices Layout sets how the choice buttons look. The form picks the first layout with the layout type Choice for you.

To use another look, add a layout with the layout type Choice. Then choose it in Choices Layout. See Choice Layout.

What a choice can do

Tap a choice in the list to see its settings in the Edit Choice form.

Setting What it does
Choice Content The text on the button. You must fill it in.
Action What happens when the reader taps the button. Continue goes to the next line. Move to section goes to the section you choose.
Scene and Section Where Move to section goes. The section can be in another scene.
Animation Optional. A transition, such as Crossfade, that plays when the visual novel moves.
Playback Speed and Continuity These appear after you choose an animation. Playback Speed sets how fast it plays. You can leave Continuity as it is.
Update Variables Optional. Changes a variable when the reader taps the button.

Update Variables runs together with the Action. For example, a choice can set a variable called "Route" to "forest". Later, a Conditional action can check that variable.

To add one, tap the + button under Update Variables. Then tap Update Variable. To set the variable, see Update Variable.

Change a choice

To change the choices of a line, tap the line. Then open Choices from the Actions menu. The form shows the saved choices.

  1. In the list, tap the choice.

    The Edit Choice form opens.

  2. Change the settings.

  3. Tap Save Choice.

  4. Tap Submit.

Move or delete a choice

  1. In the Choices form, open the menu of the choice.

    • Phone or tablet: Long press (touch and hold) the choice.
    • Desktop: Right-click (click with the right mouse button) the choice.
    The Choices form on a phone. The Go to the town choice is marked, and its menu shows Move Up and Delete. The Choices form on desktop. The Go to the town choice is marked, and its menu shows Move Up and Delete.

    A menu opens.

  2. Tap Move Up, Move Down, or Delete.

  3. Tap Submit.

The first choice has no Move Up. The last choice has no Move Down.

What the reader sees

The choices show as buttons over the scene. The text of the line stays in the dialogue box. The preview in the scene editor shows this too.

To try your choices, open the full preview. It shows your visual novel from the selected line.

  • Phone or tablet: Tap the three dots button in the bottom bar. Then tap Preview.
  • Desktop: Click the play button (the button with a triangle) above the preview.
The scene editor on a phone. The preview at the top shows the two choices over Day forest. The three dots button in the bottom bar and Preview are marked. The preview on desktop, filling the whole window. Go to the forest and Go to the town show over Day forest, above the text Where should we go?
  • The visual novel waits until the reader taps a choice. Tapping the screen does not go to the next line.
  • The tap runs the action of the choice. For example, Go to the forest moves the visual novel to the Forest section.

Good to know

  • The Scene Map shows an arrow when a choice moves the visual novel to another scene. A choice that stays in the same scene makes no arrow.
  • The preview shows your changes before you tap Submit. If you leave the form without tapping Submit, your changes are lost.

Problems and fixes

  • A warning says "Choice content cannot be empty". Type the text of the button in Choice Content.
  • A warning says "Please select a scene" or "Please select a section". Choose both a Scene and a Section. Or tap Continue instead.
  • Delete does nothing. The list must keep at least one choice. Add a new choice first. Then delete the old one.
  • Tapping a choice does nothing. The choice uses Continue on the last line of a section. There is no next line. Choose Move to section instead.

Next steps