Big Crits Don't Lie - v2.0.1

Major Release: Healing & Boss Tracking (Damage Only)

---

A WoW TBC Anniversary Classic addon that tracks and shares your biggest critical hits and heals with your guild, featuring raid boss leaderboards for progression tracking.

Features

Dual View System

• Global View: Personal/Guild leaderboards with class filters for damage and healing
• Raids View: Boss-specific damage leaderboards for Karazhan, Gruul's Lair, and Magtheridon's Lair (damage crits only)

Personal Leaderboard

• Tracks your top 10 critical hits AND heals per character (GUID-based)
• Separate tracking for damage and healing
• Stores damage/heal amount, spell name/icon, target, target level, location, and date
• Persistent across sessions via SavedVariables
• Victory sound plays on new personal best (toggleable)
• Shows top 3 crits on login

Guild Leaderboard

• Syncs best crits/heals across guild members automatically
• One entry per player per category (highest crit/heal only)
• Displays top 10 guild-wide crits and heals
• Class-specific tabs for each class leaderboard (damage and healing)
• Real-time updates when guildmates land new records

Raid Boss Tracking (Damage Only)

• Dedicated leaderboards for each raid boss encounter
• Tracks top 10 damage crits per boss (per player) - healing crits not tracked for bosses
• Three raids supported:
  • Karazhan (11 bosses): Attumen, Moroes, Maiden, Opera Event, Curator, Terestian Illhoof, Shade of Aran, Netherspite, Chess Event, Prince Malchezaar, Nightbane
  • Gruul's Lair (2 bosses): High King Maulgar, Gruul the Dragonkiller
  • Magtheridon's Lair (1 boss): Magtheridon
• Automatic NPC detection via combat log GUID parsing
• Boss order follows standard raid progression

Automatic Sync System

• Broadcasts your #1 personal best to guild on login (5s delay)
• Requests sync from guildmates on login (8s delay via REQ_SYNC)
• Auto-responds to sync requests from others (60s throttle per sender)
• Only broadcasts NEW personal bests (not every crit)
• Smart throttling prevents message spam
• Separate sync for damage and healing

User Interface

• Three-level tab system:
  • View Mode: Global / Raids
  • Main Tabs: Damage/Healing (Global) or Raid Selection (Raids)
  • Sub Tabs: Personal/Guild/Classes (Global) or Boss Selection (Raids)
