A World of Warcraft addon that tracks every PvP engagement you have — open world fights, arenas, and battlegrounds — and builds a persistent history you can browse in-game.
Author: Magnus
- Detects nearby hostile players in real time via the combat log — including players you're not fighting yet
- Shows a compact draggable bar with enemy names, class icons, class colours, estimated level, and K/D record
- Enemies fade to 30% opacity after inactivity and are removed after a configurable timeout (default 45s)
- Click any name in the radar bar to target that player (works in and out of combat)
- Stealth detection — alerts when a nearby enemy player enters Stealth, Prowl, or Shadowmeld
- Configurable sounds — separate sound + audio channel for new enemies, known enemies, KOS enemies, and stealth alerts
- Level estimation — shows exact level from unit data, or estimates from zone and encounter history
- Mute button on radar bar and main window
- City and sanctuary zone filters
- Detects hostile player encounters automatically via the combat log
- Records outcome: Kill, Death, or Fled (escape timeout after 60 seconds of inactivity)
- Aggregates encounters per unique player — one row per enemy, click to see full history
- Tracks zone, duration, who initiated, and your HP at start/end
- Identifies enemy class via
GetPlayerInfoByGUID, nameplate events, and mouseover — no targeting required - Recognition alert — prints a warning and shows a notification banner when you re-engage a player you've fought before, including their W/L record
- Search and sort — filter the player list in real-time and sort by any column
- Dedicated tab for all players you've flagged as Kill on Sight
- Mark enemies from the radar or World PvP tab — even enemies you haven't fought yet
- Shows the same stats as World PvP: name, class, W/L/F, last zone, last seen
- Quick-access note button on every row
- Automatically starts a session when you enter an arena instance
- Tracks kills and deaths during the match
- Records outcome (Win/Loss), map name, and duration
- Searchable and sortable
- Automatically starts a session when you enter a battleground
- Records outcome, killing blows, deaths, honor gained, damage done, and healing done
- Stores up to 200 sessions
- Searchable and sortable
- Add free-text notes to any player from the World PvP or K O S tab
- Note icon on each row — bright when a note exists, click to edit
- Notes are saved per character profile
- Draggable book icon on the minimap — drag to reposition, left-click to open/close
- Registered with LibDBIcon so it works cleanly with minimap button managers
- Click Code > Download ZIP on this page
- Open the ZIP and copy the
PvPJournal/folder into:World of Warcraft/_anniversary_/Interface/AddOns/ - Your AddOns folder should now contain a
PvPJournalfolder with.lua,.xml, and.tocfiles inside it - Launch the game and enable PvP Journal in the addon list at character select
The radar bar opens automatically on login. Use /pvpj to open the journal window.
| Command | Action |
|---|---|
/pvpj |
Open / close the PvP Journal window |
/pvpjournal |
Same as above |
/pvpj reset |
Wipe all stored data (cannot be undone) |
- WoW TBC Anniversary (Interface 20505 / patch 2.5.5)
- Does not work on Retail, Wrath Classic, or original TBC Classic (2021)
- Uses
LibDBIcon-1.0if available (loaded by another addon); falls back to a custom minimap button otherwise
This addon is heavily inspired by Battlegrounds Historian and Spy — two addons I have used for years. Huge thanks to the authors of those addons for the inspiration and ideas that shaped PvP Journal.
This project is licensed under the GNU General Public License v3.0.