# 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 `sounds.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 📢
