The ultimate in auto-selling unwanted items in your bags whenever you visit a vendor. Features detailed rules for selling and keeping items with custom rules to make it do exactly what you want. Automatically get rid of the trash, old expansion items, and anything else you don't want and always find yourself having to sell. Features a plugin model so other addons can extend our rules and functions. We have an example plugin for Pawn, which adds sell rule for non-Pawn upgrades, and a keep rule for anything that is an upgrade.
Our goal is to allow you to set up the exact set of sell rules you want so it always sells precisely the things you want it to sell, and never the things you care about. So you can set up your rules, relax, enjoy the convenience, and not worry about it!
New Features (3.0.3 Release)
For returning fans of our addon, here's a quick list of new things we've added with 3.0.0 and up that you may not have known.
CUSTOM RULES! We have done a tremendous amount of work to give you the ability to make any sort of Sell or Keep rule that you want. We made it as painless as we could think in terms of exposing to you a controlled Lua environment to do script expressions, as well as exposing a variety of properties and functions you can use to build your custom rules.
A rich help reference for making custom rules, inside the custom rules editor.
The ability to view the item properties of any item, for use in making rules.
The ability to test your rule against any items in your inventory to see what matches.
Fairly robust validation of the rules for correctness. There are a few corner cases due to short-circuit logic, but we validate as much as we can to catch authoring errors.
A new UI for the Rules List. This UI indicates which rules are custom rules and is a little simpler to use in terms of enabling/disabling rules. You can also right-click any rule to directly edit it (if it is a custom rule), or to view its script and see what it matches in your inventory.
A Plugin Model! Version 3.0.0 ships with a Pawn extension as a demonstration of our plugin model. It will only be loaded if you have both Pawn and Vendor installed, and when it does, you have a new sell rule and a new keep rule based on Pawn Upgrades. We expect in the future to have at least one more plugin that will contain a bunch of extra built-in rules to include the popular ones those who use our addon share.
What is Vendor?
Vendor is a fully configurable manager for auto-selling any items you don't want to keep. It is designed to be a tool for convenience when leveling, questing, raiding, or farming old content. You end up with a lot of junk to sell, and Vendor helps you do that by giving you configurable rules to use that can sell what you want it to sell, without having to lift a finger, and with peace of mind that the things you don't want sold will not be. We have a solid set of built-in rules, along with a plugin system for more rules, and the ultimate in custimization - the ability to create your own custom selling or keeping rules. Sell or keep exactly the items you want!
Vendor also has an auto-repair feature for whenever you visit the vendor capable of doing so. We're all about hands-off convenience.
And performance. We know every frame counts, and even though we have a light touch by our nature, we are careful to make sure we can deliver a quality experience with efficient programming. We are also quite proud to say we have zero dependencies, which means no unnecessary bloat, and no risk of dependency corruption to or from other addons. If we do add any dependencies, it will be for independently-removable plug-ins to other addons which require it and not for our core functionality.
A short (incomplete) list of select features. Most of these are configurable.
Built in set of keep rules, covering uncollected transmog, BOE, Soulbound, Equipment Sets and others.
Built in set of sell rules, covering green/blue/purple gear below a certain level, old food, greys, and others.
Ability to create your own custom sell or keep rules based on almost any item property. Want a rule to behave slightly differently? You can create your own to do the job and make it exactly the way you want.
Auto-repair whenever you visit a merchant.
Auto-confirm selling an item that will become non-tradeable (such as raid loot).
Tooltips that indicate if an item will be sold, or is on one of your block lists.
If you encounter any problems, please create an issue to let us know!
How does Vendor Work?
Vendor works by having a rules engine and an auto-selling thread that executes whenever you open the merchant window. This also auto-repairs if you have that enabled (it is by default).
We have three sets of rules:
Keep Rules. These are safeguards that prevent you from accidentally selling things you don't want to sell. Keep rules always run before Sell rules, with one exception - Items on the "Always Sell" list will always be sold. By default we have a few safeguards on that make sure you aren't surprised by what Vendor can do for you. There are additional safeguards you can enable if you want. As you become comfortable with Vendor and its rules, you can relax some of the safeguards to get more out of it.
Sell Rules. These are the rules that will auto-vendor things. We have most of them turned on by default, but they will be limited depending on which Keep Rules you have enabled. A few rules have configurable variables such as Selling green items below a certain item level - you can set the item level.
Custom Rules. These are intended to be the real meat of Vendor - make whatever rules to sell things that you want! You can make very flexible custom rules, especially with the TooltipContains() function, which allows you to match any text in the tooltip as well as item properties. You can make both Sell and Keep rules to suit your needs. This is a very powerful part of Vendor.
In addition to the rules, we also have blocklists you can set for items to be Always-Sold, or Never-Sold. This is your fine-tuned exact control over the Sell and Keep rules. As such, the blocklists are always checked first before any rules are run. So if you put something on the Always-Sell or Never-Sell list, it will do exactly as you expect it to do. By using our keybinds, you can quickly add or remove items from either list by mousing over them and pressing the keybind. We also have console commands if you really want to do it the hard way.
You might be wondering - how do I know if an item will be sold? We add that information to its tooltip! Whenever you mouseover an item, we will tell you if that item will be auto-sold by Vendor. We also have detailed tooltips which can even tell you which rule was the one that causes the item to be sold - so you know which one to tweak should you not want it sold, or to see which rule is making your life easier. Also, items in either the Always-Sell or Never-Sell blocklists will have an additional tooltip line indicating that you have marked them Always-Sell or Never-Sell.
We will continually add more properties of items that can be used for rules, and occasionally some new useful built-in Keep rules and Sell rules. See the upcoming features for more, and if you have a request, feel free to open an issue ticket or leave a comment.
How to Configure Vendor
You can configure Vendor's rules and options by accessing the interface options panel, or using these slash commands: /vendor or /ven
/vendor rules - will directly open the rules configuration dialog.
/vendor settings - will directly open the interface options panel.
/vendor keys - will directly open the keybind options.
We strongly recommend trying the keybinds, as they are a convenient way to mark any item you mouse-over with a tooltip as auto-sell or never sell, giving you a very quick way of adding and removing items from the Always-Sell and Never-Sell lists.
The Interface Options panel has sub-panels where you can tweak the performance of Vendor and the Repair functionality. By default, Repair will pull from the Guild Repairs if available and sufficient to cover the cost. You can disable Guild Repairs or Auto-Repair if you want.
Here's the list of things we are working on now to make Vendor even better, and some of our future plans. If you have ideas for us, feel free to let us know via ticket or comment. These are in no particular order, except Custom Rules, which we are actively working on now and expect later this week (around July 20-22nd).
Keep Rule for items that are Upgrades or Best-In-Slot. This would also be a property available for custom rules. This is very useful when leveling in general, and in BFA. We want you to be able to relax the keep safeguard rules and actively sell off out-leveled gear or non-upgrades without worrying about your best items or upgrades being sold. We plan to be relatively simple with what is an "upgrade" by looking at item level, which is Blizzard's goal. After you level up, we expect the Equipment Set rule and blocklists will work to keep your active gear out of the vendor's hands.
New item properties for use in Custom rules and some new Sell rules, such as Unknown Recipes, Uncollected Pets, Items Equippable by you, Items that are tradeable, Champion Equipment (we know you vendor the greens and some of the blues, admit it!).
Plugin for Ark Inventory so you can group together all the things Vendor will be selling based on your current rules.
Plugin for Bagnon to add glyphs/highlights to items that will be auto-sold by vendor.
Plugin for Titan so you can know how many items will be sold and quick-access to the rules configuration.
Custom Rule sharing. Send custom rules to your friends and guildies via hyperlink, or a string.
As you can see, we've got plans! If you have some to add, let us know! We aim to please.