Macro APITriggers
Combat Action Requested
Chooses the player's next combat action.
- Category
- Combat
- Runs when
- The player needs to act.
- Summary
- Chooses the player's next combat action.
- Version
- 1
Events
- system-combat-action-requested
Inputs
| Trigger | Input | Type | Description |
|---|---|---|---|
| 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. |
Blocks
| Block | Category | Summary |
|---|---|---|
| Use Potion Threshold | Combat | Checks whether a potion should be used at the default life threshold. |
| Retreat Below Life | Combat | Checks whether the player is below the default retreat threshold. |
| If Ability Ready | Combat | Checks whether a combat ability is ready and affordable. |
| If Enemy Low | Combat | Checks whether any active enemy is in the low life band. |
| If Heavy Intent | Combat | Checks whether any active enemy has heavy intent. |
| If Self Status | Combat | Checks the first status currently active on the player. |
| Attack | Combat | Returns attack to the active Combat Profile. |
| Focus Casting Enemy | Combat | Returns an attack decision targeting a casting enemy. |
| Use Ability | Combat | Returns a specific ability decision to combat. |
| Guard | Combat | Returns Guard as the selected combat ability. |
| Drink Potion | Combat | Returns drink potion to the active Combat Profile. |
| Retreat | Combat | Returns retreat to combat. |
| Pause | Flow | Returns pause to the Storyteller. |