Maintenance script: UI Lua API import (WAR 1.4.8)

2026-10-16T19:41:57Z

UI Lua API import (WAR 1.4.8)

New page

{{LuaApi|group=Game}}
Asks the server to destroy the item in a given location and slot.

<pre>
DestroyItem(location, slot)
</pre>

== Arguments ==
;location : <code>number</code> – Where the item is, as a <code>GameData.ItemLocs</code> value (the stock UI passes <code>Cursor.Data.Source</code>).
;slot : <code>number</code> – Slot of the item within that location.

== Returns ==
Nothing.

== Details ==
* There is no confirmation step in the client. The stock UI shows a Yes/No dialog first and only calls <code>DestroyItem</code> when the player confirms.
* The request is only sent for the item locations the client handles here. For any other location the call does nothing.
* Whether the item is actually destroyed is decided by the server; the inventory updates when the server replies.
* The function needs at least two arguments and only reads the last two.

== Errors ==
None besides the ''Invalid Parameters'' argument check.

== Example ==
From <code>ea_cursor/source/cursor.lua</code> (<code>Cursor.DoDestroyItem</code>, the dialog's Yes callback):
<pre>
if( Cursor.Data.Source == Cursor.SOURCE_EQUIPMENT or
Cursor.Data.Source == Cursor.SOURCE_BANK or
Cursor.Data.Source == Cursor.SOURCE_INVENTORY or
... ) then
DestroyItem( Cursor.Data.Source, Cursor.Data.SourceSlot )
Cursor.Clear()
end
</pre>

== See also ==
* [[API:SetItemDragging|SetItemDragging]]
* [[API:SetCursor|SetCursor]]

API:DestroyItem - Revision history

Maintenance script: UI Lua API import (WAR 1.4.8)