Loot Filter

2008-04-22
It looks like i will have some spare time somewhere next week and hope to update Loot Filter with some new stuff.

2008-03-12
I am currently very busy with lots of things other than Loot Filter. This is why i have not been able to respond to all the e-mails i have been getting, and i have not been able to put out a new release of Loot Filter. I will do these things as soon as i have some spare time. Please bare with me.

2008-02-09
Version 3.5 has been released. It contains some new languages and new features. Please read the change log for a complete list of changes.

2008-02-03
Version 3.4 has been released and it contains german and chinese translations.

2008-01-20
Version 3.3 has been released and it contains a small fix and a major change in the way items that match delete properties are handled in loot caching mode. Please read the change log.

2008-01-13
Version 3.2 has been released. Selling is now a lot faster and opening clams works again.
I also want to thank everyone who has been sending me error reports and suggestions.

2008-01-06
Version 3.1 has been released. It contains some fixes regarding selling and filtering quest items.

2008-01-02
Selling items will not work properly for items that are found more than once. This will be fixed in the next release.

2007-12-31
Loot Filter v3.0 has been released. I advise everyone to read the change log before installing it. Screenshots and moves have been updated. The movies are of a much higher quality now and show better what Loot Filter can do for you.

2007-12-29
Most of your e-mails have been answered and i have been making good progress with version 3.0. I expect to have a new version ready by monday. The translation in French and Chinese might not be finished on monday. If they are not i will release them later in the 3.1 version.

ps. i am giving Loot Filter version 3.0 on purpose (if you have been around for a while you know why)

2007-12-19
I have been rather busy lately and have not been able to work on Loot Filter or answer many of your e-mails. I will however have plenty of time in the week of christmas. I will answer all your questions then and release a new version of Loot Filter. All your input is much appreciated. So keep sending me e-mails.

Introduction

Loot Filter (LootFilter) is an addon for World of Warcraft that allows you to filter items you get from looting.

Are you tired of deleting all the crap items from your inventory that you get from looting corpses? Or are you tired of having to manually click the items you want from a corpse? Then this addon is for you. It lets you filter loot by quality, item name and item value (and many other things) and helps you keep your inventory clean.

Loot Filter basically works as follows:

when you loot a corpse all items on the corpse are added to a list

the corpse is then looted and the looted items appear in your bags

loot filter then goes through the list of looted items and searches for them in the bags

when a matching item is found in your bags it starts matching the items properties against the KEEP and DELETE properties (in that order):

if a KEEP property matches, the item is kept and there will be no matching against any DELETE properties

if no KEEP properties match, the items properties are matched against the DELETE properties, if there is a match the item is deleted

if no KEEP or DELETE properties match the items properties, the item is also kept

Usage:
/lf or /lfr or /lootfilter, brings up the control panel

Optional dependencies, needed to filter on item value (you just need one of the addons, not all):

Any addons that have a GetSellValue implementation. More information about GetSellValue can be found at http://www.wowwiki.com/API_GetSellValue.

Installation

Just unzip the LootFilter folder inside your Interface/Addon directory

Documentation

Names

In the names tab you can enter (partial) names of items you want to specifically keep or delete. There are a couple of things you can do to make your life easier.

First of all you can use wildcards in names using patterns. When you are using a pattern in a name you need to prefix the name with a hash ('#'). The following pattern for example will match items that start with the word 'Mote':

#^Mote (.*)

Another example will keep any items ending with the name word oil:

#(.*) oil$

For more information about patterns checkout http://lua-users.org/wiki/PatternsTutorial.

Second, you can easily add items by doing the following:

Open your bag(s)

Open Loot Filter (/lf)

Select the 'Names' tab

Select the keep or delete edit frame (your cursor should be visible in it)

Pickup the item from your bag, and the name should be automatically added to the list

Drop the item back in your bag

Cleaning

