# BLU | Better Level Up!

![](https://github.com/donniedice/BLU/blob/main/images/preview.png)

## Overview
**BLU | Better Level Up!** changes up the repetitive sounds in World of Warcraft, giving you the option to hear sounds from other games when you level up, complete Trade Post activities, gain reputation, or level up your Delve Companion.

---

## Features
- **Achievements:** Play sounds from other games when you earn achievements.
- **Battle-Pets:** *(`R`etail Only)* Play sounds from other games when you level up battle-pets.
- **Delve Companion Level Up:** *(`R`etail Only)* Play sounds from other games when your Delve Companion levels up.
- **Honor Ranks:** *(`R`etail Only)* Play sounds from other games when you gain honor ranks.
- **Level Up:** Play sounds from other games when you level up.
- **Renown Reputation Ranks:** *(`R`etail Only)* Play sounds from other games when you gain DragonFlight renown reputation ranks.
- **Reputation Ranks:** Play sounds from other games when you gain reputation ranks.
- **Quests:** Play sounds from other games when you accept or turn in quests.
- **Trading Post Activities:** *(`R`etail Only)* Play sounds from other games when you complete Trading Post activities.

*Note: All sounds feature independent volume adjustment capability.*

---

## Slash Commands

The addon can be managed using the following slash commands:

- **`/blu`**: Opens the options panel.
- **`/blu debug`**: Toggles debug mode.
- **`/blu welcome`**: Toggles the welcome message on login.
- **`/blu help`**: Displays help information.

---

## Available Game Sounds
- Altered Beast
- Assassin's Creed
- Castlevania
- Diablo 2
- Dragon Quest
- DotA 2
- Elden Ring
- EverQuest
- Fallout - New Vegas
- Fallout 3
- Final Fantasy
- Fire Emblem
- Fire Emblem - Awakening
- Fly For Fun
- Fortnite
- GTA - San Andreas
- Kingdom Hearts 3
- Kirby
- League of Legends
- Legend of Zelda
- Maplestory
- Metal Gear Solid 5
- Minecraft
- Modern Warfare 2
- Morrowind
- Old School Runescape
- Palworld
- Path of Exile
- Pokemon
- Ragnarok Online
- Shining Force II
- Shining Force III
- Skyrim
- Sonic The Hedgehog
- Spyro The Dragon
- Super Mario Bros 3
- Warcraft 3
- Witcher 3

*Note: When new sounds are added, they are listed in alphabetical order. This may change the selection order in the code for `Options.lua`. You may need to re-select previously selected sounds after updates.*

---

## Compatibility
- **The War Within**
- **Classic WoW** (Season of Discovery, Classic Hardcore)
- **Classic Cataclysm**

*Note: Double Quest Accept Sound in WoW: Classic is a game bug, not related to BLU.*

---

## Installation
1. Download the addon from [Curse](https://www.curseforge.com/wow/addons/blu-better-level-up), [GitHub](https://github.com/donniedice/BLU), [Wago](https://addons.wago.io/addons/blu), or [WoWInterface](https://www.wowinterface.com/downloads/info26465-BLU-BetterLevelUp.html).
2. Extract the downloaded file to your World of Warcraft `Interface/AddOns` directory:
   - For **The War Within**: `World of Warcraft/_retail_/Interface/AddOns`
   - For **Classic Cataclysm**: `World of Warcraft/_classic_/Interface/AddOns`
   - For **Classic WoW** (Season of Discovery, Classic Hardcore): `World of Warcraft/_classic_era_/Interface/AddOns`
3. Restart World of Warcraft and enable the addon in the Addons menu.

---

## Support the Project

### ☕️ Buy Me a Coffee
If you found this project helpful or enjoyable, you can support my work by buying me a coffee. Your support keeps this project alive and motivates me to create more!

[![Buy Me a Coffee](https://img.shields.io/badge/☕️-Buy%20Me%20a%20Coffee-orange?style=flat-square&logo=buy-me-a-coffee)](https://www.buymeacoffee.com/donniedice)

### Your Support Helps:
- 🛠️ Maintain and improve the project.
- 🚀 Add new features.
- 🐛 Fix bugs.
- 📚 Write detailed documentation.

Thank you for your support! 🙏

### 💸 Other Ways to Support:
[![Donate via CashApp](https://img.shields.io/static/v1?label=Donate&message=CashApp&color=brightgreen)](https://bit.ly/3fyxxSU)

### 💬 Stay in Touch:
- Follow me on [GitHub](https://github.com/donniedice) 🐙

### ⭐️ Show Your Support:
- Star this project on [GitHub](https://github.com/donniedice/BLU) ⭐️
- Share it with your friends and colleagues 📢
