Mini Light Switch

Mini 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

1. Open the Lighting Scene Controls.
2. Enable Light Switch.
3. Switch to any non-Lighting layer.
4. 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.

https://bsky.app/profile/wgtngm.bsky.social

https://www.wgtngm.com/