Occult Ledger - Buffs, DPS, Ranks & Live Win Odds

Occult Ledger (formerly Buff Ledger)

Keeps the books on your match: every permanent buff from Golden Statues and Sinner's Sacrifice, your damage, the players you face and your odds of winning.
Hold Tab to see it all, or choose exactly what stays on screen.

---

✦ New in 1.9

• Live win odds: a slim bar under the central emblem, in the game's own Amber and Sapphire colours. It starts at 50/50 and moves with both teams' souls, kills and assists.
• Match card: rank, games and win rate on their hero, KDA and damage per minute for all 12 players, plus a team vs team estimate from ranks.
• Rank badges on the top-bar portraits.
• Show it your way: every panel and every ledger section can be set to always shown, Tab only, hidden with Tab or never. The match card and the bar can also show during the countdown before the doors open.

---

✦ The ledger (Tab)

• Every game language: stat names, categories and sources come straight from the game's own translations.
• Instant updates: a stat goes up the moment its buff appears, with a short flash on the row.
• Sorted by shop category (Weapon, Vitality, Spirit), with the total and pickup count (×n) for each stat.
• Sources split: Sinner's Sacrifice jackpots (with buff count) vs. Golden Statues. The total pulses on every jackpot.
• Pace: buffs per minute and the time of your last Sinner.
• Recent buffs: match time, tier (I, II or III) and source of your latest pickups.
• Damage: total dealt, weapon / spirit / melee split, average and peak DPS, headshot rate, damage to heroes and troopers, damage taken, healing, and a curve of the whole match with your deaths marked.
• Last-match recap in the hideout, with the change vs. the match before (▲ / ▼).

✦ DPS meter

• Live DPS while you fight, with your peak and your match average.
• 5-level gauge (Very low to Huge) against your own average, with a needle showing exactly where you are.
• Last 13 seconds as a mini chart: your bursts and lulls at a glance.
• Fight summary when a fight ends: duration, damage, DPS, headshots.

✦ Damage reference

• Compares your hero damage with players of your rank on your hero, at the same point of the match (data from the last 30 days on deadlock-api.com).
• Shows a grade (S, A, B…) and your standing (TOP x %). The reference rank can be changed in the settings.

---

✦ Stays out of the way

• Hidden wherever the game hides its combat HUD (hideout outside the combat zone, Street Brawl interludes, death replay), in the shop and in the Escape menu.
• Accurate: nothing is counted while you're dead or spectating, it resets every new match, and it keeps counting through HUD reloads.
• Rem friendly: two jackpots landing together (two Lil Helpers) count as 2 Sinners.

✦ Make it yours

• Display modes for every panel and section (see above).
• 4 themes: Brass, Emerald, Amethyst, Steel.
• Compact mode: one line per category.
• Colourblind palette.
• Size, opacity, background opacity (down to text only), border and position of each panel.

---

✦ Installation

1. Drop pak21_dir.vpk into Deadlock\game\citadel\addons\ (rename it if 21 is taken), or use a mod manager.
2. Remove other mods that replace citadel_hud_modifier_message (for example Sinners and Statues Tracker), as they will conflict.
3. Play a match and hold Tab.

✦ Settings

• With Universal Mod Manager (recommended): everything can be changed in game and is saved, grouped by panel, with the display modes first.
• Without it: edit config.json in the source kit and run python build.py.

✦ Online data

• Ranks, player stats and the damage reference come from deadlock-api.com, through a small public page the mod opens in a hidden panel (the HUD cannot reach the web by itself).
• It only sends the account IDs and heroes of the players in your match. Turn off the match card, rank badges and damage reference to stay fully offline. The ledger, the DPS meter and the live win bar work without it.

---

✦ Known limits

• A Sinner jackpot hit with a light melee only gives 1 buff, so it can't be told apart from a statue.
• The Golden Egg's buffs count as statues.
• The last-match recap is kept until you close the game.
• The live win odds are a theoretical model (souls, kills, assists), not trained on real matches. Objectives only count through the souls they give.
• Bots have no account: no rank or stats for them, and no match card or reference in the sandbox.
• The damage reference is meaningless against bots (they never dodge or fight back).

✦ Credits

• Idea inspired by Sinners and Statues Tracker by Xaohs.
• Player and hero statistics by deadlock-api.com.
• Compiled file formats documented by ValveResourceFormat (Source 2 Viewer).

Found a bug or have an idea? Leave a comment!