Stage Builder
Places to go, what each looks and sounds like, who is there, and what happens as the chat arrives. Overlays such as a map open over them.
The Stage builder tab is where a scenario's rooms and maps live. A place is somewhere the chat can be: a tavern, a forest, a whole town. An overlay opens over the current place: a map, a closer look, a status screen. If closing it should bring you back where you were, it's an overlay.
Places need no scripts. The chat shows the place it is in, with its picture and music, and switches when it moves. It also paints the opening screen and a resumed chat automatically.
The tab shows for scenarios made for Voxta Talk (the scenario's app, under Apps).
Places
Each place has a name and a flag. While the chat is in the tavern, location.tavern is set. The Flag prefix at the top sets the location. part. Setting another place's flag clears it, so buttons, events and contexts can check where the chat is. Start place is where a new chat opens.
Context is what every character knows while the chat is there: what the place is and what it is like. Describe the place, not who is in it. That's the next section.
Context and Story can read chat variables, so one place can say different things as the game goes: {{ if variables.keys > 0 }}One of the keys might fit.{{ else }}Without a key, it will not open.{{ end }}.
Versions
A place can look different at night, in the rain, or once something happened. Add a version with + Version, and give it a name and Shows when. Shows when holds the flags it needs, written like a button's condition (time.night). It can also read a variable ($keys > 0). The chat shows the first version whose condition holds, top to bottom, and Normal when none does.
A version has its own Picture, Music and Ambience (a second loop under the music: rain, a crowd). Left empty, each takes Normal's. Additional context is added to the place's Context while that version shows.
Music on arrival can be a track, Silence, or left alone. Left alone, what was playing goes on, so one track can carry several places. Give a track only where the music should change.
Voice environment is what voices and scene sounds pass through while you're there: Cavern (echo), Hall (reverb), Muffled, Phone, Radio or Underwater. A version can have its own (the flooded cave sounds underwater), or None to stay dry where Normal has one. It plays in the browser only. Scripts can change it too. See Voice environments.
The wand over the picture draws one: a new picture, or a change to the one there (the same tavern, at night).
Who is here
With more than one role, each place lists them. Switch on the roles that are in this place. They join when the chat arrives and leave when it goes to a place they are not in. A role in no place, usually the companion, goes everywhere with you.
On arrival
What happens as the chat comes into the place, in this order:
- Story: told by the Story Writer as you arrive, before anyone speaks ("You push through the hanging moss and find
{{ scenario_chars.witch }}already waiting."). Empty: no story. - Then: who speaks. By default, the first of the place's people who wasn't already with you. You can pick someone else, or Nobody speaks. With a story, they reply to it.
- Happens: Every time, or First visit only. After the first visit you arrive quietly: no story, and nobody greets you.
A line under them says the order in words, such as "The Story Writer tells the story → Mira replies to it".
One line at random makes each line of the Story a story of its own. One is told per arrival, and every line is told once before any comes again. Sixteen empty dungeon rooms are sixteen lines in one place.
Every visit is new is for corridors, forest paths and labyrinths. Going from the place to itself is a new arrival, with a new story line, a travel note, the greeting and the transition screen. A button of the place can then take you to it ("Continue exploring"), and a script moves on with chat.appTrigger('GoTo', 'chamber').
Don't narrate an arrival from an event or a button script. It runs after the greeting, so the character greets first and the story comes second. Use the place's Story.
Travel notes
Every move leaves a short note in the chat, before any story: "Lapiro and Mira leave the Tavern and arrive at the Forest." The player and the characters both see it, so everyone knows where the chat is. It is never read aloud. Moving again before anything else happens rewrites that note instead of adding another, and moving back to where it started removes it.
The note already says who went where, so a place's Story can start with what is there.
Travel note, under On arrival, changes it for the way to that place:
- Usual: the note above. Going on through a place where every visit is new, it reads "Lapiro moves on and arrives at another Empty chamber."
- Its own: one line per note, picked at random, with
{{ who }},{{ from }}and{{ to }}filled in ("{{ who }}pushes deeper into the dark."). - None: the chat isn't told it moved.
Transition screens
A few seconds on the way between places: a picture that fills the stage and drifts slowly, a line the narrator reads, a sound. Nobody shows, and a click skips it. Without one, the next place shows at once. The list shows once the scenario has two places.
Every move is the screen for any move. A place can change it under Transition screen, Arriving here:
- Same as every move.
- Its own: shown when the chat comes there, from any place.
- None: straight in, even when every other move has one.
A screen has versions like a place's, each with its own Picture, Line and Sound: a road by day and by night. The narrator reads the Line on the way, and it is never kept in the chat. {{ place }} is where you are going ("You set out for {{ place }}, the road winding ahead."). A version with no line reads Normal's. Lasts is until the line is read, or 3 or 5 seconds. With no line, it lasts a few seconds.
Transition screens show in the stage view only, and not as a chat starts or resumes.
Overlays
An overlay has a picture, a name and its flag, open.<id> (open.map). A button that sets the flag opens the overlay, and clearing it closes it. It plays the place's music or its own, and can play a Sound on open and a Sound on close. Close button puts one in the corner. Turn it off when the overlay's own buttons close it. Its Context is known while it's open ({{ user }} is studying the map).
Its versions follow the place's: a Night map shows over the Night tavern while you edit it.
An overlay covers the message box. While it is open, the line being read shows over it as a subtitle, with the speaker's name. It is all in the chat as usual.
Buttons
Each place and overlay lists the buttons on it. They show only there and need no script. When clicked:
- Takes you to another place, or Goes on to another of this one, when every visit to it is new.
- Opens an overlay (on a place), or Closes it (on the overlay).
- Says a line: a Line that happens there ("The bell rings somewhere above you."), narrated, and the character replies.
- Tells a story: What happens, for the Story Writer to narrate.
- Looks around: hides the characters and the message box, so the player can see and click the whole picture (a path the characters stand on). Anything happening, or a second click, brings them back. Only what the player sees changes, never the story.
Also sets sets flags as it's clicked (! before one clears it). Sound on click plays once: a page turning, a door creaking. Only once makes a button go away after its first click, for the rest of the chat. A button can also come From Interactions, where its full conditions and effects are edited. Place a button on the picture, over a door or a spot on the map, with the Stage Editor.
Add marker places a picture or words like a button, a pin on the map, that is not clicked. It shows while its flags are on.
Building a map
A map the player opens from anywhere and clicks to travel:
- The map: add an overlay named Map with the map's picture. Its flag is
open.map. - Opening it: one button for every place, in the Interactions tab, that sets
open.mapand shows only while!open.map. Or give each place its own Opens Map button, to open it only from some places. - Going somewhere: on the Map overlay, one button per place, Takes you to that place. Place each over its spot on the picture with the Stage Editor (an invisible hotspot over a drawn town works well). Clicking one closes the map and moves the chat, transition screen included.
- You are here: on the Map overlay, a marker over each place's spot, shown while that place's flag is on (
location.tavern), with an icon such as 📍. - Closing it: keep Close button on, or add a button on the overlay that only closes it.
Give the overlay a Context ({{ user }} is studying the map) so the characters can talk about it, and versions (a night map) like a place's. The Scenario assistant builds all of this when asked for a map, looking at the picture before placing the buttons.
From a script
Places switch on flags, so a script moves the chat by setting one with chat.setFlag('location.cellar'). It can also use chat.appTrigger('GoTo', 'cellar'), which also goes on to another of a place where every visit is new. The move goes as any other: the travel note, the transition screen, then the place's story. A walk between places, with a picture and a line on the way, is a transition screen and needs no script.
When a script tells a story itself with chat.story(...), the character already replies to it, so don't add chat.roleMessage('main') after it. That would be a second reply.
The Scenario assistant
The Scenario assistant builds places, versions, overlays, transition screens and their buttons. It can also move an older scenario's script-built rooms into the Stage builder. It looks at the picture before it places a button on a map.