The ultimate in configurable inventory junk management! Fully configurable selling, destroying, and keeping of items. Also does auto-repair!
Features detailed rules for selling and keeping items with custom rules to make it do exactly what you want and profiles to make it easy to switch around. Automatically get rid of the trash, old expansion items, and anything else you don't want and always find yourself having to sell. Run Destroy anytime to delete items you've set up rules to destroy or added to the Destroy list. It's great for anyone in helping manage bags and garbage Blizzard likes to shove in them. Especially if you like running old content and want to vendor lots of junk of all rarities that you get while doing so but keeping the important things you want, you will love this addon! Even if you don't, it will help you keep your bags clean from the inevitable useless junk you will collect almost anywhere.
For a list of recent features and changes, see the "Help" tab in-game for release notes and notable changes.
We also have an extension/plugin model so other addons can extend our rules and functions. We include extensions for the following popular addons:
-
AdiBags (Filters items into "Sell" and "Destroy" categories when they match the corresponding Vendor evaluation)
-
Titan Panel (Vendor plugin for quickly accessing the settings, switching profiles, running destroy, and seeing what will be sold/destroyed)
-
Pawn (for item upgrade detection, selling stuff that isn't an upgrade)
-
TradeSkillMaster (keep valuable things and sell stuff not worth auctioning)
-
ArkInventory (easily filter items Vendor will sell).
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!
Here's a video tutorial of the addon and all of its features!
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 customization - 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.
-
An extension model that has some built-in extensions for popular Addons if you also have these addons:
- Titan Panel - Vendor has a plugin under the "General" tab to access the addon, and quick access to its settings via the right-click menu. The button tracks number of items Vendor will sell and total value of those items.
- TradeSkillMaster - You can create and use rules that factor in any TSM custom string to factor in market prices into your vendoring rules.
- Pawn - Adds Pawn_IsUpgrade() function and rules for keeping item upgrades and selling non-upgrade equipment. This is a very handy plugin when leveling alts or in upcoming Shadowlands when you get a ton of greens and blues from quests and drops while leveling, many of which are just vendor trash eating up your bags.
- ArkInventory - This plugin does not add functionality to Vendor, but rather exposes Vendor's functionality to Ark! This allows you to create ArkInventory rules for things Vendor will sell so you can easily track the stuff that will be vendored for organizing your inventory.
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
The easiet way to configure Vendor is to enable the Titan plugin if you have Titan Panel. The plugin comes with Vendor and is found in the "General" category of Titan plugins. Left-click the button to access the rules menu, and right click to see buttons to access the rules, settings, and keybindings for 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.
Upcoming Features
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. Many of our changes, such as the TSM Extension, come from your feedback, so please tell us what you'd like to see!
- Profiles for Vendor settings and rules configurations, so you can have different profiles for various activities (leveling, farming, etc).
- Removal of Scrap rules for Shadowlands (the feature is not very polished anyway)
- Plugin for Bagnon to add glyphs/highlights to items that will be auto-sold by vendor. Maybe non-specific to Bagnon.
- "Keep X slots open in my bag" functionality, which will delete the least valuable items that Vendor would sell to keep some minimum space available in your bags for non-junk.
- Ability to specify other chat channels for addon output.
- Custom Rule sharing. Send custom rules to your friends and guildies via hyperlink, or a string.