Light Switch adds a fast way to control ambient lights without switching to the Lighting layer. Toggle individual lights, control groups by tag, open a scene-wide light panel, and optionally allow players to interact with lights using distance, visibility, and tag-based rules.
Foundry VTT: minimum v13, verified through v14
Optional modules:
- Tagger for tag-based grouping and player tag restrictions
- Levels (v13) for range-aware visibility behavior
Workflow
- Open Scene Controls → Lighting.
- Enable Light Switch.
- Switch to any non-Lighting layer.
- Click visible light icons to toggle lights on/off.
Controls
- Left-click light icon: Toggle that light
- Right-click light icon (GM): Open context menu
- All: Apply source light state to all scene lights
- Tag name: Apply source light state to lights with that tag
Scene Light Panel
Enable the Scene Light Panel from the Lighting controls to show a tag summary panel in the UI.
- Displays All plus each tag found on scene lights
- Shows counts
- Per-row actions:
- Turn the matching lights on
- (slash) Turn the matching lights off
- Includes collapse/expand support
Keybindings (Default)
- Toggle Light Switch: Shift + L (GM)
- Toggle Scene Light Panel: Ctrl/Cmd + Shift + L (GM)
Player Light Switch
When enabled by GM:
- Players get a Player Light Switch toggle in Token controls
- Players can interact with lights while not on toggle is on
- Player actions are validated and applied by the active GM via socket handling
Player Access Options
- Allow Player Light Switch (world-level toggle)
- Use Tags For Player Control (Tagger required)
- Restrict player control to lights with a specific tag
- Player Light Interaction Distance
- 0 disables distance limit
- Limit Player Light Visibility By Distance
- If enabled, only nearby switch icons are shown
- Hide Light Icons From Players
- Icons stay interactive but render invisible for immersion
Level Aware Visibility
- v14: Option to hide switch icons outside the currently viewed elevation level
- v13 + Levels: Option to show icons only within active Levels UI range
Light Graphics
Each ambient light can optionally render a custom image/video overlay.
- Enable Light Graphic
- Graphic File (image/video path, picker supported)
- Graphic Scale (0.1 to 5.0)
- Graphic Rotation (0 to 360)
Notes
- The graphic is shown while the light is on
- Preview updates live in light config
- Preset fire/flame video assets are included
- Supports scene refresh, wall/tile updates, LOS/visibility changes, and elevation-aware behaviour