Custom Lightsources is a system-agnostic module for Foundry VTT v13 that adds configurable token light source presets without depending on actor inventory items.
It is designed for narrative and rules-light games where light sources such as flashlights, phone lights, torches, or lanterns should be quick to use from the Token HUD instead of being managed as equipment.
- Token HUD button for quick light control
- Left-click toggle for the active light source
- Right-click palette to choose the active profile
- World-configurable light source profiles
- Default profile selection
- Built-in icons and custom icon path support
- Beam-style light sources with independent rotation
- Configurable beam rotation keybinding in Configure Controls
- Per-token selected profile persistence
- Original token light restoration when the module light is turned off
- English and Spanish localization
- Flashlight
- Phone Light
- Torch
- Lantern
- Foundry Virtual Tabletop v13
- Verified on 13.351
The module provides:
- Show HUD button to players
- Beam rotation step
- Profile Manager submenu
The Profile Manager allows the GM to:
- create profiles
- duplicate profiles
- delete non-demo profiles
- choose a default profile
- configure light values
- assign built-in icons
- browse for a custom image path
- mark a profile as a beam
Beam profiles rotate independently from the token artwork.
To rotate a beam light:
- Select a token with an active beam light source
- Hold the configured beam rotation control
- Use the mouse wheel over the canvas
The default keybinding can be changed in Configure Controls.
- This release prioritizes Foundry v13 stability.
- The Profile Manager currently uses the legacy
FormApplicationframework for reliability in v13. A future update may migrate that submenu toApplicationV2.
Install the module as usual in Foundry, then enable it in your world.
If you plan to distribute the module publicly, fill in the url, manifest, and download fields in module.json with your real repository and package URLs.
Add your preferred license here before public release.