Skip to content

Sharing your setup (Theater packs) ​

A Theater pack (.btspack) is your whole setup in one file: backdrop sets, cue lists, the NPCs in your cast (with their expressions), your music tracks and soundboard pads, and every picture, video and sound they use. Use it to:

  • start a new campaign with the scenes you've already built,
  • move a setup to another world or another Foundry server,
  • share a ready-to-run adventure with other GMs.

Export ​

  1. At the bottom of the theater panel, click Export setup.
  2. Give the pack a name (and an author, version, description and link if you're sharing it).
  3. Untick anything to leave out: backdrop sets, cue lists, NPCs, music and soundboard.
  4. Click Download. The .btspack file lands in your downloads.

What goes in:

  • Files from your world (uploads, your own art) are copied into the pack. Foundry's own files (icons, sounds) aren't, since every install has them.
  • Files from a game system or another module aren't copied; the pack notes that the other world needs that package too.
  • Players' characters stay behind: they belong to your group's world. Cues keep the NPCs they bring on.
  • A cue's music travels with it, even from your own playlists (it becomes a Theater music track).
  • Cues that fire when a particular scene is activated lose that trigger (the scene isn't in the pack). Combat triggers are kept.

Import ​

  1. At the bottom of the theater panel, click Import setup and pick the .btspack file.
  2. Check what's in it and click Import.

Everything is added next to what's already in the world; nothing is replaced. The pack's files are uploaded into worlds/<your world>/blobs-theater-system/packs/<pack name>/. NPCs are matched to an actor of the same name if this world has one; otherwise a simple actor is made with the NPC's name, portrait and expressions (it has no game stats: give it a sheet if you need one).

Macros can do both: exportSetup() and importSetup(); see Keys and macros.