RaidLootTracker

A World of Warcraft addon for tracking loot distribution during raids with roll tracking and player summaries.

Features

Automatic Loot Tracking

• Automatically captures boss loot using the LOOT_HISTORY_UPDATE_DROP event
• Only tracks boss group-loot roll windows — quest rewards and non-roll loot are never captured
• Associates each item with the boss and zone it dropped from
• Tracks item links, player names, timestamps, and roll results

Roll Tracking

• Captures group loot Need/Greed/Pass rolls directly from the WoW loot history API
• Shows the winning roll and a configurable number of runner-ups per item (default 2, adjustable in Settings)
• Each roll shows the player name (class-coloured), roll value, and roll type (e.g. Roll: 98 [Need])
• Roll type is tracked per-player: winners and runner-ups each display their own roll type independently
• Supported roll types: Need, Need (OS), Greed, Transmog
• Manual roll entry available for items added manually

Loot Management

• Main Window: View all tracked loot with filtering
• Search/Filter: Real-time search across item name, player, and boss
• Reassign Loot: Transfer items to different players (original owner is preserved and shown)
• Manual Entry: Add loot entries manually via the "Add Entry" button or /rlt add
• Delete Entries: Remove individual loot entries
• Clear Session: Clear current session loot (preserves history)
• Reset All: Clear all tracked loot data (confirmation required)

Roll Display

• Items with roll data show a + button next to the Reassign button
• Click + to expand the roll breakdown beneath the entry
• Each roll row shows: class icon, class-coloured player name, roll value, and roll type
• Winner's roll is shown in green; runner-ups in white
• Click − to collapse

Player Summary

• View loot distribution by player, sorted by item count
• Click + on any player row to expand a roll-type breakdown (e.g. Need: 2, Transmog: 1)
• Hover over a player row to see their full item list in a tooltip

Minimap Button

• Left-click: Toggle main loot window
• Right-click: Toggle summary window
• Drag: Reposition button around the minimap ring
• Position is saved across sessions

Easter Egg

• Click the "Raid Loot Tracker" title 5 times quickly to reveal a surprise!

Installation

1. Extract the RaidLootTracker folder to your WoW AddOns directory:

   World of Warcraft\_retail_\Interface\AddOns\
   

2. Restart World of Warcraft or type /reload in-game

3. The minimap icon will appear — drag it to your preferred position

Usage

Basic Usage

1. Join a raid and start killing bosses
2. When a boss dies and the group loot roll window opens, rolls are captured automatically
3. Once all players have rolled and a winner is determined, the item is logged
4. Click the minimap button to view tracked loot

Adding Loot Manually

1. Click the "Add Entry" button or type /rlt add
2. Shift-click an item from your bags or from a chat link — it will populate the item field automatically
3. Select the player who received the item from the dropdown
4. Optionally enter the boss name
5. Optionally click "Add Rolls" to record roll data manually
6. Click "Add" to save the entry

Viewing Roll Data

1. Items with rolls show a + button next to the Reassign button
2. Click + to expand the roll breakdown
3. The winner's row is highlighted in green with their roll type (e.g. [Need])
4. Runner-ups are shown below with their own roll types (count configurable in Settings)
5. Click − to collapse

Reassigning Loot

1. Click the "Reassign" button next to any loot entry
2. Select the new owner from the raid roster dropdown
3. Click "Confirm"
4. The original owner is preserved and shown in the boss column

Player Summary

1. Click the "Summary" button or right-click the minimap icon
2. View loot count per player, sorted highest first
3. Hover over a player row to see their full item list

Session Management

• Clear Session: Removes loot from the current session only
• Reset All: Removes all tracked loot (confirmation dialog)
• All data persists across sessions and UI reloads

Slash Commands

/rlt            - Toggle main loot window
/raidloot       - Alias for /rlt
/rlt summary    - Toggle summary window
/rlt add        - Open manual entry dialog
/rlt clear      - Clear current session
/rlt reset      - Reset all data (confirmation required)
/rlt help       - Show command list