https://wiki.returnofreckoning.com/index.php?action=history&feed=atom&title=API%3AActionButtonGroupSetTimerAPI:ActionButtonGroupSetTimer - Revision history2026-10-17T11:51:15ZRevision history for this page on the wikiMediaWiki 1.43.11https://wiki.returnofreckoning.com/index.php?title=API:ActionButtonGroupSetTimer&diff=30161&oldid=prevMaintenance script: UI Lua API import (WAR 1.4.8)2026-10-16T19:40:13Z<p>UI Lua API import (WAR 1.4.8)</p>
<p><b>New page</b></p><div>{{LuaApi|group=ActionButtonGroup}}<br />
Starts or clears the cooldown timer on one button of an ActionButtonGroup.<br />
<br />
<pre><br />
ActionButtonGroupSetTimer(groupName, buttonIndex, total, remaining)<br />
</pre><br />
<br />
== Arguments ==<br />
;groupName : <code>string</code> – Name of an ActionButtonGroup window.<br />
;buttonIndex : <code>number</code> – Button number, starting at 1.<br />
;total : <code>number</code> – Full length of the cooldown in seconds.<br />
;remaining : <code>number</code> – Seconds of cooldown left.<br />
<br />
== Returns ==<br />
Nothing.<br />
<br />
== Details ==<br />
* The client stores <code>total</code> and the time at which the cooldown ends (now + <code>remaining</code>) and updates the button's countdown text at once.<br />
* If <code>total</code> or the time left is 0 or less, the timer is cleared and the countdown text is emptied. The stock UI passes <code>0, 0</code> to clear a timer.<br />
* The countdown text shows:<br />
** under 2.5 seconds left: the seconds with one decimal;<br />
** up to 90 seconds left: whole seconds;<br />
** more than 90 seconds left: whole minutes.<br />
: It is followed by the seconds or minutes abbreviation set with [[API:ActionButtonGroupSetTimeAbbreviations|ActionButtonGroupSetTimeAbbreviations]], if one is set.<br />
* <code>buttonIndex</code> must be between 1 and the number of buttons; otherwise the ''not a valid ButtonIndex'' error is raised. Fractions are dropped.<br />
<br />
== Errors ==<br />
* <code>Error in function call 'ActionButtonGroupSetTimer': Window %s does not exist</code><br />
* <code>Error in function call 'ActionButtonGroupSetTimer': Window %s is not a ActionButtonGroup</code><br />
* <code>Error in function call 'ActionButtonGroupSetTimer': '%d' is not a valid ButtonIndex. (NumButtons = '%d')</code><br />
<br />
== Example ==<br />
An item cooldown, from <code>ea_backpackwindow/source/backpackiconview.lua</code>:<br />
<pre><br />
local cooldownTimeLeft, totalCooldownTime = EA_Window_Backpack.GetItemCooldownTimers( itemData )<br />
if( cooldownTimeLeft ~= nil )<br />
then<br />
ActionButtonGroupSetTimer( buttonGroupName, buttonIndex, totalCooldownTime, cooldownTimeLeft )<br />
else<br />
ActionButtonGroupSetTimer( buttonGroupName, buttonIndex, 0, 0 )<br />
end<br />
</pre><br />
<br />
== See also ==<br />
* [[API:ActionButtonGroupSetTimeAbbreviations|ActionButtonGroupSetTimeAbbreviations]]<br />
* [[API:ActionButtonGroupSetTimeFormat|ActionButtonGroupSetTimeFormat]]<br />
* [[API:CooldownDisplaySetCooldown|CooldownDisplaySetCooldown]]</div>Maintenance script