WoW API: GetSpellCooldown

Reference e
AddOns WoW API Widget API XML UI Event API WoW Lua Macro API CVars Battle.net HOWTOs Snippets UI tech Categories

→ WoW API

← WoW API < GetSpellCooldown

Retrieves the cooldown data of the spell specified.

local start, duration = GetSpellCooldown(spellID, "bookType");

---

Arguments

(Number spellID)

spellID

The ID of the spell to retrieve cooldown data for

(string bookType)

bookType

BOOKTYPE_SPELL or BOOKTYPE_PET depending on whether you wish to query the player or pet spellbook.

---

Returns

(Number startTime, Number duration, Number enable)

startTime

The time when the cooldown started (as returned by GetTime()) or zero if no cooldown

duration

The number of seconds the cooldown will last, or zero if no cooldown

enable

Returns 1 when the spell cooldown starts, for abilities that can be toggled like Stealth, Shadowform this returns 0 when you activate it.

---

Example

local start, duration = GetSpellCooldown(spellID, BOOKTYPE_SPELL);
if ( start > 0 and duration > 0) then
	Print('Please wait ' .. duration - ( GetTime() - start) .. ' seconds before using this spell.');
else
	Print('Spell is ready.');
end

Result

Retrieves data. Does not (to my knowledge) actually change anything.

"For the Nature's Swiftness spell and posibly other spells that don't start their cooldown timer before they are used up the values retrieved by GetSpellCooldown change over time. The startTime returned is the current time (that this function was called), not the time the spell was cast. The duration is 0.001 not the spell's normal cooldown.

In this way we can use GetSpellCooldown to see if this type of spell is active on the player without having to look at buffs and debuffs."