Maintenance script: UI Lua API import (WAR 1.4.8)

2026-10-16T19:45:16Z

UI Lua API import (WAR 1.4.8)

New page

{{LuaApi|group=Item}}
Returns the items in the player's five trophy slots.

<pre>
trophies = GetTrophyData()
</pre>

== Arguments ==
None.

== Returns ==
;trophies : <code>table</code> – Array of 5 [[API:GetInventoryItemData#Item data table|item data tables]], indexed by trophy position from 1 to 5.

== Details ==
* The table always has 5 entries. An empty trophy slot gets a blank item table (<code>id</code> 0, empty <code>name</code>).
* <code>trophyLocation</code> and <code>trophyLocIndex</code> in each table say where the trophy is attached. Compare them with the entries of [[API:GetLocationsForTrophies|GetLocationsForTrophies]].
* If there is no player object, or the Lua state is not available, the function returns nothing.
* A new table is built on every call. The stock UI caches it in <code>DataUtils.GetTrophyData()</code> (<code>easystem_utils/source/datautils.lua</code>) and rebuilds it only when <code>GameData.Player.trophyItemsDirty</code> is set.

== Errors ==
None.

== Example ==
From <code>default/easystem_utils/source/datautils.lua</code>:
<pre>
function DataUtils.GetTrophyData ()
if (GameData.Player.trophyItemsDirty)
then
GameData.Player.trophyItemsDirty = false
DataUtilsData.trophyItems = GetTrophyData()
end

return DataUtilsData.trophyItems
end
</pre>

== See also ==
* [[API:GetLocationsForTrophies|GetLocationsForTrophies]]
* [[API:AttachTrophyToLocation|AttachTrophyToLocation]]
* [[API:GetEquipmentData|GetEquipmentData]]

API:GetTrophyData - Revision history

Maintenance script: UI Lua API import (WAR 1.4.8)