Suppai_NekoandClaude Opus 5.5
2b01e23955
The option to hide Blizzard's floating XP text was removed in 1.0.1, so the Features section now only covers hiding the XP chat line. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
92 lines
3.5 KiB
Markdown
92 lines
3.5 KiB
Markdown
|
||
|
||
# XP Percent
|
||
|
||
A World of Warcraft addon that shows every XP gain as a **percentage of your current level** instead of a flat number.
|
||
|
||
Instead of a flat XP number, you see `+1.25% XP`, so you know right away how much closer you are to leveling.
|
||
|
||
## Features
|
||
|
||
- **Floating popup:** a "+1.25% XP" popup that floats up and fades out with each gain.
|
||
- **Quest XP labelled:** XP from turning in a quest shows as `XP (quest)`.
|
||
- **Correct across level-ups:** a gain that crosses into a new level counts the rest of the old level plus your progress into the new one.
|
||
- **Customizable look:** font size, text color, and number of decimal places (0–4).
|
||
- **Drag to move:** unlock the popup, drag it anywhere on screen, then lock it again.
|
||
- **Blizzard's XP chat line:** choose whether to hide or keep Blizzard's own "You gain 200 experience" message in chat.
|
||
- **Optional chat line:** also print the % gain in chat.
|
||
|
||
## Download
|
||
|
||
<img src="images/icon.png" alt="XP Percent icon" width="96" align="left">
|
||
|
||
**[XPPercent-1.0.1.zip](https://git.utils.halinium.io/Suppai_Neko/XPPercent/raw/branch/main/releases/XPPercent-1.0.1.zip)** (latest release)
|
||
|
||
Extract it into your `Interface\AddOns` folder. See below for details.
|
||
|
||
<br clear="left">
|
||
|
||
## Installation
|
||
|
||
1. Download the release zip above and extract it, or clone this repository.
|
||
2. Put the `XPPercent` folder in your WoW addons folder:
|
||
```
|
||
World of Warcraft\<_retail_ or _classic_era_>\Interface\AddOns\XPPercent
|
||
```
|
||
The folder must be named `XPPercent` and contain `XPPercent.toc` directly inside it.
|
||
3. Restart the game, or `/reload` if it was already running, and make sure **XP Percent** is enabled in the AddOns list on the character select screen.
|
||
|
||
To clone it straight into place:
|
||
|
||
```
|
||
cd "World of Warcraft/_retail_/Interface/AddOns"
|
||
git clone https://git.utils.halinium.io/Suppai_Neko/XPPercent.git
|
||
```
|
||
|
||
## Usage
|
||
|
||
Open the options with `/xpp`, or from **Esc → Options → AddOns → XP Percent**.
|
||
|
||
|
||
|
||
The options window lets you:
|
||
|
||
- turn the popup on or off, and set its font size and color;
|
||
- preview it with **Test popup**;
|
||
- move it with **Unlock popup** (drag the blue box, then click **Lock popup**) or put it back with **Reset position**;
|
||
- choose whether Blizzard's own XP chat message is hidden;
|
||
- also print the % gain in chat, and set the number of decimal places.
|
||
|
||
### Slash commands
|
||
|
||
| Command | What it does |
|
||
|---|---|
|
||
| `/xpp` | Open the options window |
|
||
| `/xpp test` | Show a sample popup |
|
||
| `/xpp unlock` / `/xpp lock` | Turn drag-to-move mode on / off |
|
||
| `/xpp pos <x> <y>` | Set an exact popup position (offset from screen center, default `0 60`) |
|
||
| `/xpp size <n>` | Set the popup font size |
|
||
| `/xpp 0`–`/xpp 4` | Number of decimal places |
|
||
| `/xpp popup` | Toggle the floating popup |
|
||
| `/xpp chat` | Toggle printing the % gain in chat |
|
||
| `/xpp blizz` | Toggle hiding Blizzard's XP chat message |
|
||
| `/xpp help` | List all commands in chat |
|
||
|
||
`/xppercent` works the same as `/xpp`.
|
||
|
||
## Files
|
||
|
||
| File | Purpose |
|
||
|---|---|
|
||
| `XPPercent.toc` | Addon metadata and load order |
|
||
| `XPPercent.lua` | Core: XP tracking, popup, drag-to-move, hiding Blizzard's chat line, slash commands |
|
||
| `Options.lua` | The options window |
|
||
| `images/` | Icon, banner and screenshot (repo only, not part of the addon) |
|
||
| `releases/` | Release zips (repo only) |
|
||
|
||
Settings are saved per account in the `XPPercentDB` saved variable.
|
||
|
||
## License
|
||
|
||
Released into the public domain under [The Unlicense](UNLICENSE). Use it however you like.
|