thePvPLedger-Data-US

# PvPLedger-Data-US

**PvPLedger-Data-US** is an optional companion addon for [PvPLedger](https://github.com/simplebooleanjim/PvPLedger). It ships bundled **US region** PvP ladder snapshots that the main addon merges into its ladder browser, title cutoffs, and standing estimates.

Use this if you play on **US realms** and want fresh ladder data delivered through your addon manager, without waiting for a full PvPLedger update.

---

## What’s included

Snapshot data for **season 41** across five brackets:

| Bracket | Data |
|---------|------|
| Battleground Blitz | Top listed players per spec |
| Solo Shuffle | Top listed players per spec |
| Rated Battlegrounds | Top 1000 |
| Arena 2v2 | Top ~1000 |
| Arena 3v3 | Top ~1000 |

Data is sourced from the **Blizzard API**. Some brackets also use **Seramate** enrichment for class/spec details where the API alone is incomplete.

---

## Requirements

- **PvPLedger** (main addon) — required
- **PvPLedger-AppHelper** — recommended (required for the full PvPLedger experience)

This companion is **optional**. PvPLedger already includes US ladder data in the main addon, and **PvPLedger Sync** can push newer snapshots through AppHelper automatically. Install this pack if you want an extra data source that updates independently via CurseForge.

PvPLedger always uses the **newest** snapshot per bracket from every installed source.

---

## Installation

1. Install **PvPLedger**, **PvPLedger-AppHelper**, and **PvPLedger-Data-US**.
2. Enable all three in the WoW AddOns list.
3. Set **Ladder region** to **US** in PvPLedger options (**Options → AddOns → PvPLedger**).
4. Run **`/reload`** or **`/pvl update`** in-game.

Check active snapshot dates with **`/pvl status`**.

---

## Staying up to date

| Method | How |
|--------|-----|
| **This addon** | Update via CurseForge when a new file is published |
| **PvPLedger Sync** (recommended) | [Download from GitHub](https://github.com/simplebooleanjim/PvPLedger/releases/latest) — keeps AppHelper fresh in the background |

You can use both. PvPLedger picks whichever source has the newer snapshot.

---

## Other regions

Separate optional companions exist for **EU**, **KR**, and **TW** if you play on those regions.

---

## Privacy

This addon only contains **public PvP leaderboard snapshot data**. No account data is collected or transmitted.

---

## Links

- **Main addon:** PvPLedger (required)
- **Bridge addon:** PvPLedger-AppHelper (recommended)
- **Windows sync app:** [GitHub Releases](https://github.com/simplebooleanjim/PvPLedger/releases/latest)
- **Source & issues:** [github.com/simplebooleanjim/PvPLedger](https://github.com/simplebooleanjim/PvPLedger)

**License:** MIT