Maintenance script: UI Lua API import (WAR 1.4.8)

2026-10-16T19:49:09Z

UI Lua API import (WAR 1.4.8)

New page

{{LuaApi|group=Hotbar}}
Sets the name, text and icon of one of the player's macros.

<pre>
SetMacroData(name, text, iconNum, macroId)
</pre>

== Arguments ==
;name : <code>wstring</code> – Name of the macro. The client copies it into a buffer of 64 characters.
;text : <code>wstring</code> – Macro text (the command line it runs). The client copies it into a buffer of 256 characters.
;iconNum : <code>number</code> – Icon id of the macro, for [[API:GetIconData|GetIconData]].
;macroId : <code>number</code> – Macro slot, 1 to 48.

== Returns ==
Nothing.

== Details ==
* The macro in slot <code>macroId</code> is overwritten. A slot outside 1 to 48 is not written.
* After the call the client sets <code>GameData.Macros.macrosDirty</code> to <code>true</code> and broadcasts an event to the UI, also when the slot was out of range.
* If the client's macro list is not available, nothing happens.
* <code>name</code> and <code>text</code> must be wide strings; plain Lua strings raise an ''Invalid Parameters'' error.

== Errors ==
* <code>Error in function call ImportMacroData: You cannot change your macros while in combat.</code><br/>This check exists in the client but never triggers: the flag it tests is never set.
* The generic ''Invalid Parameters'' message when an argument has the wrong type.

== Example ==
From <code>ea_macrowindow/source/macrowindow.lua</code>:
<pre>
SetMacroData( TextEditBoxGetText( "EA_Window_MacroDetailsName" ), TextEditBoxGetText( "EA_Window_MacroDetailsText" ), EA_Window_Macro.iconNum, EA_Window_Macro.activeId )
</pre>

== See also ==
* [[API:GetMacrosData|GetMacrosData]]
* [[API:SetHotbarData|SetHotbarData]]

API:SetMacroData - Revision history

Maintenance script: UI Lua API import (WAR 1.4.8)