FallenXPBar (Support for 8 languages)

# FallenXPBar

### The XP bar that tells you what to do next.
**WoW: Forever & The Burning Crusade Anniversary** · by FallenSkullCorp

Most XP bars only show numbers. FallenXPBar works out what they mean: how fast you're **really** leveling, whether turning in your quests will **ding you right now**, and how many **kills or quests** you have left.

---

## ⚡ What makes it different

**🕒 XP/hour that AFK doesn't skew**
Your rate comes from your last 5–30 minutes of *active* play, and the timer pauses automatically while you're AFK. The time-to-level estimate keeps working the moment you ding, instead of resetting to "--".

**🏆 "Turn in now and you level"**
XP from quests that are ready to turn in is drawn on the bar as a **gold layer**. When it's enough to level you up, the bar **glows** and tells you:
> *Turn in quests → Level 24!*

You also get a one-time chat message and sound, so you know when a trip back to town is worth it.

**🎯 Kills & quests to level**
> *To level: ~14 kills • ~3 quests*

Based on your last 5 kills and quests, rested bonus included.

---

## 📊 Also on the bar
- Class-colored XP bar with a **rested XP** overlay
- Current / max / remaining XP and percentage
- **Time spent on this level** (active time, saved between sessions) and session timer
- Chat message on level-up with how long the level took
- Hides itself at max level (60 on Forever, 70 on Anniversary)

## ⚙️ Settings & minimap button
- Settings window, also listed in Blizzard's **Options → AddOns**
- **Minimap button:** left-click for settings, right-click to lock/unlock the bar, drag to move. Hover for a detailed stats tooltip (recent & level-average XP/hr, ETA, kills/quests to level, rested XP).
- Addon compartment support on Forever
- Adjustable **scale** and **width**; lock the bar so clicks pass through it
- Turn each feature on or off: quest overlay, glow alert, chat/sound alert, AFK pause, "to level" line

## 🌍 8 languages
**Türkçe · English · Deutsch · Русский · 中文 · Português · Français · Italiano**

On first install the addon uses your client's language. On English clients it starts in Turkish, so type `/fxp lang en` or pick a language in the settings. A font with full Turkish and Cyrillic support is included; Chinese uses the game's own Chinese font.

---

## ⌨️ Commands
| Command | What it does |
|---|---|
| `/fxp` | Open / close settings |
| `/fxp unlock` · `/fxp lock` | Move / lock the bar |
| `/fxp scale 1.2` | Bar size (0.6 – 2.0) |
| `/fxp reset` | Reset position, size and level stats |
| `/fxp minimap` | Show / hide the minimap button |
| `/fxp lang en` | Language: `tr` `en` `de` `ru` `zh` `pt` `fr` `it` |

`/fallenxpbar` works too.

## 🎮 Supported clients
- **WoW: Forever** (Interface 16001)
- **The Burning Crusade Anniversary** (Interface 20506)

## 📝 Good to know
- **Previously named ForeverXPbar.** If the old addon is still installed, your settings are copied over automatically and the old addon is disabled. After a `/reload` you can delete the `ForeverXPbar` folder.
- Time tracking starts when you install the addon. Time already spent on your current level can't be recovered.
- **Forever beta:** a known Blizzard bug can stop saved settings from loading, so your settings may reset at login. The addon itself keeps working normally.
- Lightweight: no libraries, no dependencies.

---

### 🇹🇷 Türkçe
**FallenXPBar sadece sayı göstermez, ne yapman gerektiğini söyler.**

- **AFK'dan etkilenmeyen XP/saat:** son dakikalardaki aktif oyununa göre hesaplanır, AFK iken sayaç durur.
- **"Teslim et, seviye atla" uyarısı:** hazır görevlerin XP'si çubukta altın katman olarak görünür. Seviye atlatmaya yetiyorsa çubuk parlar.
- **Seviyeye kaç kill / kaç görev kaldığı.**
- Ayar penceresi, minimap butonu ve 8 dil desteği.

Ayarlar için minimap butonuna tıkla veya `/fxp` yaz. Dili değiştirmek için `/fxp dil tr`.

---
*Font: Liberation Sans (SIL Open Font License). The license file is included in the package.*