Maintenance script: UI Lua API import (WAR 1.4.8)

2026-10-16T19:40:34Z

UI Lua API import (WAR 1.4.8)

New page

{{LuaApi|group=ItemEnhancement}}
Asks the server to start an item enhancement session for an item in the backpack.

<pre>
BeginItemEnhancement(inventorySlot)
</pre>

== Arguments ==
;inventorySlot : <code>number</code> – Slot of the item to enhance in the main inventory backpack, starting at 1.

== Returns ==
Nothing.

== Details ==
* If <code>inventorySlot</code> is less than 1 or above the inventory slot limit the client stores for the player, nothing happens.
* Otherwise a "begin enhancement" request for that item is sent to the server, and the client marks an enhancement session as open. [[API:EndItemEnhancement|EndItemEnhancement]] only sends its request while this mark is set.
* The client function does not open any window itself.
* 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 session is still marked as open in this case.
* Exactly one argument must be passed.

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

== Example ==
Shift-right-clicking an enhanceable item in the backpack, from <code>default/ea_backpackwindow/source/backpackutils.lua</code>:
<pre>
elseif (isEnhanceable and shiftPressed) then
BeginItemEnhancement (slot)
</pre>

== See also ==
* [[API:AddItemEnhancement|AddItemEnhancement]]
* [[API:RemoveItemEnhancement|RemoveItemEnhancement]]
* [[API:FuseItemEnhancements|FuseItemEnhancements]]
* [[API:EndItemEnhancement|EndItemEnhancement]]

API:BeginItemEnhancement - Revision history

Maintenance script: UI Lua API import (WAR 1.4.8)