Skip to content
3 Death Saves

Token Light Condition

Track every token's lighting condition automatically. Honours walls, elevation, scene lighting, darkness sources, and light-restricting tiles.
Install View on Foundry Support on Patreon

Getting started

Section titled “Getting started”

Start with Installation. How It Works covers the calculation pipeline end to end.

Features

Section titled “Features”

Automatic per-token tracking

Section titled “Automatic per-token tracking”

An eligible token is a character or NPC with HP above zero. Every eligible token recalculates its Bright, Dim, or Dark condition on movement, scene light changes, ambient light edits, token-light edits, wall and door changes, light-restricting tile changes, and HP changes. See How It Works.

Status effects you can read elsewhere

Section titled “Status effects you can read elsewhere”

The Dark Lighting and Dim Lighting active effects expose dark and dim status sets that any other module can consume. Tracking-only mode keeps the token flag without applying the visible effect. See Active Effects.

API for other modules

Section titled “API for other modules”

Other modules and macros read a token’s stored light level, calculate a level for any position, or force a full refresh through the module API. A hook reports every committed light level change. See Module API.

HUD indicator

Section titled “HUD indicator”

Right-clicking a token opens the token HUD with a coloured icon: a hollow moon for dark, a filled moon for dim, and a sun for bright. Both GMs and players see it. See Token HUD Indicator.

Realistic light handling

Section titled “Realistic light handling”

Each light is tested with Foundry’s own point test, and walls that block light also block the calculation. A light reaches a token above or below it within its radius, and its bright core is measured the same way. A light-restricting tile blocks light from above it from reaching a token beneath it. See Light Source Handling.

System and integration aware

Section titled “System and integration aware”

D&D 5e uses ActiveEffects, while Pathfinder 2e uses Item-based effects with RollOption rules (lighting:darkness, lighting:dim-light). Chris’s Premades routes through its Effect Interface. See System Support and Chris’s Premades.

Support

Section titled “Support”