Skip to content

Keys and macros ​

Keys ​

Change these in Configure Controls, under Blob's Theater System.

KeyWhat it doesWho
Page DownNext cue (or next backdrop, if there are no cues)GM
Page UpPrevious cue (or previous backdrop)GM
` (hold)Peek at the map while heldEveryone
Ctrl+Shift+TTV mode on this computerEveryone
(none)Open or close the theater panelGM

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;
CallWhat 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.stateWhat's on stage now (read only).
bts.screen, bts.radioThe 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");