A module that allows users to embed macros directly into effects. These macros are then called automatically when the appropriate trigger happens. The options are:
- When an effect is created.
- When an effect is deleted.
- When an effect is toggled (on, off, or both).
- When the actor who has the effect starts their turn.
- When the actor who has the effect ends their turn.
- At the start of any combatant's turn.
- When the actor who has the effect is marked defeated in combat.
- At the start of a combat round.
- At the end of a combat round.
- When combat is started.
- When combat is ended.
An effect can have a macro of any of these types, not just one. There is also the static 'never' type meant for being explicitly called by other scripts. This type is never called automatically.
How to
Macros are added in the ActiveEffect config. Selecting the type of trigger and clicking 'Add Macro' (or 'Edit Macro' for an existing macro) opens a macro editor. When an embedded macro is triggered, it is executed for the owner of the actor who has the effect. If no such owner, then it is executed as if by the GM.
The module will automatically iterate over all effects that currently affect the actor.
Script Helpers
By default, these variables are pre-defined in any effect macro.
effect: The effect itself.actor: The actor who owns the effect (even if the effect is on an item). If no actor, thennull.character: The user's assigned actor. If no assigned actor, thennull.token: If the actor is synthetic (unlinked), thentokenis the is the token placeable on the actor's scene, otherwise the first token found on the currently viewed scene belonging toactor. If none found, thennull.scene: The scene on whichtokenis embedded. If there is no token, then the currently active scene is used. If no scene, thennull.origin: The document thatActiveEffect#originpoints to. If no such thing, thennull.speaker: The 'speaker' object normally used in chat messages, speaking as theactorif they exist.item: If the effect is on an item and not an actor, this is that, otherwisenull.
Additionally, the module has a small api and system-specific triggers. See the readme on github for details.