Macro API
Inputs
Data available to macro triggers.
| Trigger | Input | Type | Description |
|---|---|---|---|
| Battle Ended | Source event | id | Timeline event where the battle ended. |
| Combat Action Requested | Round number | number | Current combat round number. |
| Combat Action Requested | Enemy count | number | Number of active enemies. |
| Combat Action Requested | Self life ratio | number | Current life divided by maximum life. |
| Combat Action Requested | Self mana ratio | number | Current mana divided by maximum mana. |
| Combat Action Requested | Self has life consumable | boolean | Whether a life-restoring consumable is available. |
| Combat Action Requested | Self statuses | array | Status keys currently active on the player. |
| Combat Action Requested | Guard ready | boolean | Whether Guard is currently ready and affordable. |
| Combat Action Requested | First ready non-basic ability | string | The first ready non-basic ability key, or null when none is ready. |
| Combat Action Requested | Abilities | array | Ability readiness records with key, cooldown, and affordability. |
| Combat Action Requested | Rend ready | boolean | Whether Rend is currently ready and affordable. |
| Combat Action Requested | Enemies | array | Active enemies with index, life band, tier, statuses, and intent. |
| Combat Action Requested | Enemy intent | object | Current enemy intent, or null when no action is being prepared. Intent records include kind, damageType, and magnitudeBand. |
| Combat Action Requested | Any heavy intent | boolean | Whether any enemy is preparing a heavy action. |
| Combat Action Requested | Any enemy casting | boolean | Whether any enemy is preparing a cast. |
| Combat Action Requested | Any enemy low | boolean | Whether any enemy is in the low life band. |
| Combat Participant Defeated | Source event | id | Timeline event where the defeat appeared. |
| Currency Drop Found | Currency amount | number | The amount of currency available to claim. |
| Currency Drop Found | Source event | id | The game event where the currency appeared. |
| Damage Received | Life ratio | number | Current life divided by maximum life after damage. |
| Damage Received | Source event | id | Timeline event where damage appeared. |
| Enemy Intent Revealed | Source event | id | Timeline event where the enemy intent appeared. |
| Enemy Intent Revealed | Enemy intent | object | The revealed intent with abilityKey, kind, damageType, and magnitudeBand. |
| Enemy Spotted | Life ratio | number | Current life divided by maximum life. |
| Enemy Spotted | Has life consumable | boolean | Whether a life-restoring consumable is available. |
| Gathering Node Found | Resource type | string | The kind of resource that can be gathered. |
| Gathering Node Found | Source event | id | The game event where the resource appeared. |
| Gathering Node Found | Region | string | The area where the resource was found. |
| Item Drop Found | Item type | string | The kind of item that dropped. |
| Item Drop Found | Quantity | number | The number of items in the drop. |
| Item Drop Found | Source event | id | The game event where the item appeared. |
| Loot Container Found | Container type | string | The kind of container that was found. |
| Loot Container Found | Source event | id | The game event where the container appeared. |
| Loot Container Found | Region | string | The area where the container was found. |