A list of all Actions, Conditions and Expressions supported in this addon.
AbilityManagement
-
Actions
Activate ability {0}
Trigger an ability activation callback. Only works if ability is ready (off cooldown and enabled).
Clear all abilities
Remove all abilities from the object. Triggers removal event for each ability.
Create ability {0}
Give the object an ability. Creates a new ability slot if it doesn't exist.
Create ability {0} with {1} second cooldown (reset instantly: {2})
Give the object an ability and set its cooldown in one action. Useful for initial setup.
Create ability {0} with {1}s cooldown and {2} max stacks (reset instantly: {3})
Give the object an ability and set its cooldown and max stacks in one action. Perfect for charge-based abilities.
Create temporary ability {0} that expires after {1} seconds
Create an ability that automatically removes itself after a duration. If ability already exists, just schedules new removal time Perfect for temporary power-ups and time-limited buffs.
Remove ability {0}
Remove an ability from the object. Deletes all associated data.
Remove ability {0} after {1} seconds
Schedule automatic removal of an ability after a duration. Useful for temporary power-ups and time-limited abilities.
AbilityState
-
Actions
Set {0} active to {1}
Set whether an ability is currently active (for channeled/duration abilities).
Set {0} enabled to {1}
Enable or disable an ability. Disabled abilities cannot be activated even if off cooldown.
Cooldowns
-
Actions
Reset {0} cooldown
Instantly reset an ability's cooldown to 0, making it ready to use immediately.
Set {0} cooldown to {1} seconds
Set the cooldown time for an ability. The ability will not be usable until the cooldown expires.
CustomData
-
Actions
Set {0} data {1} to {2}
Store custom data on an ability (for passive bonuses, damage values, etc). Data is stored as strings.
Stacks
-
Actions
Add {1} stacks to {0}
Add charges to an ability. Will not exceed max stacks.
Consume 1 stack of {0}
Manually consume one charge of an ability without triggering activation. Starts stack regeneration.
Set {0} max stacks to {1}
Set the maximum number of charges an ability can have. Current stacks will be clamped to new max.
Set {0} stacks to {1}
Set the current number of charges for an ability. Clamped between 0 and max stacks.
Tags
-
Actions
Add tag {1} to ability {0}
Add a tag to an ability. Tags let you group abilities and manipulate them together.
Clear all tags from ability {0}
Remove all tags from an ability.
Remove all abilities with tag {0}
Remove every ability that has a specific tag. Fires OnAbilityRemoved for each one.
Remove tag {1} from ability {0}
Remove a specific tag from an ability.
Reset cooldown for abilities with tag {0}
Instantly reset the cooldown to 0 for every ability that has a specific tag.
Set abilities with tag {0} enabled to {1}
Enable or disable all abilities that have a specific tag. Useful for disabling a group of abilities during a stun or cutscene.
-
Conditions
Ability {0} has tag {1}
Check if an ability has a specific tag.
-
Expressions
CountAbilitiesByTag
Get the number of abilities that have a specific tag.
ListAbilitiesByTag
Get a comma-separated list of ability IDs that have a specific tag. Use with tokencount() and tokenat() to loop through them.
Query
-
Conditions
{0} cooldown {1} {2}
Compare the remaining cooldown time of an ability.
{0} stacks {1} {2}
Compare the current number of charges for an ability.
Has ability {0}
Check if the object has been granted a specific ability.
Has {0} stacks available
Check if an ability has at least one charge available.
Is {0} active
Check if an ability is currently active (for channeled/duration abilities).
Is {0} enabled
Check if an ability is enabled (can be used when off cooldown).
Is {0} ready
Check if an ability is off cooldown, has stacks available, and is enabled (ready to use).
Triggers
-
Conditions
On {0} activated
Triggered when an ability is activated.
On {0} created
Triggered when an ability is created for the object.
On {0} ready
Triggered when an ability's cooldown expires and becomes ready to use.
On {0} removed
Triggered when an ability is removed from the object. The ability may be removed due to expiration or manual removal.
On {0} max stacks reached
Triggered when attempting to add charges beyond the maximum stack limit. Useful for UI feedback or sound effects.
On {0} stack consumed
Triggered when a charge is consumed from an ability. The ability may lose charges due to activation or manual consumption.
On {0} stack gained
Triggered when a charge is regenerated or added to an ability. The ability may gain charges due to regeneration or manual addition.
Info
-
Expressions
GetAbilityCount
Get the total number of abilities currently granted.
GetAbilityData
Get custom data stored on an ability. Returns empty string if not found.
GetCooldownProgress
Get the cooldown progress from 0 (ready) to 1 (just started). Useful for UI progress bars.
GetCooldownRemaining
Get the remaining cooldown time in seconds for an ability.
GetExpirationProgress
Get the expiration progress from 0 (just created) to 1 (about to expire). Useful for countdown UI bars.
GetExpirationTime
Get the time remaining in seconds before an ability is automatically removed. Returns 0 if no removal scheduled.
GetMaxExpirationTime
Get the maximum expiration duration in seconds that was set for an ability. Returns 0 if no expiration was set.
GetMaxStacks
Get the maximum number of charges for an ability.
GetStackCooldownRemaining
Get the time remaining in seconds until the next stack regenerates.
GetStackProgress
Get the stack regeneration progress from 0 (about to regenerate) to 1 (just used). Useful for UI.
GetStacks
Get the current number of charges available for an ability.
ListActiveAbilities
Get a comma-separated list of all ability IDs currently granted.