Keys and macros
Keys
Change these in Configure Controls, under Blob's Theater System.
| Key | What it does | Who |
|---|---|---|
| Page Down | Next cue (or next backdrop, if there are no cues) | GM |
| Page Up | Previous cue (or previous backdrop) | GM |
| ` (hold) | Peek at the map while held | Everyone |
| Ctrl+Shift+T | TV mode on this computer | Everyone |
| (none) | Open or close the theater panel | GM |
In the panel: 1–0 play soundboard pads; arrow keys move between sections in the icon rail; F2 renames a backdrop.
Macros
Everything is available to macros through the module's API:
js
const bts = game.modules.get("blobs-theater-system").api;| Call | What it does |
|---|---|
bts.openPanel() | Opens the theater panel (GM). |
bts.help() | Opens the getting-started journal (GM). |
bts.exportSetup() | Exports the setup as a Theater pack, asking what to include (GM). |
bts.importSetup(file?) | Imports a Theater pack (a File, or pick one) (GM). |
bts.show(path) | Shows an image or video as the backdrop, by its path on your server. |
bts.show() | Raises the stage with what was last on it. |
bts.hide() | Back to the map. |
bts.clear() | The map, with the cast, speech and atmosphere still on stage. |
bts.next(), bts.previous() | Next / previous backdrop in the active set. |
bts.say(text, speaker) | A line in a speech bubble. speaker is the name of a character on stage; leave it out for narration. |
bts.state | What's on stage now (read only). |
bts.screen, bts.radio | The Screen's and the YouTube music player's position (read only). |
Changes made by macros sync to everyone like changes made in the panel. Only GMs can change the stage.
Examples
A macro that shows a picture and has the innkeeper speak:
js
const bts = game.modules.get("blobs-theater-system").api;
await bts.show("worlds/my-world/scenes/tavern.webp");
bts.say("Rooms are two silver a night. Trouble's extra.", "Marta");