Automation: Item Triggers

Instead of manually playing cut-ins, you can configure them to trigger automatically when a specific item is used. This is done through the Item Configuration window.

🛠️ Accessing Item Config

1. Open the Character Sheet of the actor.
2. Locate the item you want to configure (e.g., a "Longsword", "Fireball", or a custom ability).
3. Click the Cinematic (⚡) button in the item window header. (On some systems, this may be in the item's title bar).

⚠️ 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).

🔗 Creating Trigger Rules

An item can have multiple trigger rules. This allows a single item to have different visual effects depending on the situation (e.g., one animation for a normal hit, and a more intense one for a Critical Hit or a specific dice roll).

How to Add a Rule

1. Add Rule: Click the Add Rule (+) button at the bottom of the config window.
2. Select Trigger Type: Choose when this rule should activate (e.g., On Attack, Dice Check).
3. Configure Condition: Depending on the type, enter the required values (text keyword, dice value, formula).
4. Select Preset: Choose which Cut-in Preset to play when the condition is met.
5. (Optional) Select Macro: Choose a Macro to execute alongside the preset.