https://wiki.returnofreckoning.com/index.php?action=history&feed=atom&title=API%3AWindowSetGameActionDataAPI:WindowSetGameActionData - Revision history2026-10-18T04:52:46ZRevision history for this page on the wikiMediaWiki 1.43.11https://wiki.returnofreckoning.com/index.php?title=API:WindowSetGameActionData&diff=30896&oldid=prevMaintenance script: UI Lua API import (WAR 1.4.8)2026-10-16T19:51:52Z<p>UI Lua API import (WAR 1.4.8)</p>
<p><b>New page</b></p><div>{{LuaApi|group=Window}}<br />
Attaches a game action, such as targeting a player or using an ability, to a window.<br />
<br />
<pre><br />
WindowSetGameActionData(windowName, actionType, actionId, actionText)<br />
</pre><br />
<br />
== Arguments ==<br />
;windowName : <code>string</code> – Name of the window.<br />
;actionType : <code>number</code> – The kind of action, a <code>GameData.PlayerActions.*</code> value. 0 removes the action.<br />
;actionId : <code>number</code> – The action's id, for example an ability id. Use 0 if the action does not need one.<br />
;actionText : <code>wstring</code> – Text for the action, for example the name of the player to target. Use <code>L""</code> if not needed. It must be a wide string.<br />
<br />
== Returns ==<br />
Nothing.<br />
<br />
== Details ==<br />
* Any action the window already has is removed first. If <code>actionType</code> is 0, no new action is attached, so <code>WindowSetGameActionData(name, 0, 0, L"")</code> clears the window.<br />
* <code>actionType</code> and <code>actionId</code> are truncated to whole numbers.<br />
* The stock UI relies on the client to carry out the action when the window is clicked. Its comments say so, for example ''"Targeting is handled by the WindowSetGameActionData() call."'' in <code>ea_battlegrouphud/source/battlegrouphud.lua</code>.<br />
* [[API:WindowGetGameActionData|WindowGetGameActionData]] reads the values back.<br />
* Passing a plain Lua string as <code>actionText</code> raises an ''Invalid Parameters'' error.<br />
* The ''No window specified'' error exists in the client but cannot be raised: a missing name is replaced by an empty string first, which gives the ''does not exist'' error.<br />
<br />
== Errors ==<br />
* <code>Error in function call 'WindowSetGameActionData': Window %s does not exist.</code><br />
* <code>Error in function call 'WindowSetGameActionData': Window %s is currently locked and may not be modified from lua. ...</code><br/>This check never triggers in the current client. See [[API:WindowSetShowing|WindowSetShowing]].<br />
<br />
== Example ==<br />
Clicking a group member's row targets that player, from <code>eatemplate_unitframes/source/groupmemberunitframe.lua</code>:<br />
<pre><br />
WindowSetGameActionData( self:GetName(), GameData.PlayerActions.SET_TARGET, 0, groupMemberName )<br />
</pre><br />
<br />
Setting and clearing an action button, from <code>ea_actionbars/source/actionbutton.lua</code>:<br />
<pre><br />
WindowSetGameActionData (actionName, actionType, actionId, L"")<br />
<br />
if (actionType == 0 and actionId == 0)<br />
then<br />
WindowSetGameActionData (actionName, 0, 0, L"")<br />
-- ...<br />
</pre><br />
<br />
== See also ==<br />
* [[API:WindowSetGameActionTrigger|WindowSetGameActionTrigger]]<br />
* [[API:WindowGetGameActionData|WindowGetGameActionData]]<br />
* [[API:WindowIsGameActionLocked|WindowIsGameActionLocked]]</div>Maintenance script