The cleaning function, located under the 'Clean' tab, allows you to run Loot Filter against all the items in your bags. It is very useful to test your current Loot Filter settings, and to get rid of unwanted items in your bags that somehow got there (disenchanting, Loot Filter turned off, etc.). Cleaning will only delete items that you explicity want to delete. This means items that match any delete properties. Items that do not match any properties will not be deleted. As of version 1.7 it is also possible to Sell these items instead of deleting them. In order to do this you need to be talking to a vendor. You can easily add items in the clean list to the keep list by shift-mouseclicking an item. A regular mouseclick on an item will show you its details.

Loot Caching

With Loot Caching enabled, found under the 'Value' tab, Loot Filter works a little different when deleting looted items. Instead of deleting them right after looting an item, it will keep storing these items untill there is an X amount of free bag space left. The amount of free bag space is configurable. When there is less then X amount of free space left, Loot Filter will search your bags for items that do not match any of your keep properties and add them to a list. It will then start deleting items from this list until there is X amount of free bag space. It will offcourse delete the items with the lowest value first. You need to have one of the optional dependencies installed to use this feature. Make sure you configure a decent amount of free bag slots because if you only have 2 free slots (configured) and you loot a corpse with 4 items, you will only be able to loot 2 because there will not be enough room.

Stack Size

When filtering on item value the stack size is always taken into account. This means that the value being used is: 'value of a single item' x 'possible stack size'. Runecloth for example sells for 4 silver a piece and has a stack size of 20. This means that the value Loot Filter will use is: 4 x 20 = 80 silver.

Planned for next releases

vx.x

E-mail your suggestions to meter at lootfilter dot com

Change Log

v3.x (????)

