# XPBar

**A clean, fully customizable experience bar replacement for World of Warcraft Retail.**

XPBar replaces the default Blizzard experience bar with a feature-rich, movable bar that gives you all the information you need at a glance — without the clutter.

---

## Features

### Main Bar
- Displays your current **level**, **XP current / max**, and **progress percentage**
- Shows **rested XP percentage** alongside your current progress `65.8% (70.6%)`
- **Colored segments** appear right after the XP fill:
- 🟠 **Orange** — completed quests ratio from your quest log
- 🔵 **Blue** — rested experience bonus
- Optional **incomplete quests bar** shown behind the XP fill (grey overlay)
- Automatically **hides at max level** (optional: keep visible)

### Info Line (below the bar)
- **Completed Quests %** — proportion of completed quests in your journal
- **Rested Experience %** — current rested bonus
- **XP/hour** — calculated from your session gain
- **Estimated time to level** — based on your current XP/hour rate

### Session Tracking
- Tracks XP gained since login
- Calculates XP/hour and time-to-level in real time
- Optional reset of session data on UI reload

### Tooltip
Hover the bar to see a full breakdown:
- XP current / max
- Progress %
- XP remaining
- Rested XP amount and %
- Quest completion
- Session duration, XP/hour, estimated time to next level

---

## Controls

| Action | Result |
|---|---|
| `Shift + Drag` | Move the bar anywhere on screen |
| `Shift + Right Click` | Open / close the options panel |
| `/xpbar` | Open options panel |
| `/xpbar hide` / `show` | Toggle bar visibility |
| `/xpbar reset` | Reset all saved settings |

---

## Options Panel

Accessible via `Shift + Right Click` on the bar or `/xpbar`:

- **Width slider** — from 200 to 1200 px
- **Height slider** — from 10 to 60 px
- Played Time Text
- Session Time Text
- Leveling Time & XP/Hour Text
- Completed & Rested Text
- Show Incomplete Quests Bar
- Show Bar at Max Level
- Reset Session on Reload UI
- **Hide Default Experience Bar** — replaces the Blizzard bar entirely

The bar position is **saved per character** and locked automatically when you close the options panel.

---

## Compatibility

- ✅ World of Warcraft Retail **12.0.5 / 12.0.7**
- ✅ No dependencies — standalone addon
- ✅ Works in combat (drag and options available at all times)
- ✅ Compatible alongside combat addons (Details, BigWigs, WeakAuras, etc.)

---

## Installation

1. Download and unzip into `World of Warcraft/_retail_/Interface/AddOns/`
2. Make sure the folder is named `XPBar`
3. Reload or restart the game
4. The bar appears immediately — `/xpbar` to configure

---

## Author

**Tibiscui** — Kirin Tor (EU)

Feedback, bug reports and suggestions welcome via the CurseForge issue tracker.

XPBAR