# PvPLedger-Data-TW

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

Use this if you play on **TW realms** and want ladder data for your region delivered through your addon manager.

---

## 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 listed players |
| Arena 2v2 | Top listed players |
| Arena 3v3 | Top listed players |

Data is sourced from the **Blizzard API**.

**Note:** TW ladder player counts are smaller than US/EU regions, reflecting the size of the published TW leaderboard on Battle.net.

---

## Requirements

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

This companion is **optional**. The main PvPLedger addon ships with **US** ladder data by default. TW players should install this pack **and/or** use **PvPLedger Sync** with the region set to TW.

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

---

## Installation

1. Install **PvPLedger**, **PvPLedger-AppHelper**, and **PvPLedger-Data-TW**.
2. Enable all three in the WoW AddOns list.
3. Set **Ladder region** to **TW** 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) — set region to `TW` in `%APPDATA%\PvPLedger\sync-config.json`, then run the tray app |

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

---

## Other regions

Separate optional companions exist for **US**, **EU**, and **KR**.

---

## 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

thePvPLedger-Data-TW