• Boss buttons: Two-row layout (max 8 per row) with auto-selection
• Raid buttons: Auto-sizing based on text length
• Minimap button: Draggable icon to open/close leaderboard
• ESC/Game Menu: Press your game menu keybind to close the window
• 7 columns: Rank (#), Player, Class Icon, Amount, Spell (icon + name), Target, Date
• Item quality color-coding for ranks 1-10 (Legendary → Gray)
• Class icons for visual identification
• Realm names hidden in display (shown as "Name" not "Name-Realm")

Slash Commands

/crit                    - Toggle leaderboard window
/crit top                - Print top 10 to chat (personal + global)
/crit reset              - Clear this character + global
/crit reset all          - Clear ALL characters + global
/crit sync               - Manually broadcast your best (throttled)
/crit sound on|off       - Toggle victory sound
/crit debug              - Show sync status and settings
/crit debug on|off       - Toggle debug messages

Technical Details

Compatibility

• Interface Version: 20505 (TBC Anniversary Classic)
• Dual API Support: Works with both modern (C_ChatInfo) and classic (SendAddonMessage) APIs
• Backdrop System: Auto-detects BackdropTemplate availability
• SavedVariables: BCDLDB (per-character + global data + raid boss data)

Combat Log Detection

Tracks critical hits from:

• SWING_DAMAGE - Melee auto-attacks
• RANGE_DAMAGE - Ranged attacks (Hunter shots, wands, thrown)
• SPELL_DAMAGE - Direct spell damage
• SPELL_HEAL - Direct heals

Boss Detection

• Extracts NPC ID from combat log GUID (Creature/Vehicle unitType)
• Reverse lookup table maps NPC IDs to raid/boss names
• Supports multiple NPC IDs per boss (for adds/phases)
• Stores boss crits separately from global crits

Sync Protocol

Message Format: ver|type|player|playerClass|amount|spell|spellIcon|target|targetLevel|zone|date

Message Types:

• REQ_SYNC - Request sync from guild (sent on login)
• REC - New record broadcast (sent when new #1 personal best)
• REC_HEAL - New heal record broadcast
• SYNC - Response to REQ_SYNC (sends best damage crit)
• SYNC_HEAL - Response to REQ_SYNC (sends best heal crit)

Channel Priority:

1. GUILD (preferred)
2. INSTANCE_CHAT (battlegrounds/dungeons)
3. RAID
4. PARTY

Data Structure

BCDLDB = {
    perChar = {
        ["Player-GUID"] = {
            entries = {
                { amount, spell, spellIcon, target, targetLevel, time, zone, player, playerClass }
            },
            healEntries = {
                { amount, spell, spellIcon, target, targetLevel, time, zone, player, playerClass }
            }
        }
    },
    globalEntries = {
        { amount, spell, spellIcon, target, targetLevel, time, zone, player, playerClass }
    },
    globalHealEntries = {
        { amount, spell, spellIcon, target, targetLevel, time, zone, player, playerClass }
    },
    raidBosses = {
        ["Karazhan"] = {
            ["Attumen the Huntsman"] = {
                { amount, spell, spellIcon, target, targetLevel, time, zone, player, playerClass }
            }
        }
    },
    settings = {
        sound = true
    }
}

Major Changes from v1.0

v2.0 - Raid Boss Tracking & UI Overhaul

• NEW: Raid boss leaderboards for Karazhan (11), Gruul's Lair (2), Magtheridon's Lair (1)
• NEW: Healing crit tracking with separate personal/guild leaderboards
• NEW: Minimap button
• NEW: Two-row boss button layout (max 8 per row)
• NEW: Auto-sizing raid name buttons
• NEW: Custom boss order following raid progression
• CHANGED: Removed shift-click report/share functionality

v1.2.1 - Sync System Overhaul

• v1.0: Broadcasted every top-10 crit → Spam issues
• Current: Only broadcasts new #1 personal bests → 90% less spam

Guild Leaderboard Logic

• v1.0: Could show multiple entries per player
• Current: ONE entry per player (highest crit wins)

Channel Management

• v1.0: Could send to INSTANCE_CHAT in battlegrounds
• Current: Always prioritizes GUILD channel first

Player Name Normalization

• v1.0: Inconsistent name formats caused duplicate entries
• Current: All names normalized to "Name-Realm" format for matching

Login Sync Request System

• v1.0: Only broadcasted your data passively
• Current: Actively requests data from guildmates via REQ_SYNC protocol

UI Improvements

• v1.0: Showed "All" tab with realm names, Location column, 340px height
• v1.2.1:
  • Renamed "All" → "Guild"
  • Realm names hidden (display only character name)
  • Removed Location column (redistributed space to Target +80px, Date +26px)
  • Reduced height to 295px (removed excess whitespace)
• v2.0:
  • Three-level tab hierarchy (View Mode → Main → Sub)
  • Global/Raids view mode tabs
  • Two-row boss button layout
  • Minimap button integration
  • Interactive title button with sound
  • Fixed 1080x410 window size
  • Precise pixel spacing (title: -8, view tabs: -44, main: -72, sub: -100, headers: -162, data: -182)

Data Isolation

• v1.0: Account-wide BCDLDB.entries (all characters shared data)
• Current: GUID-based per-character storage (BCDLDB.perChar)

Debug Tools

• v1.0: No debug capabilities
• Current:
  • /crit debug - Shows API availability, guild status, sync channel, counts
  • /crit debug on/off - Toggle sync message visibility
  • Warnings about shared folder SavedVariables issues

Throttling System

• v1.0: Basic 10s cooldown on sync
• Current:
  • 10s global sync cooldown
  • 5 minute REQ_SYNC cooldown (per session)
  • 60s per-sender response throttle
  • Random 0-2s delay on responses to avoid collision

Target Level Detection

• v1.0: No level detection
• Current: Scans 40+ unit tokens (target, focus, mouseover, nameplates) to find target level

Class Icons

• v1.0: Text-only class display
• Current: CLASS_ICON_TCOORDS-based circular class icons in dedicated column

Boss Detection & NPC Tracking

• v2.0: NPC ID extraction from combat log GUIDs
• v2.0: Reverse lookup table for boss identification
• v2.0: Separate storage per raid/boss encounter
• v2.0: Automatic dual-tracking (global + boss-specific)

Healing Tracking

• v2.0: Separate healing crit leaderboards
• v2.0: SPELL_HEAL and SPELL_PERIODIC_HEAL detection
• v2.0: Dedicated sync messages (REC_HEAL, SYNC_HEAL)
• v2.0: Healing tab in Global view with Personal/Guild/Class filters

Minimap Integration

• v2.0: Draggable minimap button with bcdl_small.png icon
• v2.0: Click to toggle leaderboard (replaces /crit command primary usage)
• v2.0: Tooltip with instructions
• v2.0: Removed shift-click report functionality

Known Limitations

Shared WoW Folders

When two accounts share the same WoW installation:

• Issue: Last logout overwrites SavedVariables
• Impact: Personal bests may be lost when alternating accounts
• Workaround:
  • Use separate WoW installations for each account, OR
  • Rely on guild sync (REQ_SYNC) to recover data on login

API Compatibility

• RegisterAddonMessagePrefix() not required in TBC Classic (gracefully skipped)
• SetBackdrop() may not exist (uses texture fallback)

Installation

1. Extract to Interface/AddOns/BigCritsDontLie/
2. Ensure folder structure:

   BigCritsDontLie/
   ├── BigCritsDontLie.lua
   ├── BigCritsDontLie.toc
   ├── README.md
   └── Media/
       ├── bcdl_small.png (minimap icon)
       └── Sound/
           ├── Victory.ogg
           └── biem.ogg

1. Restart WoW or /reload
2. Join a guild for leaderboard syncing
3. Look for minimap button to open leaderboard

Credits

Built for the WoW TBC Anniversary Classic community. Inspired by classic damage meter addons but focused purely on recording epic moments.

Version History

• v1.0 - Initial release with basic tracking
• v1.1 - Added guild sync and multi-character support
• v1.2 - Sync optimization, UI improvements, REQ_SYNC protocol
• v1.2.1 - Fixed SavedVariables mismatch (TOC declared BigCritsDontLieDB but code used BCDLDB) - data now persists correctly across /reload
• v2.0 - Raid boss tracking, healing crits, minimap button, three-level tab system, UI overhaul
• v2.0.1 - Added ESC/game menu keybind support to close window (current)

---

Changelog (v2.0.1)

Added

• ESC Key Support: Window now closes when pressing game menu keybind (UISpecialFrames integration)

---

Changelog (v2.0)

Added

• Raid Boss Tracking: Dedicated damage leaderboards for 14 bosses across 3 raids (Karazhan, Gruul's Lair, Magtheridon's Lair) - damage crits only
• Healing Crits: Full tracking and guild sync for critical heals (SPELL_HEAL, SPELL_PERIODIC_HEAL)
• Minimap Button: Draggable icon to open/close leaderboard (bcdl_small.png)
• Three-Level Tab System: View Mode (Global/Raids) → Main Tabs → Sub Tabs
• Interactive Title Button: Plays biem.ogg sound when clicked
• Boss Button Layout: Two rows, max 8 buttons per row with automatic positioning
• Auto-Sizing Raid Buttons: Text length-based width calculation
• Custom Boss Order: Follows raid progression (Attumen → Nightbane, etc.)
• NPC Detection: GUID parsing to identify boss encounters automatically
• Dual-Tracking: Damage crits stored in both global AND boss-specific leaderboards

Changed

• Window Size: 1080x295 → 1080x410 (optimized for multiple button rows)
• Layout System: Dynamic → Fixed positioning with precise pixel spacing
• Tab Anchoring: All tabs now anchored to BCDLBoard (not title)
• Boss Data: NPC_TO_BOSS reverse lookup for fast identification
• Sync Messages: Added REC_HEAL, SYNC_HEAL message types

Removed

• Shift-Click Report: Removed share functionality (replaced by minimap button focus)
• Dynamic Window Sizing: Fixed height prevents UI overlap issues

Fixed

• Boss Button Overflow: Two-row layout prevents 11-boss raids from UI overflow
• Tab Positioning: Headers/data no longer overlap with boss buttons
• Spacing Issues: Proper gaps between all UI elements (title, tabs, headers, data)

Technical

• New Data Tables: BCDLDB.raidBosses, BCDLDB.globalHealEntries, BCDLDB.perChar[x].healEntries
• New Functions: maybeStoreHeal(), maybeStoreBossCrit(), getNPCIdFromGUID(), getBossListForRaid()
• BOSS_DATA: 14 bosses with NPC IDs (supports multi-NPC bosses for adds/phases)
• BOSS_ORDER: Custom order arrays per raid for proper progression display

---

CurseForge: https://www.curseforge.com/wow/addons/big-crits-dont-lie