Maintenance script: UI Lua API import (WAR 1.4.8)

2026-10-16T19:40:19Z

UI Lua API import (WAR 1.4.8)

New page

{{LuaApi|group=ItemEnhancement}}
Asks the server to put an enhancement item from the backpack into a slot of the item being enhanced.

<pre>
AddItemEnhancement(enhancementSlot, inventorySlot)
</pre>

== Arguments ==
;enhancementSlot : <code>number</code> – Enhancement slot on the item, <code>1</code> to <code>3</code>.
;inventorySlot : <code>number</code> – Slot of the enhancement item in the main inventory backpack, starting at 1.

== Returns ==
Nothing.

== Details ==
* Nothing is sent if <code>enhancementSlot</code> is not 1, 2 or 3, or if <code>inventorySlot</code> is less than 1 or above the inventory slot limit the client stores for the player.
* Otherwise an "add enhancement" request is sent to the server. The client does not check that a session is open or that the item fits the slot; the stock UI checks the slot type itself before calling.
* If one of the player's state flags blocks item enhancement, no request is sent and a built-in error message is printed to the Chat log instead.
* The function needs at least two arguments and only reads the last two.

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

== Example ==
Dropping an enhancement from the cursor onto a slot, from <code>default/ea_itemenhancementwindow/source/itemenhancementwindow.lua</code>:
<pre>
if DataUtils.SlotIsAllowedForItem(itemEquipSlot, enhancementData) then
-- Request that the server slot this enhancement here (and calculate bonus, etc...)
AddItemEnhancement (g_clickedEnhSlotId, Cursor.Data.SourceSlot)
else
EnhancementPlacementError (StringTables.Default.INVALID_LOCATION)
end
</pre>

== See also ==
* [[API:RemoveItemEnhancement|RemoveItemEnhancement]]
* [[API:BeginItemEnhancement|BeginItemEnhancement]]
* [[API:FuseItemEnhancements|FuseItemEnhancements]]

API:AddItemEnhancement - Revision history

Maintenance script: UI Lua API import (WAR 1.4.8)