Feel free to add other languages! (files located in the 'locale' directory) v3.6 (don't know when)

Add ability to filter items if more than x stacks are present (being worked on)

v3.5

Fixed an issue where deleting items with a value less than X was not working (thanks Tony and others)

Added ability to record the value of items during a session and showing some statistics (thanks Tim)

Added French translations (thanks Jimpunk)

Fixed an issue where opening more than one item in a short period of time would break opening completely (thanks Johan)

Fixed an issue where the Chinese translations would not load properly

Added ability to filter on text in item tooltips. You have to prefix patterns with '##' to match on item tooltip information, example:
##(.*)+(%d+) Stamina(.*) ; this will match any item that has + stamina on it

v3.4

Added Chinese translation (thanks 林楠)

Added German translation (thanks Michael)

Fixed a minor issue with items that did not have a (known) value and the ability to delete those

v3.3

*** ALERT *** Loot caching now works a little different when items do not match any keep properties but do match delete properties. In the past the value of these items were all considered the same and sorted that way. In v3.3 items that match a delete property will be deleted first! The item with the lowest value first ofcourse.

Fixed a bug where you could not disable loot caching when you disabled Loot Filter

v3.2

Opening clams works again (forgot to call it)

Selling items is much faster now

Fixed some minor stuff

v3.1

Fixed selling of duplicate items

Fixed an issue with filtering quest items

v3.0

**********
ALERT: Delete the file WTF\Account\<your account>\SavedVariables\LootFilter.lua before you start using this. This file contains your current Loot Filter settings. When you delete it you will lose these settings. If you do not do this Loot Filter might not behave properly.

**********

Optimized and rewritten/restructured a lot of code, Loot Filter should be faster and more robust

Several UI tweaks

Improved the GetSellValue API detection, some addons (based on Ace2) were creating/hooking it after the addons were loaded

Added new subtypes (all subtypes should now be available)

Improved the way subtypes are matched

Added a key binding to access Loot Filter quicker

Added ability to delete items with no value (deja vu? ;-)

Added ability to choose to use single, current stack size or maximum stack size when calculating item value

Added ability to use Auctioneer (Advanced) market prices instead of vendor prices (thanks Carl)

Added ability to automatically start selling when talking to a vendor

Improved the way items are sold

v1.93

Updated .toc to 20300

v1.92

Updated .toc to 20200

Now using GetSellValue to determine if there is another addon present that can supply the value of items. What this basically means is that Loot Filter will work with a lot of other addons when it wants to filter on item value, and is no longer limited to Informant and ItemSync. More info about GetSellValue can be found at http://www.wowwiki.com/API_GetSellValue. The GetSellValue method has only been implemented in the latest versions of many addons. For example, Informant only has it implemented in the 5.0 pre-release version (http://auctioneeraddon.com/dl/#preview).

v1.91

Fixed an issue where the version detection was causing spam when a player was not in a guild

Optimized new version detection so that less messages get sent

Fixed issue where the free space of bags for herbs and such are also counted when using Loot Caching.

Added ability to select which bags Loot Filter should work on

Fixed issue when trying to delete items in the clean tab

Made the opening of Loot Filter when talking to a vendor optional

Values with no known value are automatically kept when filtering on item value (remove the option to turn it on and off)

Fixed issue where the clean list is not sorted properly on value or name. This is also sometimes causing higher valued items to be deleted before lower valued ones.

Fixed issue where the displayed total value is not using stack size properly in the clean tab (Cosmetic)

Added drop down box for server/character selection in the Copy tab

v1.9

Added a notify on new version

Now showing the total value of the items currently in your list on the Clean tab

Auto open clean tab when talking to a vendor

1.8

Did some cleaning up of the UI (tooltips, texts, location of buttons)

Shift-mouseclick on an item in the 'Clean' tab will now add it to the keep list. This will make setting up your keep list a whole lot easier.

Fixed some minor UI bugs that were sometimes causing errors

1.7

Added the 'Open' tab again and optimized the code for it. I also found out that you cannot open or use every item. Adding scrolls for example will give a protected error. Adding Clams and the like works fine however.

Added the ability to sell your items automatically instead of deleting them all. Go to the 'Clean' tab when you are talking to a vendor.

You can now click on the items that are listed to be cleaned or sold to display their info.

Made some cosmetic changes to buttons.

Optimized code in different places.

1.6

Added Loot caching. Basically this will keep all loot until less then X free bag slots (configurable) are available. When this happens it will start deleting items with the lowest value to make room for items with a higher value. Ofcourse this only applies to items that do NOT match any KEEP properties. This option can be found under the 'Value' tab and only if you have Informant or ItemSync installed.

1.5

Removed the ability to open items automatically (this has been disabled by Blizzard)

Added a cleaning function that allows you to run Loot Filter against all the items in your bags. This is also a very useful feature to test your current Loot Filter settings.

1.4.1

Made the automatically opening of items more robust (basically added a retry of 20+ over 30 seconds for items that do not open right away)

Improved the way looted items are filtered

1.4

Added support for ItemSync. If both ItemSync and Informant are loaded, Informant will be used.

Added ability to copy settings from other characters.

1.3

Added the ability to automatically open & loot certain items that are looted (like clams). You can simply add the names of the items that you want to open & loot in a list under the 'Open' tab.

1.2.2

added a 'split' function that was missing and causing error messages

1.2.1

Removed debug information because it was causing spam

1.2

Fixed an issue with filtering on item value. Has been tested with Auctioneer/Informant 4.0

When informant is installed item properties are now also checked against information from Informant (Alchemy, Engineering, Enchanting etc.)

1.1

Fixed a bug where quest items would sometimes also be added to the keep list when it was not needed

Added option to keep items that have no sell value

1.0

The user interface has been changed and improved a great deal

The code has had a lot of optimization

Tooltips have been added

Small bug fixes

1.0.3.beta

updated .toc

removed notify for items that did not match any criteria

1.0.2.beta

optimized the code a lot

added a workaround for itemInfo() weirdness (would not return the true name of an item)

fixed an issue where quest items would not be added to the keep list properly

added extra (help) text to make things clearer

fixed an issue with notify on delete / keep (keep messages were always displayed)

1.0.1.beta

initial release

Contact

If you have any questions or suggestions send an e-mail to meter at lootfilter dot com. You can also find me on the Doomhammer server where i play a mage called Meter.