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