Maintenance script: UI Lua API import (WAR 1.4.8)

2026-10-16T19:40:28Z

UI Lua API import (WAR 1.4.8)

New page

{{LuaApi|group=Item}}
Asks the server to attach an equipped trophy to a different point on the character.

<pre>
AttachTrophyToLocation(trophyPosition, trophyLocation, trophyLocIndex)
</pre>

== Arguments ==
;trophyPosition : <code>number</code> – Which trophy slot, 1 to 5 (the index into the [[API:GetTrophyData|GetTrophyData]] table).
;trophyLocation : <code>number</code> – Attachment point location (<code>trophyLocation</code> from [[API:GetLocationsForTrophies|GetLocationsForTrophies]]).
;trophyLocIndex : <code>number</code> – Attachment point index (<code>trophyLocIndex</code> from the same table), starting at 1.

== Returns ==
Nothing.

== Details ==
* The request is only sent when:
** the trophy slot holds a trophy (<code>GameData.ItemTypes.TROPHY</code>);
** the requested location or index differs from the one the trophy already has;
** the requested location passes the client's check against the trophy's allowed locations.
: Otherwise the call does nothing.
* The client does not range-check <code>trophyPosition</code>. Use 1 to 5.
* The function needs at least three arguments and only reads the last three.

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

== Example ==
Moving the selected trophy to the next free attachment point, from <code>default/ea_characterwindow/source/characterwindowtrophies.lua</code>:
<pre>
local trophyData = CharacterWindow.trophyData[CharacterWindow.currentlySelectedTrophyPosition]

local startIndex = CharacterWindow.GetIndexForTrophyLoc( trophyData.trophyLocation, trophyData.trophyLocIndex )
local index, attachPointData = CharacterWindow.GetNextAvailableAttachmentPoint( trophyData, startIndex+1 )

if index ~= 0 then
AttachTrophyToLocation( CharacterWindow.currentlySelectedTrophyPosition, attachPointData.trophyLocation, attachPointData.trophyLocIndex)
end
</pre>

== See also ==
* [[API:GetLocationsForTrophies|GetLocationsForTrophies]]
* [[API:GetTrophyData|GetTrophyData]]
* [[API:RequestEquipTrophy|RequestEquipTrophy]]

API:AttachTrophyToLocation - Revision history

Maintenance script: UI Lua API import (WAR 1.4.8)