https://wiki.returnofreckoning.com/index.php?action=history&feed=atom&title=API%3ARequestEquipTrophyAPI:RequestEquipTrophy - Revision history2026-10-18T04:54:20ZRevision history for this page on the wikiMediaWiki 1.43.11https://wiki.returnofreckoning.com/index.php?title=API:RequestEquipTrophy&diff=30669&oldid=prevMaintenance script: UI Lua API import (WAR 1.4.8)2026-10-16T19:48:12Z<p>UI Lua API import (WAR 1.4.8)</p>
<p><b>New page</b></p><div>{{LuaApi|group=Item}}<br />
Asks the server to move a trophy into one of the player's trophy slots and, optionally, to attach it to a point on the character.<br />
<br />
<pre><br />
RequestEquipTrophy(sourceLocation, sourceSlot, trophySlot, trophyLocation, trophyLocIndex)<br />
</pre><br />
<br />
== Arguments ==<br />
;sourceLocation : <code>number</code> – Where the trophy is now, as a <code>GameData.ItemLocs</code> value.<br />
;sourceSlot : <code>number</code> – Slot of the trophy in <code>sourceLocation</code>, starting at 1.<br />
;trophySlot : <code>number</code> – The equipment slot to put it in. Must be one of the five trophy slots; the stock UI computes it as <code>position + GameData.Player.c_TROPHY_START_INDEX - 1</code>.<br />
;trophyLocation : <code>number</code> – Attachment point location, as returned in <code>trophyLocation</code> by [[API:GetLocationsForTrophies|GetLocationsForTrophies]].<br />
;trophyLocIndex : <code>number</code> – Attachment point index (<code>trophyLocIndex</code> from the same table), starting at 1. 0 means "do not attach".<br />
<br />
== Returns ==<br />
Nothing.<br />
<br />
== Details ==<br />
* If <code>trophySlot</code> is not one of the trophy slots, nothing is sent.<br />
* Otherwise the client first sends a move request from the source slot to the trophy slot.<br />
* Then, if <code>trophyLocIndex</code> is not 0, it looks at the item currently in the source slot. A second request, to set the attachment point of the trophy slot, is sent only when:<br />
** the item is a trophy (<code>GameData.ItemTypes.TROPHY</code>);<br />
** its current <code>trophyLocation</code>/<code>trophyLocIndex</code> differ from the requested ones;<br />
** the requested location passes the client's check against the trophy's allowed locations.<br />
* <code>GameData.ItemLocs.BANK</code> is not supported as a source location by the slot conversion this function uses.<br />
* The function needs at least five arguments and only reads the last five.<br />
<br />
== Errors ==<br />
None besides the generic ''Invalid Parameters'' message when an argument is not a number.<br />
<br />
== Example ==<br />
From <code>default/ea_characterwindow/source/characterwindowtrophies.lua</code> (<code>CharacterWindow.AutoAttachTrophy</code>):<br />
<pre><br />
local trophyLocation = GameData.Player.c_INVALID_TROPHY_LOCATION<br />
local trophyLocIndex = 0<br />
...<br />
local index, attachPointData = CharacterWindow.GetNextAvailableAttachmentPoint( itemData )<br />
if index ~= 0 then<br />
trophyLocation = attachPointData.trophyLocation<br />
trophyLocIndex = attachPointData.trophyLocIndex<br />
end<br />
...<br />
RequestEquipTrophy( sourceLocation, sourceSlot, trophySlot, trophyLocation, trophyLocIndex )<br />
</pre><br />
<br />
== See also ==<br />
* [[API:AttachTrophyToLocation|AttachTrophyToLocation]]<br />
* [[API:GetLocationsForTrophies|GetLocationsForTrophies]]<br />
* [[API:GetTrophyData|GetTrophyData]]<br />
* [[API:RequestMoveItem|RequestMoveItem]]</div>Maintenance script