Automation: Actor Triggers

Actor Triggers allow your character to react to the environment, chat messages, or their own status automatically. These are configured in the Triggers tab of the Cinematic Configuration window (Actor Sheet Header > ⚡).

⚠️ IMPORTANT: Link a Preset or Macro!

Each trigger requires at least a Preset or a Macro (or both) to do anything useful.

• Preset: WHAT to play? (e.g., "Critical Cut-in", "Danger Effect") — the visual/audio cut-in.
• Macro: (Optional) A Foundry Macro to execute when the trigger fires. Runs with { actor, item, speaker } context.

A trigger can play a preset, run a macro, or do both simultaneously. If both fields are empty, the trigger is ignored.

Macro-only triggers: You can leave the preset empty and only assign a macro — useful for non-visual automation (e.g., applying status effects, posting to chat, triggering other modules).

Image by shakyeah(Discord)

❤️ Resource Triggers (HP, MP, Ammo)

The module can monitor your character's vital statistics and play a cut-in when they cross a specific threshold.

New Features: Mode & Type

Unlike the old version, you can now track absolute numbers (like Ammo) or detect healing.

1. Select Path: Use the Helper Dropdown to see valid attributes (e.g., system.attributes.hp.value).
2. Select Mode:
   • 📉 Decrease: Triggers when the value drops below the threshold (e.g., Taking Damage).
   • 📈 Increase: Triggers when the value goes above the threshold (e.g., Healing, buffing).
3. Select Type:
   • % Percent: Calculates percentage based on .max value (e.g., "Below 50% HP").
   • № Value: Checks the raw number (e.g., "Ammo drops to 0", "Spell Slots remaining: 1").
4. Set Threshold: Enter the target number or percentage.

Custom Max Value