Maintenance script: UI Lua API import (WAR 1.4.8)

2026-10-16T19:42:44Z

UI Lua API import (WAR 1.4.8)

New page

{{LuaApi|group=Ability}}
Returns the cooldown of an ability for the player, in milliseconds.

<pre>
cooldown = GetAbilityCooldown(abilityId)
</pre>

== Arguments ==
;abilityId : <code>number</code> – Id of the ability. It is converted to a 16-bit integer.

== Returns ==
;cooldown : <code>number</code> – Cooldown in milliseconds. 0 for an unknown ability.

== Details ==
* The value is computed by the client for the player. A comment in <code>easystem_tooltips/source/abilitytooltips.lua</code> says it includes bonuses, unlike the <code>cooldown</code> field of [[API:GetAbilityData|GetAbilityData]], which is in seconds.
* 0 is returned when there is no player object.
* This is the length of the cooldown, not the time left. For the time left on a hotbar slot use [[API:GetHotbarCooldown|GetHotbarCooldown]].

== Errors ==
None besides the generic ''Invalid Parameters'' message when the argument is missing or not a number.

== Example ==
From <code>easystem_tooltips/source/abilitytooltips.lua</code>:
<pre>
-- Get the cooldown including potential bonuses from c instead of the value stored in abilityData.cooldown
local realCooldown = GetAbilityCooldown( abilityData.id ) / 1000
LabelSetText( windowName.."Cooldown", GetAbilityCooldownText( realCooldown ) )
</pre>

== See also ==
* [[API:GetHotbarCooldown|GetHotbarCooldown]]
* [[API:GetAbilityCastTime|GetAbilityCastTime]]

API:GetAbilityCooldown - Revision history

Maintenance script: UI Lua API import (WAR 1.4.8)