promotional bannermobile promotional banner

GargulHistory

A companion addon for Gargul that tracks and displays a persistent history of all loot awarded through Gargul in World of Warcraft TBC Anniversary.
screenshot-1.png

screenshot-1.png

Description

Gargul History

A companion addon for Gargul that tracks and displays a persistent history of all loot awarded through Gargul in World of Warcraft TBC Anniversary.

Features

  • Automatic Loot Tracking - Listens for Gargul's loot award events and records every item awarded, including the item name, item ID, recipient, and timestamp.

  • Minimap Button - A minimap icon provides quick access to the history window. Hover it to see the current entry count.

  • Sortable History Window - A resizable, movable window displays all recorded awards in a three-column table:

    • Date - When the item was awarded
    • Player - Who received the item
    • Item - The item that was awarded (displayed with its quality color)

    Click any column header to sort ascending/descending.

  • Item Tooltips - Hover any row to see the full item tooltip.

  • Export - Export your full history as JSON. The export window lets you select all and copy the data for use in external tools, spreadsheets, or websites.

  • Clear History - Remove all recorded entries with a confirmation prompt.

Requirements

  • World of Warcraft TBC Anniversary (Interface 20505)
  • Gargul addon installed and enabled

Installation

  1. Copy the Gargul_History folder into your WoW AddOns directory:
    World of Warcraft/_anniversary_/Interface/AddOns/Gargul_History/
    
  2. Restart or reload WoW.
  3. Gargul History will appear in your addon list and load automatically alongside Gargul.

If you cloned this repository, you can use the deploy script:

npm run deploy
# or
bash deploy.sh

Usage

  1. Viewing History - Click the Gargul History minimap icon (book icon) to open the history window.
  2. Sorting - Click the Date, Player, or Item column headers to sort. Click again to reverse the sort order. An arrow indicator shows the current sort direction.
  3. Exporting - Click the Export button at the bottom of the history window. A new window will appear with your history as JSON. Press Ctrl+A to select all, then Ctrl+C to copy.
  4. Clearing - Click the Clear History button to remove all entries. You will be asked to confirm before anything is deleted.

Export Format

The export produces a JSON array with the following structure:

[
  {
    "date": "2026-03-13 20:15:00",
    "awardedTo": "Playername",
    "item": {
      "name": "Thunderfury, Blessed Blade of the Windseeker",
      "id": "19019"
    }
  }
]

Data Storage

History is stored in the GargulHistoryDB SavedVariable, which persists across sessions and reloads. The minimap button position is also saved.

The GargulHistory Team

profile avatar
  • 4
    Projects
  • 5.7K
    Downloads

More from Emsw0rth

  • GargulBalancedRolls project image

    GargulBalancedRolls

    • 1.9K
    • Addons

    A Gargul plugin for World of Warcraft TBC Anniversary that adjusts roll results based on attendance-weighted modifiers, ensuring fair loot distribution for raiders with good attendance.

    • 1.9K
    • June 14, 2026
    • Addons
  • Primal Ledger project image

    Primal Ledger

    • 540
    • Addons

    Account-wide tracking of profession spells and crafts across all characters.

    • 540
    • April 8, 2026
    • Addons
    • +2
  • GargulGearDisplay project image

    GargulGearDisplay

    • 1.4K
    • Addons

    A World of Warcraft addon for TBC Anniversary that works as a plugin for Gargul. It shows the currently equipped gear of players who roll on items during Master Looter loot distribution.

    • 1.4K
    • March 11, 2026
    • Addons
  • GargulBalancedRolls project image

    GargulBalancedRolls

    • 1.9K
    • Addons

    A Gargul plugin for World of Warcraft TBC Anniversary that adjusts roll results based on attendance-weighted modifiers, ensuring fair loot distribution for raiders with good attendance.

    • 1.9K
    • June 14, 2026
    • Addons
  • Primal Ledger project image

    Primal Ledger

    • 540
    • Addons

    Account-wide tracking of profession spells and crafts across all characters.

    • 540
    • April 8, 2026
    • Addons
    • +2
  • GargulGearDisplay project image

    GargulGearDisplay

    • 1.4K
    • Addons

    A World of Warcraft addon for TBC Anniversary that works as a plugin for Gargul. It shows the currently equipped gear of players who roll on items during Master Looter loot distribution.

    • 1.4K
    • March 11, 2026
    • Addons