Actions overview
Draft. This page is awaiting review and may change.
An action is one step in a scene. Scenes play their actions from top to bottom, and each action does one thing: show a line, change the background, play a sound, ask a question.
Add actions with + in the scene editor. The drawer has two swipeable pages.
Every action at a glance
| Action | What it does | Page |
|---|---|---|
| Text | A line of dialogue or narration | Text |
| Choices | Up to 4 options for the reader | Choices |
| Characters | Sets who is on stage and how they look | Characters |
| Scenery | Changes the background | Scenery |
| BGM | Starts or changes the background music | BGM |
| SFX | Plays a sound effect | SFX |
| Wait | Pauses before the next action | Wait |
| Interactive areas | Tappable regions on the screen | Interactive areas |
| Actions folder | Groups actions so conditions can apply to all | Actions folder |
| Go to | Jumps to another chapter and scene | Go to |
| Cutscene | Plays a video | Cutscene |
| Request input | Asks the reader to type something | Request input |
| Set random value | Stores a random number in a variable | Set random value |
| Modify variable | Changes a variable directly | Modify variable |
How they fit together
- Presentation actions (Scenery, Characters, BGM, SFX, Cutscene) build what the reader sees and hears.
- Story actions (Text, Choices, Interactive areas, Request input) are what the reader reads and does.
- Logic actions (Modify variable, Set random value, Go to) change what happens next. They work together with Variables and Conditions.
- Pacing actions (Wait) control timing.
The reader only ever sees the result: the scene keeps its background, characters and music until an action changes them, so you only add an action when something changes.
Things every action shares
- New actions go after the selected one. Tap an action first to insert in the middle.
- Leaving a half-filled form asks you to confirm (Are you sure you want to leave without adding this action?).
- Each action has a menu with Edit, Conditions, Move to and Delete.
- Conditions can be put on any action so it only plays when your variables allow. See Conditions.
- Everything can be undone. See Undo and redo.
- Names must be unique. Any new character, scenery, BGM, SFX, cutscene or variable name must not be empty or already used (Please enter a name, This name already exists).