GetActionCharges

Main Menu
WoW API Lua API FrameXML Widget API Widget scripts XML schema Events CVars Macro commands Combat Log Escape sequences Hyperlinks API changes HOWTOs wowuidev

Flavors
war within  mainline  cata  wrath  vanilla
Links
GitHub Search
Info
Added in 5.0.4 / 1.13.2

Returns information about the charges of a charge-accumulating player ability.

currentCharges, maxCharges, cooldownStart, cooldownDuration, chargeModRate = GetActionCharges(slot)

Arguments

slot

number - The action slot to retrieve data from.

Returns

currentCharges

number - The number of charges of the ability currently available.

maxCharges

number - The maximum number of charges the ability may have available.

cooldownStart

number - Time (per GetTime) at which the next charge cooldown began, or 2^32 / 1000 if the spell is not currently recharging.

cooldownDuration

number - Time (in seconds) required to gain a charge.

chargeModRate

number - The rate at which the charge cooldown widget's animation should be updated.

Details

• Abilities like [Roll] can be used by the player rapidly, and then slowly accumulate charges over time. The cooldownStart and cooldownDuration return values indicate the cooldown timer for the acquiring next charge (when currentCharges is less than maxCharges).
• If the queried spell does not accumulate charges over time (e.g. [Arcane Missiles] or [Jab]), this function does not return any values.

Patch changes

Patch 7.1.0 (2016-10-25): The chargeModRate return value was added.
Patch 5.0.4 (2012-08-28): Added.

See also

• GetSpellCharges() - Referring to any spell ID or localized spell name.