Lootster 3.x.x+ by Mackenz is licensed under a Creative Commons Attribution-Noncommercial-No Derivative Works 3.0 United States License.
Lootster is a loot rolling interface that allows you to call for and capture loot roll, arbitrate ties and announce winner(s). In addition to managing simple rolls, it also manges various DKP styles, including the ability to automatically record points credited for attendance and debited for loot. For more information see the FAQ.
The WoW 3.2 patch introduced non-heroic and heroic loot with the same name. To support existing DKP systems (EQDKP, NDKP and Null DKP), I have chosen to differentiate the two types of loot with a " (H)" suffix on the item name of heroic items. This means that the item databases of those systems should use the same " (H)" suffix so that Lootster can correctly find and manage DKP settings and overrides for those heroic items.
The WoW 4.3 patch introduced a new loot tier, raid finder, with the same name as non-heroic and heroic loot. To support existing DKP systems (EQDKP, NDKP and Null DKP), I have chosen to differentiate the extra type of loot with an " (RF)" suffix on the item name of raid finder items. This means that the item databases of those systems should use the same " (RF)" suffix so that Lootster can correctly find and manage DKP settings and overrides for those raid finder items.
Please use a good error catcher like Bugsack (requires !BugGrabber), and provide the entire error text with as much information on how to recreate the problem. Report the problem via the CurseForge ticket system to ease tracking.
Although basic roll capture will work in French, German and Spanish, the additional abilities (loot capture) will not. Spanish has a partial translation (thank you to PatoDaia). If you would like to contribute a translation for this addon, let me know via private message on this site. You will be given credit for the translation.
Unzip into <WoW Directory>\Interface\Addons.
The user interface is used to perform all functions, and call be toggled (shown/hidden) through three methods:
/lootster or /ls command;
To reset the various frame positions if they are dragged offscreen, use the command
line /ls resetui to reset their positions.
The user interface can be moved anywhere on the screen via dragging the Lootster box. If the minimap button is not used, then the small frame will be shown, and visa versa.
See the version history document for a complete version history of Lootster.
Boss detection on complex/multi-boss fights might be incomplete. There may also be misentered boss details. Please report these so they can be corrected.
No updates are planned at this time.
Lootster 3.x.x+ by Mackenz is licensed under a Creative Commons Attribution-Noncommercial-No
Derivative Works 3.0 United States License.
Since reading a user guide would be like watching paint dry, I have written a FAQ to try to narrow the discussion. I will be adding to the FAQ as questions are raised in the commentary.
A red link in the item list means that you have not yet 'seen' the item in-game, and it is therefore not in your item 'cache'. Such links are regarded as 'unsafe'. Blizzard builds a cache of all items you have seen in-game, where 'seen' means an item:
These links are regarded as unsafe because attempting to get the item information may result in a disconnect. Generally, you can get the information for these links (by right-clicking the link in the Lootster item list) reliably every one or two seconds when on the live version of WoW, although there is still a chance you might be disconnected - in which case, slow down the right-clicking. You should be more cautious on the PTR (Public Testing Realm) of WoW, with right-clicking every few seconds as a starting point.
The reason for this behaviour is to prevent addons from 'sniffing' for new items so that they can be added to the various WoW information web sites. This is why a PTR is much more sensitive since it will be a source of new content and new items.
Note that your item cache will be empty (of course) after installation (of the live or PTR version of WoW). The item cache may also be cleared after a patch, and you may be directed to delete you Cache directory when troubleshooting. Be cautious if you see red links in your lists when logging in!
Simple rolls are those that are in essence either need or greed. Generally you won't have Lootster tracking dungeons ('raids'), bosses, attendance and loot, though you could. Currently supported simple roll types are:
Point system rolls are those that may have various loot purposes (such as main-spec, off-spec, shard), and where the loot is distributed using a points system. Generally, you will have Lootster tracking raids, bosses, attendance and loot, though you don't have to. Currently supported point system types are:
Lootster can capture rolls and sort them according to priority. Priority can be based on item usage, player points in the selected points system, membership (Full/Trial/Applicant) and toon type (Main/Alt).
It can handle rolling on more that one of an item in a single roll call. When there are tied players, it will announce outright winners (if any), then call for any tied players to reroll, ensuring only those players are accepted. Lootster will enforce class restrictions placed on an item for 'needy' rolls, whether they be inherent with the item (like armour tokens) or have been manually restricted.
Players also have the option to type 'pass' into party/raid chat, which will mark the player as having passed. A player can /roll then type 'pass' into party/raid chat, which will cause Lootster to remember the roll but not consider them when determining a winner. A player can then type 'reclaim' to reclaim a previously passed roll. Also, when 100/1000 or USAGE rolling is in effect, a player can 'downrank' a previous roll by performing a roll with lower usage priority. A player can neither reclaim the previous roll, nor roll usage that has a higher priority than the usage for which they rolled (for example, they cannot roll Greed then try to roll Need)
The Lootster pages are selected via the buttons on the bottom of the main user interface:
The Lootster Option page tabs are selected at the top of the Options page:
Note that some of these settings will become read-only when a roll call is made to prevent changes while players roll.
The sequence of actions for handling player rolls is very similar no matter what rolling mode is in used, with only slight variations:
By announcing the winners, Lootster bookkeeps the usage (Main-Spec, Off-Spec etc) for which each of the winners rolled. When not auto-looting DKP items, the item is booked as is.
When auto-looting DKP items, Lootster will cross check the item when looted by the player. If the item was announced, the item is matched off and the item disappears from the list of pending Assigns. If the winners were not announced, Lootster will bookkeep the item with a usage of Main-Spec Need (usually therefore with maximum points).
The new 'Ass' button for boss entries on the Raid page represents a count of outstanding assignments for that boss. Pressing the button will list the outstanding assignments.
An assignment is created when you announce winners and you are automatically bookkeeping loot picked up by players (non-DKP items in Normal mode, DKP items in DKP mode) It does this such that all items looted by players are tracked. To prevent double counting items, announcing winners will create an assignment for each of the won items, noting the player, its usage and the point cost.
When the player picks up the item, the assignment is matched off and will disappear from the assignment list. Conversely, if the player picks up an item before the Lootster announces a winner, an assignment will be created for that looted item. Note that this assignment will be for the Main-Spec Need usage, since Lootster will not know at that point what usage the player rolled (and won) the item. When the Lootster announces the winners, this entry will be matched off and disappear from the assignment list.
The existance of assignments after all the winners have been announced and players have picked up their loot indicates:
Although not too serious, it is worth checking this list to make sure the items are booked correctly. The Match All button will simply match off the remaining assignments for a boss.
There are a few ways of setting up the guild ranks and toons (Main/Alt):
For example a Prefix of '(' and Suffix of ')' will isolate a Main in the form of '(Fred) is a LW' from the Guild Public Note for an Alt of Fred. If you are unsure of further use of regular expressions ask in the guild.
Usage rolling allows players to roll for specific use of an item, such as Main-Spec Need, Off-Spec Need, Bank Shard, etc. Lootster will allow usage rolls in DKP mode only. There are two forms of usage rolling:
Each individual usage roll can be enable/disabled, so not all may be allowed by a Lootsterer. Here is the full list:
Note that all usage rolls from Main-Spec Need to Bank Shard may be moved in winning priority order. Called and Greed are always highest and lowest priority.
A Banker, set on the Options page Usage Rolls tab, should be set if points are awarded for items going to the Bank (Alt BoE and Bank Shard). The reason is that the points would otherwise be charged against the person collecting the bank items, which they won't be happy about. Setting a Banker will cause Lootster to book such items against that 'Bank' player name.
No. After considering this for a time I concluded that it would be too confusing, either accidentally or on purpose. A Main-Spec Need roll will always be /roll 100. However, other roll usage types may be added in the future.
Each usage can be enabled to limit the number of wins a player (and their alt(s)) can win per raid for that usage. By default, the Called usage is so enabled, and it's wins per raid is set to one. This means that a player can win only one Called roll per raid. The Raid Leader may determine that this is say any Epic, or say an armor token. Of course the number of Called wins per raid can be changed or disabled.
The wins per raid is only checked when the player rolls. If they have hit their alloted number of wins, their roll is accepted but put on hold. The Lootsterer has the sole discretion to subsequently enable that player's roll. The player will be informed when this happens. Manually created/modified loot adjustments will not be subject to the wins per raid check.
Note that a player that has a held roll because they hit their wins per raid limit has the option to downgrade their roll by rolling a lower priority usage roll. That new usage roll will not be held unless it too would exceed the player's wins per raid for that usage.
The usage Alt factor is the multiplier used to calculate the item points deducted from a Main on behalf of that Main's Alt. For example, it might be set to 0.5 so Alts are charged only half points.
The Cost value/factor is the normal way to cost items of that usage roll type. A Cost value is a straight value, for example 10.0 might be used for shards. A Cost factor is a multiplier used to calculate the item points for that usage type. For example, it might be set to 0.5 for Off-Spec Need so that off-spec items are charged half points.
Note that each usage roll type has it's own Alt factor and Cost value/factor. Also note that the Alt factor is always applied to the Cost value/factor. Thus, in the above example where an Alt won an item for Off-Spec Need, they would be charged quarter points (0.5 * 0.5).
Events are bookkeeping entries that are grouped in a raid. Lootster has a number of event types, all of which can be individually enabled/disabled for 10-man and/or 25-man raids. A Full points value can be associated with each event, with separate values for 10-man and 25-man raids. Additionally, a Partial and Standby percentage of the respective Full points value can be specified. Current events are:
Some events on the Options page Events tab have an associated time. The meaning of the time varies depending on the event:
Each individual event can award different points for 10-man or 25-man raids. This is the Full points. The P% and S% is the percentage of those Full points that will be awarded to attendees that had Partial or Standby attendance during that event.
Simply update the event(s) with the points you want in the Options page Events tab, then head to the Raid page. Select the raid you want to rebook, click Modify, then click Modify in the Modify Raid popup. Thats it - the raid events have been rebooked with the correct points!
No. The various point, item quality and item slot factors exposed should give enough variability to the calculation of points to give decent results. If you have a better item points formula, open a ticket with the details so it can be considered for inclusion.
Yes, by setting the pFactor to a value which will increase/decrease the magnitude of the item points.
There are plugins available for EQDKP and NDKP to export the web data into a LootsterDKP.lua file, which will be used by Lootster to initialise player points data. The WoW version of Null DKP comes with a Lootster export ability that can be exposed.
The Raid page has a Raid Report button. This will bring up the Report user interface. Select the Report Format of CT_RaidTracker and hit Refresh. You can copy the string and paste it into the CT_RaidTracker import plugin for EQDKP.