PvPStreamStats — Addon Description

PvPStreamStats is a lightweight World of Warcraft TBC Classic (BCC) addon built for streamers and PvP players who want clean, readable performance stats on screen. It shows a compact, customizable overlay that tracks your Honorable Kills, Killing Blows, Deaths, critical hits dealt to enemy players, and your biggest crit—all in real time during PvP.

The addon focuses on player-vs-player targets only for crit tracking, keeping the numbers meaningful for arenas, battlegrounds, and world PvP.

How It Works (Functionality Explained)

1) What the overlay displays

PvPStreamStats shows 5 stats:

VH (Honorable Kills) — a cumulative total tracked by the addon
CF (Killing Blows) — a cumulative total tracked by the addon
Deaths — a cumulative total tracked by the addon
Crits — number of your critical hits landed on enemy players
Max — your highest single critical hit value against an enemy player

The overlay can be shown in different layouts:

Compact (single line)
Multiline (two lines)
Vertical (one stat per line)

2) PvP-only crit tracking (enemy players)

The addon listens to the combat log and counts a crit only when:

You are the source of the damage, and
The target is a hostile unit controlled by a player, and
The damage event is flagged as critical

It also stores the highest crit amount it has seen, updating the “Max” stat when a new record happens.

3) Honorable Kills (VH) tracking that works in BGs and world PvP

Honorable Kill messages can be inconsistent depending on chat filters and client settings, so the addon uses a more reliable method:

It reads your Lifetime Honorable Kills from the game’s PvP stats (when available).
Each time that lifetime value changes, it adds only the difference (delta) to the addon’s own VH counter.

This ensures VH increases properly whether you chain battlegrounds or switch to world PvP afterward, without resetting per match.

4) Killing Blows and Deaths (BG/Arena vs World PvP)

PvPStreamStats uses different sources depending on where you are:

In Battlegrounds/Arenas

It periodically reads the scoreboard and adds only the delta since the last poll for:
- Killing Blows
- Deaths

This prevents “copying match totals” and makes your counters remain cumulative across multiple BGs.

In World PvP

Killing Blows: counted via combat log kill events when you kill an enemy player.
Deaths: tracked using a practical heuristic (for example: you died shortly after taking damage from an enemy player). This avoids counting PvE deaths as PvP deaths most of the time.

5) Overlay customization & stream-friendly behavior

The addon includes a full in-game options panel (Options → AddOns → PvPStreamStats) where you can:

Change layout (compact/multiline/vertical)
Adjust font size and scale
Toggle background box, colors, outline, and icons
Set frame width/height independently
Use “Fit to text” for perfect sizing
Lock position and optionally enable click-through when locked (so it won’t block clicks during gameplay)
Reset session stats or restore defaults

The goal is to keep the overlay readable for viewers while staying unobtrusive in combat.

PvP Stream Stats