Chris's Premades
When Chris’s Premades is installed and its Effect Interface setting is on, Token Light Condition routes effect creation through Chris’s Premades rather than creating ActiveEffects directly on the actor.
When the integration activates
Section titled “When the integration activates”Both conditions must be true at world ready time:
game.modules.get('chris-premades')?.activeis true.game.settings.get('chris-premades', 'effectInterface')istrue.
If either is false, the module falls back to its normal per-system path described in System Support. No integration code runs.
The check runs once after the world is ready, with a short delay to let Chris’s Premades finish its own init. It does not re-run when Chris’s Premades’ setting is toggled at runtime. Reload the world after enabling its Effect Interface for the integration to take effect.
What gets created
Section titled “What gets created”During initialization the module looks for the Chris’s Premades effect-interface Item, identified by item.flags['chris-premades'].effectInterface. If found:
- The module checks whether that Item already has effects with
flags.tokenlightcondition.type === 'dark'or'dim'. - For each missing one, it creates an ActiveEffect on the Item using the same
EFFECT_DATAfactory as the generic path: same names, ids, icons, and statuses described in Active Effects.
The Chris’s Premades Item holds the Dark Lighting and Dim Lighting effect templates that will be applied to tokens.
Runtime application
Section titled “Runtime application”When a system on the generic effect path resolves a token to Dark or Dim:
- The module re-checks that Chris’s Premades is active and its Effect Interface is on.
- It locates the matching effect on the Chris’s Premades Item.
- It clones the effect’s data, sets
statuses: [effectType], and creates an ActiveEffect on the actor withkeepId: true.
If the Item or the matching effect cannot be found at apply time, the module falls back to creating the effect using the local EFFECT_DATA factory. No effect creation is lost.
Clearing always uses the generic clear path: any ActiveEffect on the actor whose flags.tokenlightcondition.type is set is deleted, regardless of how it was created.
PF2e behavior
Section titled “PF2e behavior”The Chris’s Premades integration is a no-op on Pathfinder 2e. PF2e systems use the Item-based effect path described in System Support and never route through Chris’s Premades.
Diagnosing integration issues
Section titled “Diagnosing integration issues”Set the logging level to its most verbose option in 3DS:ATLAS to see console output confirming the integration, including when the Chris’s Premades effect Item cannot be found. If that happens, recreate the Item from Chris’s Premades’ own configuration and reload the world.