Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Words used in these docs

These docs try to use plain words. Where the player, error messages or older pages use a technical name, it is listed here too.

In these docsAlso calledMeaning
Momentnode, beatOne click-through step of the story: what happens, then what is said
TalkingtalkingWho is speaking this moment — one id or several (may differ from who is on screen)
ScenelabelA named moment you can jump to (:: park)
Stage directioncommandA bracket line that changes the scene ([bg street])
The short way to write itscript sugar, Mode A syntaxWriting a command as a bracket line instead of data
Script onlyMode AThe whole story in story/script.txt
Script + direction fileMode BDialogue in the script, extra direction in story/story.json
All in story.jsonMode CEvery moment written as data
Flagvariable, varSomething the story remembers (helped, score)
Native extensionextensions[]Custom code the player loads from game.json — Native extensions
SessionplaythroughNew Game / Continue / Load until title — Save, Back and story end
Locale overlay*_uk.json, script_en.txt, …Language file next to a base file — Translations
Place on stageslotWhere a character stands (left, center, right) — Planes and slots · Places on stage
Draw stackplaneFixed layer that decides what sits in front — Planes and slots
Arrangementlayout profileA named set of places
Layered characterpack, compositionA character built from several pictures — Expressions and packs
Expression swap fadecomposition_transitionsSoft blend when the look changes on stage — Expression fades
Talking and focus reactionsdrivePictures or effects that change while a character speaks or is in focus — Talking and focus
Composition layerpack layerOne stacked picture inside a character expression
Draw band (props)sprite/obj layerbg_front / fg / overlay — Sprites and objects
Silent line(silent), driver_typing: falseSpeaker line with typing mouth / beep off — Lines and speakers
Dialogue boxpanelThe box the text appears in — What a panel is
Panel instancepanel idWhich box on screen (main, side, …) — How text finds a panel
Panel lookpanel presetNamed look under panel.<name> in the theme — How a panel looks
Stacked panel linestext_mode appendKeep earlier text and add the next moment’s text — Appending text
Panel height ceilingmax_heightHow tall the plate may grow before body text scrolls — How a panel looks
Name platelabelplateThe speaker’s name box — Name plate
Theme moodtheme_styleOverlay theme file for a stretch of play — Theme and the dialogue box
InterfacechromeMenus, buttons and boxes around the story
ScreenscreenA full menu or overlay: title, pause, settings — Title, pause and settings screens
In-game barHUDA small screen shown during play — Gameplay HUD
Stays until you change itstickyA setting that carries on to later moments
Live link to a flagbindA value on screen that follows a flag by itself
Lookstyle, pack, themeHow something is drawn
Reuse / build oninheritance, extendsStart from an existing look or expression; change only what differs — kinds differ: Reusing settings
Pack looksource, styleLoad a theme pack onto a button, choice or name-entry field
Expression variantcharacter extends / override / addOne expression built from another’s layers
Layer (front / back)planeWhich things draw in front of which
Shared shapecontractA settings shape used in many places
EffectshaderA visual filter on a picture or the whole screen — Shaders
Show/hide blendtransitionHow something appears or leaves — Transitions
Tween / preset motionanimateMove or pulse something already on stage — Animation
Soft pointercursorCustom mouse look — Cursor
Language overlaylocale, i18nExtra language files and Settings switch — Translations
Author playerauthor modeThe player you write and test in — How you work
Released gameplayer buildWhat you give to readers — Build and hand off
Boot brandsplashLoading / boot look — Title, icon, splash