Installation

Requirements

Token Light Condition requires 3DS:ATLAS. Install and enable 3DS:ATLAS alongside Token Light Condition. 3DS:ATLAS provides the update notices, troubleshooter, and logging shared across 3DS modules.

Foundry Module Manager

1. Open Configuration and Setup → Add-on Modules → Install Module.
2. Search for Token Light Condition and click Install.
3. In a world, open Manage Modules and enable Token Light Condition and 3DS:ATLAS.

Manual install

Paste this manifest URL into the Install Module dialog:

https://github.com/Sayshal/tokenlightcondition/releases/latest/download/module.json

Compatibility

Requirement	Value
Minimum Foundry version	14
Verified Foundry version	14.364
Supported systems	D&D 5e, Pathfinder 2e

See System Support for per-system behavior.

First-run

After enabling the module in a world:

1. Open any scene with at least one ambient or token light source.
2. Switch the scene controls to the Lighting tool palette.
3. The Toggle Token Light Condition button (eye-low-vision icon) sits at the end of the toolbar. It is on by default and matches the world enable setting. See Scene Control Toggle.
4. Drop a character or NPC token onto the scene. The module flags it as initialized and immediately calculates its lighting condition. A token with HP above 0 receives a lighting condition. A token at 0 HP has its existing lighting effects cleared.
5. Right-click the token to see the lighting indicator in the token HUD. See Token HUD Indicator.

If the toolbar button is missing, the GM permission check failed: only the GM client adds the control.