Synopsis

LootList allows the player to build loot/gear lists. Each list can have up to three sets of metrics that can be assigned to each item, including optional integration with Pawn scales. Finally, LootList provides optional notifcation (message and/or sound) when it detects a loot/gear item. For more information see the FAQ.

Features

• A note can be maintained for each item in a list.
• Items can be 'checked off' as won/obsolete while viewing a list, preventing subsequent detection of the item. No more editing lists to remove items you won.
• Item lists can now be imported using the WoW item id, or the URL formats for items on Allakhazam, the Armory, Thottbot and Wowhead.
• Lists can now be exported using the item id format.
• Any number of lists, within which you can order the loot/gear according to say importance.
• A list can have up to three metrics, which can represent some measurement of the item. By default, the only metric is Manual.
• A metric consists of a base value, a 'proc' value (for example a proc on a weapon), and a total value.
• Optional integration with Pawn. A visible Pawn scale can be assigned to each metric. By default, LootList will use the calculated Pawn value for that metric's base value.
• Override any metric's base value, including Pawn values.
• Manual entry of a metric's proc value.
• An active metric can be made to appear blank, along with color coding to represent a Pawn value (green), a Pawn value override (red), or Manual value (blue). A grey value indicates an error occured with the Pawn value calculation.
• Options to provide message and/or sound notification when LootList detects a loot/gear item in a group loot roll window, a loot window, chat from the Master Looter, party/raid leader chat, and/or raid warning chat.
• Export loot/gear lists in plain text, Blizzard link format text, HTML list or BBC list.

Bug Reporting

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.

Slash Commands

• /ll - display LootList help
• /ll show - show the main LootList window
• /ll hide - hide the main LootList window
• /ll resetui - reset the position of LootList windows

Language Support

LootList should be able to work in any language, though the prompts and messages are in English. 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.

Installation

Unzip into <WoW Directory>\Interface\Addons.

User Interface

The user interface is used to perform all functions, and call be toggled (shown/hidden) through two methods:

1. Using the command line via the /lootlist or /ll command;
2. Using the minimap button that can be used to toggle the user interface.

To reset the window positions if they are dragged offscreen, use the command line /ll resetui to reset their positions.

The user interface can be moved anywhere on the screen via dragging the LootList window.

Recent Version History

Version 1.3.2 - 12/03/12

• Fixed LUA error @ 483 when loot window opens

Version 1.3.1 - 10/03/12

• Fixed LUA error @ 481 when loot window opens

Version 1.3.0 - 09/13/12

• Ported for the WoW Mists of Pandaria 5.0.4 patch

Version 1.2.5 - 11/29/11

• Fixed possible taint issues
• Updated ToC for 4.3.0 patch

Version 1.2.4 - 07/06/11

• Fixed taint issue via chat

Version 1.2.3 - 06/28/11

• Updated ToC for 4.2.0 patch

Version 1.2.2 - 04/26/11

• Updated ToC for 4.1.0 patch

Version 1.2.1 - 01/30/11

• Fixed LUA error @ 2095 when a list has a pre-expansion non-cached item
• Fixed Pawn messages when a list utilises a Pawn scale that no longer exists

Version 1.2.0 - 10/12/10

• Released

Version 1.2.Beta1 - 10/8/10

• Added ability to set a note for each item in a list
• Ported for the WoW Cataclysm 4.0.1 patch

Version 1.1.2 - 06/22/10

• Fixed LUA error @ 416 when shift-clicking links

Version 1.1.1 - 05/17/10

• Fixed LUA error @ 2550 when trying to Insert/Append an empty item link

Version 1.1.0 - 05/08/10

• Added ability to checkoff items as won/obsolete while viewing a list
• Added additional export of item lists using WoW item ids
• Added import of item lists using WoW item ids, or Allakhazam, Armory, Thottbot or Wowhead item URLs
• Fixed confusing ability to change list selection while editing a list

• Initial beta release

Complete Version History

See the version history document for a complete version history of LootList.

Known Issues

None currently known.

Future Versions

Nothing planned at this time.

License

LootList 1.x.x+ by Mackenz is licensed under a Creative Commons Attribution-Noncommercial-No Derivative Works 3.0 United States License.

FAQ

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.

1. How do I enable the color coding of a metric?
2. When will an item be detected?
3. What does it mean when a link is red?
4. What are item ids and how do I use them to import lists?

1. How do I enable the color coding of a metric?

   When you are creating/modifying a list, the user interface will show an editing box for each enabled metric. Color coding is enabled by the value entered for the metric's base value:

   1. Green - Enter a -1 value when using a Pawn scale;
   2. Red - Enter a positive value when using a Pawn scale;
   3. Blue - Enter a positive value when using the Manual scale;
   4. Blank - Enter a zero value when using any scale;

   Note that a grey color will be shown only when a Pawn scale fails to calculate a value for the item.

   
   
2. When will an item be detected?

   If enabled in the options, LootList will attempt to detect a loot/gear item in the following cases:

   1. When the item appears in the group loot roll window (a la Need/Greed/DE);
   2. When the item appears in the loot window when looting a corpse (et al);
   3. When the item is linked into chat by the Master Looter;
   4. When the item is linked into Party/Raid Leader chat;
   5. When the item is linked into Raid Warning chat.
   
   
3. What does it mean when a link is red?

   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:

   1. On your character;
   2. In your bags;
   3. In your bank vault;
   4. Linked into chat text;
   5. Viewed in your guild bank vault;
   6. Viewed in an Auction House listing;
   7. Viewed via inspection of another player.

   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 LootList 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!

   
   
4. What are item ids and how do I use them to import lists?

   Blizzard identifies all items in game with a single master item identifier. For example, a [Twilight Opal] has an item id of 36927. For more information on item ids and item strings, head to WoWWiki Item Strings.

   You can import a loot list by using the Import function when editing a list. Each line of the import text takes the form:

   itemid[=text]

   where the =text portion is optional, though useful in identifying the item if the itemid is mistyped. You can source the item id from any number of WoW information sites, along with class loot web sites. Generally, the URL of the item will include the item id. For the [Twilight Opal] example above, the URL appears as http://www.wowhead.com/item=36927.