Light Presets
Light presets for the Foundry VTT lighting toolbar — the same workflow the core wall tools give you (solid, terrain, door, …), but for ambient lights.
Pick a preset, then drag on the canvas: every light you draw uses that preset until you pick another. The active preset shows an indicator pip, exactly like the wall type buttons, and your choice persists across reloads.
A row per preset would crowd a toolbar column that already holds the core lighting tools, so they sit behind three group buttons — Flame, Atmosphere, and Magic. Click a group to drill in to its presets; the back arrow at the top collapses it again. A closed group carries the pip when your active preset is one of its members, so you can always see where you are without opening anything.
Requires Foundry VTT V14 (built on the V14 placeable palette system). System-agnostic.
Presets
| Preset | Group | Character | Bright core |
|---|
| Candle | Flame | Small warm flame, quick low flicker, fades fast | half of dim |
| Torch | Flame | Classic strong warm flicker | half of dim |
| Lantern | Flame | Warm, steady, gentle flicker | half of dim |
| Bullseye Lantern | Flame | Focused 60° cone — points the way you drag | half of dim |
| Campfire | Flame | Heavy flame animation, deep orange | half of dim |
| Chimney | Flame | Hearth set into a wall — 180° spill that points the way you drag | 25% of dim |
| Lava Glow | Flame | Deep red-orange, slow heavy flame | half of dim |
| Moonlight | Atmosphere | Pale steady blue-white, no animation | dim only |
| Fog Bank | Atmosphere | Grey swirling fog, reads as atmosphere | dim only |
| Fey Lights | Atmosphere | Soft pink fairy shimmer | dim only |
| Ghostly | Atmosphere | Sickly green ghost-light flicker | dim only |
| Starlight | Atmosphere | Single cold star-glint that twinkles | dim only |
| Bioluminescence | Atmosphere | Slow cyan-green glow that swells and fades | dim only |
| Underwater | Atmosphere | Sea-blue rings rippling outward | 25% of dim |
| Magical Glow | Magic | Soft violet pulse | 25% of dim |
| Divine Radiance | Magic | Warm golden sunburst pulse | 25% of dim |
| Arcane Ward | Magic | Cool blue, hexagonal shield pattern | 25% of dim |
| Portal | Magic | Violet inward spiral | 25% of dim |
| Storm | Magic | Blue-white veins of crackling energy | half of dim |
| Magical Darkness | Magic | A darkness source — carves gloom out of light | half of dim |
| Smoke Cloud | Magic | A darkness source — grey haze of thick smoke | half of dim |
Hover a group for a tooltip listing its presets, or any preset for a tooltip card describing the light and its exact settings (color, animation, intensity, attenuation), using Foundry's own localized animation names.
Hiding presets
If you only use a few presets, open Configure Settings → Light Presets → Configure Presets and untick the ones you don't need. Each group has a toggle for all its presets at once. A group with nothing left disappears from the toolbar, and if only one group is left its presets sit directly in the toolbar, one click away. The choice applies to the whole world, so every GM sees the same toolbar. Lights you've already placed are not affected. If you hide the preset you're currently using, new lights keep using it until you pick another.
How it works
- Clicking a preset stores its data in Foundry's core light palette setting (
core.ambientLightPalette), the V14 mechanism that supplies defaults for newly drawn lights. This is the same pattern core uses for its wall type presets.
- The dim radius always comes from your drag. Core hardcodes bright = ½ × dim during the drag; this module wraps
LightingLayer#_updateDragPreview so each preset's bright ratio (0, 0.25, or 0.5) applies live in the preview and in the created light. If your palette no longer matches any preset, core behavior is untouched.
- Presets fully specify their light config, so switching presets never inherits leftover values from a previous one.
- A light placed with a preset records it in
flags["light-presets"].preset, using the preset's key from the PRESETS table (presetTorch, presetFog, …). Macros and tools like Mass Edit can select by it. The keys are stable across releases; a light changed from its preset before it's placed isn't tagged, and the flag isn't updated if you edit the light afterwards.
- Opening or closing a group rebuilds only the lighting control's own tools and re-renders the toolbar; the other scene controls are never re-prepared. Group buttons resolve their
createData on read, so core's own pip logic keeps working even when you change the palette from the light config sheet rather than from a preset button.
Customizing
All presets live in a single table (PRESETS) at the top of scripts/main.js — color, animation, alpha, attenuation, brightRatio, and the group the preset belongs to. Add or edit entries and reload. Preset and group names and their tooltip text live in lang/en.json under LIGHTPRESETS.Preset.<key> and LIGHTPRESETS.Group.<key>; add a file for another language and list it under languages in module.json.
The groups themselves are the GROUPS table just above it: a key and a Font Awesome icon, with its name and description in lang/en.json. Add a group there and presets can name it; a preset naming a group that doesn't exist is reported in the console and never shown.
Contributing
Found a problem or want a preset that isn't here? Open an issue.
How to add a preset is in CONTRIBUTING.md; what changed in
each version is in CHANGELOG.md, and the release process in
RELEASING.md.
License
MIT. This module contains no Foundry VTT source code; it uses the Foundry API under the Limited License Agreement for Package Development. Icons are Font Awesome classes bundled with Foundry itself; no icon assets are distributed with this module.
