PvPLedger combines **imported PvP ladder snapshots** with **your in-game match observations** so you can browse the ladder, review matches, and analyze combat performance in one place.

## Features

- **Ladder browser** — search players by name, class, spec, and bracket (Blitz, Shuffle, RBG, 2v2, 3v3)

- **Title cutoffs** — percentile-based Gladiator / Legend / Rank 1 estimates from snapshot data

- **Match log** — records arena and battleground matches with CR changes and rosters

- **Combat analysis** — damage, healing, interrupts, dispels, **CC Applied / CC Taken**, and spell breakdowns

- **Multi-region** — US, EU, KR, TW ladder data (via Sync or optional Data companion addons)

- **Localized UI** — 11 client locales (enUS, deDE, frFR, esES/esMX, itIT, koKR, ptBR, ruRU, zhCN/zhTW)

## Required: PvPLedger-AppHelper

Install **PvPLedger-AppHelper** alongside this addon. It is the bridge that receives updated ladder data from **PvPLedger Sync**.

## Recommended: PvPLedger Sync (Windows)

For automatic ladder updates without manual downloads:

1. Download **PvPLedger-Setup.exe** from [GitHub Releases](https://github.com/simplebooleanjim/PvPLedger/releases/tag/v0.8.0)

2. Run the installer (installs both addons + background tray app)

3. Enable **PvPLedger** and **PvPLedger-AppHelper** in WoW

4. Run `/reload` after Sync updates ladder files

## In-game

| Command | Action |

|---------|--------|

| `/pvl` | Open main window |

| `/pvl status` | Snapshot age and data sources |

| `/pvl update` | Refresh imported ladder data |

| `/pvl options` | Settings |

## Privacy

- **Ladder data** is downloaded from public GitHub snapshots (same as any data addon).

- **Match sharing is OFF by default.** Optional export (combat telemetry, account snapshots) only uploads when you enable **Share match data** in addon settings and run PvPLedger Sync.

See the [README](https://github.com/simplebooleanjim/PvPLedger#privacy--data-collection) for full details.

## License

MIT — see repository LICENSE file.

thePvPLedger