View source for API:GetLootRollData

{{LuaApi|group=Game}}
Returns the items currently up for a group loot roll (Need / Greed / Pass).

<pre>
rolls = GetLootRollData()
</pre>

== Arguments ==
None.

== Returns ==
;rolls : <code>table</code> – Array of 10 roll tables, indexed from 1 to 10.

Each roll table has these fields:
{| class="wikitable"
! Key !! Type !! Meaning
|-
| <code>itemData</code> || <code>table</code> || The item, as an [[API:GetInventoryItemData#Item data table|item data table]].
|-
| <code>timer</code> || <code>number</code> || Time left to roll.
|-
| <code>lootSlot</code> || <code>number</code> || Slot of the item in its loot source. Passed to [[API:SelectItemRollChoice|SelectItemRollChoice]].
|-
| <code>rollChoice</code> || <code>number</code> || The player's choice so far. <code>-1</code> if no choice has been made.
|-
| <code>sourceId</code> || <code>number</code> || Id of the loot source. Passed to [[API:SelectItemRollChoice|SelectItemRollChoice]].
|-
| <code>allowNeed</code> || <code>boolean</code> || <code>true</code> if the player may roll Need.
|}

== Details ==
* The pending rolls come first. The rest of the 10 entries are blank: an empty item (<code>itemData.id</code> 0), <code>timer</code> 0, <code>lootSlot</code> 0, <code>rollChoice</code> -1, <code>sourceId</code> 0 and <code>allowNeed</code> <code>true</code>.
* If the Lua state is not available, the function returns nothing.

== Errors ==
None.

== Example ==
From <code>ea_lootwindow/source/lootrollwindow.lua</code>:
<pre>
EA_Window_LootRoll.lootData = GetLootRollData()
...
for lootIndex, rollData in ipairs( EA_Window_LootRoll.lootData )
do
    if( rollData.itemData.id ~= 0 and rollData.rollChoice == EA_Window_LootRoll.ROLL_CHOICE_INAVLID)
</pre>

Passing automatically when the timer runs out, from the same file:
<pre>
SelectItemRollChoice( rollData.sourceId, rollData.lootSlot, EA_Window_LootRoll.ROLL_CHOICE_PASS )
</pre>

== See also ==
* [[API:SelectItemRollChoice|SelectItemRollChoice]]
* [[API:GetInventoryItemData|GetInventoryItemData]]