WoW:API GetMasterLootCandidate: Difference between revisions
(→Notes) |
(function requires a slot index of the loot window together with a raid index (slot, index) so updated the arguments and the example) |
||
| Line 3: | Line 3: | ||
Returns the name of the player at the specified index, who would receive an item assigned by [[API GiveMasterLoot|GiveMasterLoot(slot, index)]] using the same index. | Returns the name of the player at the specified index, who would receive an item assigned by [[API GiveMasterLoot|GiveMasterLoot(slot, index)]] using the same index. | ||
candidate = GetMasterLootCandidate(index); | candidate = GetMasterLootCandidate(slot, index); | ||
== Parameters == | == Parameters == | ||
=== Arguments === | === Arguments === | ||
;slot | |||
: The loot slot number of the item you want to get information about | |||
:;index : The number of the player whose name you wish to return. Typically between 1 and 40. | :;index | ||
:: The number of the player whose name you wish to return. Typically between 1 and 40. Can exceed the value of [[API GetNumRaidMembers|GetNumRaidMembers()]] | |||
=== Returns === | === Returns === | ||
:;candidate : The name of the player at '''index'''. | :;candidate | ||
:: The name of the player at '''index'''. | |||
== Example == | == Example == | ||
for | for li = 1, GetNumLootItems() do | ||
for ci = 1, 40 do | |||
DEFAULT_CHAT_FRAME:AddMessage( | if GetMasterLootCandidate(li, ci) then | ||
end | DEFAULT_CHAT_FRAME:AddMessage(ci.." -> "..GetMasterLootCandidate(li, ci)) | ||
end | |||
end | |||
end | end | ||
Lists master loot candidates by index. | Lists master loot candidates by index. - These are the people capable of receiving loot from the Master Looter. This function is only usable by the master looter. | ||
== See Also == | == See Also == | ||
:* [[API GetNumRaidMembers|GetNumRaidMembers()]] | :* [[API GetNumRaidMembers|GetNumRaidMembers()]] | ||
Revision as of 21:54, 30 November 2019
← WoW API < GetMasterLootCandidate
Returns the name of the player at the specified index, who would receive an item assigned by GiveMasterLoot(slot, index) using the same index.
candidate = GetMasterLootCandidate(slot, index);
Parameters
Arguments
- slot
- The loot slot number of the item you want to get information about
- index
- The number of the player whose name you wish to return. Typically between 1 and 40. Can exceed the value of GetNumRaidMembers()
Returns
- candidate
- The name of the player at index.
Example
for li = 1, GetNumLootItems() do
for ci = 1, 40 do
if GetMasterLootCandidate(li, ci) then
DEFAULT_CHAT_FRAME:AddMessage(ci.." -> "..GetMasterLootCandidate(li, ci))
end
end
end
Lists master loot candidates by index. - These are the people capable of receiving loot from the Master Looter. This function is only usable by the master looter.
See Also
Notes
This appears not to work unless you are the master looter, and not until the list of candidates has been built by the system, which looks like after you first try and assign an item.
Also if you were master looter of a group, and then join another group later and are not the master looter, it will return the names of candidates from your previous group. -- Haarm
This does not return consistent results from invocation to invocation. With a simple for loop over two members of a party, GetMasterLootCandidate(1) was not always the same member of the party. No PARTY_MEMBERS_CHANGED events fired, either. -- Hazara Khan