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 behaviour
Latest Releases
Workflow
- Open the Lighting Scene Controls.
- Enable Light Switch.
- Switch to any non-Lighting layer.
- Click visible light icons to toggle lights on/off.
Or use the shortcut key Ctrl/Cmd + Shift + L to toggle the light icons.
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 the toggle is on
- Player actions are validated and applied by the active GM via web socket.
Player Access Options
- Allow Player Light Switch (Lighting Scene Controls 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
Light Graphics
Each ambient light can optionally render a custom image/video overlay.
- Enable Light Graphic
- Graphic File (image/video path/preset)
- 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
--
Join our Discord to see the work in progress and discover upcoming features.
Support the project on Patreon or Ko-fi, or see what else I have on the go.