TKProfConsumables

Use all your profession knowledge items, surplus reagent bags and crafting-order rewards from one button, instead of hunting through your bags for them.

Crafting orders and profession activities in Midnight hand you a steady trickle of small items: Thalassian Treatises, profession notebooks and journals, Master's Surplus Reagents bags, Artisan's Consortium Payouts, one-time knowledge treasures, and items that only work once you hold five of them. Each one has to be found in your bags and right-clicked. If you miss one, you're leaving Knowledge Points or reagents unused.

TKProfConsumables collects all of them into one small window and gives you a single button. Click it, and it uses the next item. Click again, and it uses the one after that. When there's nothing left to use, the window closes by itself.

What it's like in game

You finish a run of crafting orders and your bags now hold a Master Tailor's Surplus Reagents bag, an Artisan's Consortium Payout, two Thalassian Treatises on Tailoring and a Thalassian Tailor's Notebook. The TKProfConsumables window opens on its own, showing all of them:

1. The big button shows the Surplus Reagents bag first. Click: the bag opens and the reagents go into your bags.
2. The button now shows the Consortium Payout. Click: it opens.
3. Next, the Treatise. Click: you study it and gain Knowledge.
4. Then the Notebook. Click, and you're done. The window closes.

You never opened a bag or searched for an icon. If you bind a key to it, you can do all of that by tapping one key four times.

Features

One button for everything

• A large button always shows the next item to use, with its name, how many uses are left in total, and whether it is a bag or a knowledge item.
• Bags are used before knowledge items, because bags often contain more treatises or notes. Those get picked up straight away.
• A row of small icons below shows every item it found (up to 24), with stack counts and cooldowns. Click any icon to use that particular item instead of the next one.
• Key binding: under Key Bindings > AddOns > TKProfConsumables you can bind "Use next profession consumable" to any key, then empty the whole queue by pressing that key repeatedly.

Knows the Midnight profession items out of the box

Built in, by item ID, so it works on any game language:

• All eleven Master's Surplus Reagents bags (Alchemist, Smith, Enchanter, Engineer, Herbalist, Scribe, Jewelcrafter, Leatherworker, Miner, Skinner, Tailor)
• Artisan's Consortium Payout (Midnight and The War Within)
• Thalassian Treatises: Alchemy, Blacksmithing, Enchanting, Herbalism, Inscription, Jewelcrafting, Leatherworking, Mining and Tailoring
• Thalassian notebooks, journals and notes (Alchemist's Notebook, Blacksmith's Journal, Engineer's Notepad, Scribe's Journal, Enchanter's Folio and the rest)
• Combine-5 crafting-order items: Multicraft Matrix, Resourceful Rebar, Apprentice's Scribbles, Artisan's Ledger and Mentor's Helpful Handiwork

It also recognises one-time knowledge treasures (items like Haranir Leatherworking Mallet or Amani Expert's Chisel). It reads their "Study to increase your … Knowledge" text, so new ones are found without an update.

Learns new items by itself

When you complete a crafting order, or open a profession bag from the window, TKProfConsumables watches what arrives in your bags. Anything new that can be used or opened is remembered from then on. A chat message tells you what it learned. Gear and plain crafting reagents are not learned.

Waits for "needs 5" items

Items like the Multicraft Matrix say "Combine 5 … to create …". While you hold fewer than five, the icon is greyed out and its tooltip says "needs 5, you have 2". It isn't counted as usable and doesn't open the window. Once you reach five, it becomes usable automatically.

Skips what you can't use, instead of getting stuck

• An item whose tooltip shows a requirement you don't meet (another profession's treatise, for example) is greyed out and skipped, so the button moves on to something you can use.
• If the game refuses an item twice in a row with the same message (for example, a treatise you've already studied this week), it's set aside until you have more of it. The button never gets stuck clicking something that won't work.
• Hover any greyed icon to see exactly why it's skipped.

Never touches the wrong things

The button will never use pets, mounts, toys, housing decor, potions, elixirs, flasks, phials or recipes. This holds even if a crafting order hands you one, and even if you try to add one by hand. It goes by Blizzard's own item types, so a flask can't sneak into the queue.

Collects from your mailbox

Crafting-order rewards are mailed to you when your bags are full. At a mailbox, a "Collect profession items (N)" button appears under the mail window and takes every matching attachment out of your mail, one after another. It never opens cash-on-delivery mail, and it stops cleanly when your bags fill up.

Stays out of your way

• The window opens by itself when there's something to use and closes itself when you're done.
• Close it with the X and it stays closed until a new item arrives. It won't keep popping back up for items you've already seen.
• Drag it anywhere. It remembers its position.
• In combat it never changes or moves. Anything that arrived during the fight shows up as soon as combat ends.

Commands

• /pcu: show or hide the window
• /pcu why <shift-click item>: explains why an item is or isn't picked up, and prints its tooltip text if nothing matched
• /pcu add <item>: always treat an item as a profession consumable
• /pcu ignore <item>: never use an item (or shift-right-click its icon)
• /pcu remove <item>: take an item off your add/ignore lists
• /pcu list: list everything queued, skipped, learned, added or ignored
• /pcu retry: give skipped items another chance
• /pcu autoshow: turn automatic opening/closing on or off
• /pcu reset: move the window back to the middle of the screen

Good to know

• One click per item. World of Warcraft allows an addon to use only one item per click or key press, so no addon can use everything in a single click. TKProfConsumables makes each click count by always lining up the next item.
• Languages. The built-in item list works on every client language. Recognising new items by their tooltip text currently works on English clients. On other languages, use /pcu add for anything it misses.
• Feedback and item suggestions are welcome in the comments. If an item is missed, /pcu why <item> gives exactly the details needed to add it.