Ka0s Loot History

Ka0s Loot History is a passive loot tracker for World of Warcraft: Midnight. It records every item you pick up and works out where it came from: a kill, a chest, the mailbox, the auction house. Open the window whenever you like to read back your loot. The Insights tab shows the same log broken down by source, value, quality and more.

The history is account-wide. Every character writes to and reads from the same log, and it survives reloads and logouts. You pick a minimum quality, and anything below it is ignored.

Each item is filed under one of these sources:

Most items are filed straight from what the game reported, and those are marked Certain. Sometimes nothing says where an item came from. The addon still records it, under Other and marked Inferred, rather than dropping it on the floor. Every row shows which of the two it is, so you always know what you're reading.

Screenshots

History browser

Insights panel

Usage

There's nothing to set up. Install it, log in, and it's already recording. At first all you'll see is a minimap button, because the History window stays shut until you open it. Drag the window by its title bar and pull its bottom-right corner to size it, then tick Lock frame on the Master controls tab (or Locked in the minimap button's menu) to keep it there. A new install has no loot to look at, so /lh test, or the Test mode box on Master controls, fills the window with sample rows. Combat switches it off, and it's never saved.

Reading back your loot happens in the History window, in this order:

• Open the window. Right-click the minimap button and tick Show window, or type /lh toggle. A left-click on the button opens the settings instead. The window has four tabs: History, a table of every item you've recorded, Insights, Timeline and Holdings.
• Narrow it down. Click a column header to sort. The filter bar above the table picks by date, bound, quality, type, sub-type, source, zone or character, the search box matches item names, and Group by folds rows together. Each tab (History, Insights, Timeline, Holdings) keeps its own filters. Save keeps the current tab's view as its default, Clear goes back to that saved view, and Reset forgets it and returns the tab to stock. Sorting and filters only carry over to your next session if you pressed Save.
• Handle a row. Hover it for the item's tooltip, or shift-click it to link the item in chat. Right-click opens a menu with Link to chat, Blacklist item and Delete. Blacklisting stops future loots of that item being recorded but leaves this row where it is, so use Delete when you want the row gone.
• Open the Timeline. It charts one thing at a time (gold, a currency or an item) over time: a thick Total line plus a line per character or the Warband, with daily gained and lost bars underneath. Type in the search box to pick what to chart, and hover for the day's numbers. Right-click a History or Holdings row and choose Show in Timeline to jump straight to it. The Timeline starts at the upgrade; there is nothing to chart before it. Keep Timeline days for in Settings controls how long the daily balances are kept.
• Switch to Insights. It breaks your loot down by source, value, quality and character, and gives currency a section of its own. Insights keeps its own filters, separate from History's, so narrowing one tab leaves the other's slice alone.
• Export. The Export button copies the tab you're on: loot rows as CSV from History, or a summary of the charts from Insights. Data Set picks all your data or just the current view. The addon can't reach your clipboard, so it opens a box with the text selected and you press Ctrl+C.

What gets recorded is up to you. The Capture tab sets a Minimum quality, which sources count under Record data from, and whether quest items and currency are kept. /lh disable stops the addon watching for loot and closes the window, and /lh enable switches it back on.

Everything else is on the addon's page under Settings → AddOns, which /lh (or /loothistory) opens on its own, and /lh help lists every command.

How attribution works

The game tells addons about each item you receive through the loot message, the one that puts "You receive loot" in your chat. It says what arrived but not where from, so a kill, a chest and a mail attachment all look the same.

So when an item arrives, the addon looks at what you were just doing. Killing a creature leaves a signal it can read at the moment the loot lands. So do opening a container, turning in a quest, taking mail, trading, buying from a vendor, winning an auction and finishing a Mythic+ run.

If there's a signal, the item goes under that source and is marked Certain. If nothing says where the item came from, it goes under Other and is marked Inferred. That's still a better record than none. Everything from one loot window gets the same source, so a full chest of drops lands together.

What a drop was worth

Where an item came from is half of what the addon reads when it arrives. The other half is what it's worth, and it reads that at the same moment for the same reason: a price looked up later is a price from a different day.

If you have Auctionator, TSM or OribosExchange installed, the addon reads an auction price for each item the moment you loot it. One of them is enough. With none installed, it skips pricing.

You decide which prices count. The AH Price tab in the settings lists every price your installed addons can supply in one table (TSM's market value alongside its region average, for instance). Tick the ones you want and drag them by the handle on each row into the order you trust them in. When more than one has a price for an item, the highest-ranked ticked source wins. Unticked sources, and any whose addon isn't installed, drop to the bottom.

The value shown throughout the History table and Insights is the higher of an item's vendor sell price and its auction price. Nothing ever shows as worth less than a vendor would pay for it.

FAQ

Troubleshooting

Reporting a bug

• Type /lh debug on and reproduce the bug.
• Type /lh diagnostics.
• If the debug window isn't open, open it with /lh debug. Press Copy, copy the entire output, and include it with your bug report.

The report is added after the debug trace in the same window, so one copy carries both.

Issues and feature requests

Bugs and feature requests are tracked at github.com/tusharsaxena/LootHistory/issues. Please file them there rather than in comments. That's where the project's to-do list lives.

Version History

Credits

The debug console and the export window use JetBrains Mono, licensed under the SIL Open Font License 1.1, and the History window's lock, dropdown and checkbox marks, the export icons and the settings page's info button are drawn from Open Iconic (MIT). Both ship inside the bundled LibKa0s payload, with their license text beside them.