Tags and preset packs

Two organisational features for managing larger scenes and re-using your work:

• Tags — author labels on lights so you can filter the lights list to a subset.
• Preset packs — JSON bundles of moods and light presets you can export from one scene and import into another (or share with another GM).

Tags

In the Light Tool’s Advanced tab, the Tags input lets you add free-form text labels to a light. Press Enter after typing each tag to add it; click the × on a tag chip to remove it.

Common tags:

• torches — every torch in the scene
• ambient-room-1 — lights belonging to a logical area
• spell-fx — magical lights you want to toggle as a group
• hidden — lights only the GM should think about

Filtering by tag

Once any light has tags, a row of filter chips appears at the top of the lights list. Click a chip to show only lights with that tag; click it again to clear the filter. The list header changes from Lights (N) to Lights (X/Y) showing how many are visible.

Tip

Tags are author-only — players never see them. They exist for your own organisation in the Light Tool inspector.

Preset packs

A preset pack is a portable JSON file that bundles user-customised lighting state from a scene. You can export the current scene’s mood + weather as a pack, then import it into another scene to bring that look across.

Exporting

1. Open the Scene Lighting panel.
2. Scroll down to Preset Packs.
3. Type a name for your pack in the text field (e.g. Haunted Manor).
4. Click Export current.
5. Your browser downloads a .preset-pack.json file.

The exported pack contains the currently-applied scene mood (if any) and the current scene weather snapshot. Future versions will also export user-authored light presets.

Importing

1. In the same Preset Packs section, click Import….
2. Pick a .preset-pack.json file from your disk.
3. The pack’s moods are merged into your scene’s mood registry under a pack:<slug>/... namespace, so they don’t conflict with built-in moods.
4. A confirmation appears: Loaded "Pack Name": N mood(s).
5. Imported moods appear in the Loaded packs chip list below.

After importing, the new moods appear alongside the built-ins in the Scene Mood swatch picker. You can apply, tweak, and re-export them as a new pack.

If the file is malformed or comes from a future version of PostRoll, the importer rejects it gracefully with an error message rather than crashing — invalid entries inside an otherwise valid pack are silently dropped.

Cinematic preset library

The built-in cinematic/ preset namespace ships a curated library of stage-lighting recipes — the kind of three-point setup a film crew would use. Available today (in the preset picker on every light’s Animation tab):

Preset	Use
cinematic/key	Main “story” light — softLight blend at 45%
cinematic/fill	Counter-light filling shadow side — screen blend
cinematic/rim	Edge-lighting from behind — lighten blend
cinematic/candlelit-room	Warm wobble with subtle tint
cinematic/theatrical-spot	Hard-edged stage spotlight
cinematic/eldritch-altar	Sickly green pulse + projector
cinematic/daybreak-window	Sun-shaped beam through a sash
cinematic/forest-dapple	Animated leaf-shadow gobo
cinematic/cathedral-rose	Stained-glass projection
cinematic/underwater-caustics	Rippling underwater pattern
cinematic/disco	Rotating colour cycle
cinematic/police-lights	Alternating red/blue strobe

Apply one to a light, tweak the colour and intensity to taste, and you have an instant set-piece.

Related

• Lights — basics — placing the lights you’ll be tagging.
• Presets and effects — what preset namespaces are available.
• Scene mood and time of day — the moods that get exported in a preset pack.