# 🎮 BLU | Better Level-Up!
## 🎮 **RGX Mods** - *RealmGX Community Project*

<div align="center">

<img src="https://raw.githubusercontent.com/donniedice/BLU/main/media/Textures/logo.png" alt="BLU Logo" width="128" height="128">

[![BLU Icon](https://img.shields.io/badge/BLU-Better%20Level%20Up!-05dffa?style=for-the-badge&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==&logoColor=white)](https://github.com/donniedice/BLU)

### 🌟 **Join the <span style="color:#ff6b6b">R</span>ealmGX Community - <span style="color:#4ecdc4">G</span>amers e<span style="color:#4ecdc4">X</span>treme!** 🌟
[![Discord](https://img.shields.io/discord/YOUR_DISCORD_ID?color=7289da&label=Join%20Our%20Discord&logo=discord&logoColor=white&style=for-the-badge)](https://discord.gg/N7kdKAHVVF)

### 🎵 *Experience level-up sounds from your favorite games in WoW!* 🎵

**Professional World of Warcraft addon that replaces default sounds with iconic audio from 50+ games, with extensive customization options.**

**🎯 Connect with fellow gamers, get support, and be part of the RGX Mods family!**

<!-- GitHub Stats & Badges -->
[![GitHub release (latest by date)](https://img.shields.io/github/v/release/donniedice/BLU?style=for-the-badge&logo=github&color=success)](https://github.com/donniedice/BLU/releases)
[![GitHub stars](https://img.shields.io/github/stars/donniedice/BLU?style=for-the-badge&logo=github&color=yellow)](https://github.com/donniedice/BLU/stargazers)
[![GitHub forks](https://img.shields.io/github/forks/donniedice/BLU?style=for-the-badge&logo=github&color=blue)](https://github.com/donniedice/BLU/network/members)
[![GitHub issues](https://img.shields.io/github/issues/donniedice/BLU?style=for-the-badge&logo=github&color=red)](https://github.com/donniedice/BLU/issues)
[![GitHub license](https://img.shields.io/github/license/donniedice/BLU?style=for-the-badge&logo=github&color=lightgrey)](https://github.com/donniedice/BLU/blob/main/LICENSE)

[![GitHub last commit](https://img.shields.io/github/last-commit/donniedice/BLU?style=flat-square&logo=github)](https://github.com/donniedice/BLU/commits/main)
[![GitHub commit activity](https://img.shields.io/github/commit-activity/m/donniedice/BLU?style=flat-square&logo=github)](https://github.com/donniedice/BLU/graphs/contributors)
[![GitHub repo size](https://img.shields.io/github/repo-size/donniedice/BLU?style=flat-square&logo=github)](https://github.com/donniedice/BLU)
[![GitHub code size](https://img.shields.io/github/languages/code-size/donniedice/BLU?style=flat-square&logo=github)](https://github.com/donniedice/BLU)

<!-- Platform Badges -->
[![CurseForge Downloads](https://img.shields.io/badge/CurseForge-Downloads-orange?style=flat-square&logo=curseforge)](https://www.curseforge.com/wow/addons/blu-better-level-up)
[![Wago Downloads](https://img.shields.io/badge/Wago.io-Downloads-purple?style=flat-square&logo=wago)](https://addons.wago.io/addons/blu)
[![WoWInterface Downloads](https://img.shields.io/badge/WoWInterface-Downloads-blue?style=flat-square&logo=worldofwarcraft)](https://www.wowinterface.com/downloads/info26465-BLU-BetterLevelUp.html)

<!-- WoW Compatibility -->
[![WoW Retail](https://img.shields.io/badge/WoW-The%20War%20Within-green?style=flat-square&logo=worldofwarcraft)](https://worldofwarcraft.com)
[![Version](https://img.shields.io/badge/Version-v6.0.0--alpha.6-red?style=flat-square)](https://github.com/donniedice/BLU/releases)

</div>



## 💖 Support RGX Mods

<div align="center">

**Your support helps keep RGX Mods alive and constantly improving!**

<a href="https://www.buymeacoffee.com/donniedice" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;" ></a>

[![Donate](https://img.shields.io/badge/Donate-CashApp-00C853?style=for-the-badge&logo=cash-app&logoColor=white)](https://bit.ly/3fyxxSU)
[![GitHub Sponsor](https://img.shields.io/badge/Sponsor-GitHub-ff69b4?style=for-the-badge&logo=github-sponsors&logoColor=white)](https://github.com/sponsors/donniedice)

[![Star this repository](https://img.shields.io/badge/⭐-Star%20this%20repository-yellow?style=for-the-badge&logo=github)](https://github.com/donniedice/BLU)

*Every coffee helps fund new features and sound additions!*

</div>

## 🎯 What is BLU?

**BLU | Better Level-Up!** transforms the repetitive sounds in World of Warcraft by letting you hear iconic sounds from your favorite games when you level-up, complete activities, gain reputation, or achieve milestones. With support for over 50 games and extensive customization options, BLU makes every achievement feel special.

## ✨ Features

<div align="center">

| Feature | Description |
|---------|-------------|
| 🎵 **50+ Game Sounds** | Choose from iconic sounds from games like Final Fantasy, Zelda, Mario, and more |
| 🎯 **Achievements** | Celebrate achievements with unique sounds |
| 🐾 **Battle Pets** | Custom sounds when leveling battle pets |
| ⚔️ **Delve Companion** | Sounds for Delve Companion level-ups |
| 🏆 **Honor Ranks** | Audio feedback for honor rank gains |
| ⭐ **Level-Up** | Replace default level-up sounds |
| 👑 **Renown Ranks** | Sounds for renown reputation gains |
| 📈 **Reputation** | Custom sounds for reputation increases |
| 📜 **Quests** | Unique sounds for quest accept/turn-in |
| 🛒 **Trading Post** | Sounds for Trading Post activities |
| 🔊 **Volume Control** | 3-tier volume system for BLU sounds (low/med/high) |
| 🎚️ **Sound Channels** | Choose which audio channel to use (Master, Sound, Music, etc.) |
| 🎛️ **Per-Event Override** | Customize volume for specific events |
| 📦 **SharedMedia Support** | Compatible with external sound packs |
| ⚙️ **Modular System** | Only load the features you need |
| 💾 **Profile Support** | Save different configurations |
| 🎨 **Modern UI** | Clean tabbed interface with dropdown menus |
| 🛡️ **No Dependencies** | Standalone addon with no external libraries |
| 🔧 **Debug Mode** | Built-in debugging for troubleshooting |

</div>

## 🚀 Quick Start

1. **Install** BLU from your preferred platform
2. **Launch** World of Warcraft
3. **Type** `/blu` to open the options panel
4. **Choose** your favorite sounds for each event
5. **Enjoy** your personalized WoW experience!

## 📋 Command Reference

<div align="center">

| Command | Description |
|---------|-------------|
| `/blu` | Open the options panel |
| `/blu help` | Display help information |
| `/blu debug` | Toggle debug mode on/off |
| `/blu status` | Show addon status |
| `/blu enable` | Enable addon |
| `/blu disable` | Disable addon |
| `/blu test` | Play test sound |

</div>

## 🎵 Available Game Sounds

<div align="center">

### 🎮 **50+ Games Available!**

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

*`Note`: Each game includes Low, Medium, and High volume variants for all sound types.*

### 🎯 **Special Sound Collections**
- **Elden Ring**: 6 unique variations
- **Shining Force 3**: 11 different battle themes
- **Warcraft 3**: Multiple unit acknowledgment sounds
- **The Witcher 3**: Quest completion variations

</div>

## 🎮 Sound Events

### Supported Events:
- **Level-Up**: Play custom sounds when you gain a level
- **Achievements**: Celebrate achievements with unique sounds
- **Quest Accept**: Custom sound when accepting quests
- **Quest Complete**: Rewarding sounds for quest turn-ins
- **Reputation Gains**: Audio feedback for reputation increases
- **Battle Pet Level-Up**: Special sounds for pet leveling (Retail only)
- **Trading Post**: Completion sounds for activities (Retail only)
- **Honor Ranks**: Recognition for PvP progression (Retail only)
- **Renown**: Sounds for renown reputation gains (Retail only)
- **Delve Companion**: Level-up sounds for your companion (Retail only)

### Sound System:
**BLU uses a 3-tier sound system:**

1. **Default WoW Sounds**: Original game sounds (no volume control)
2. **BLU Internal Sounds**: Custom sounds with 3 volume variants:
   - **High**: Full volume for maximum impact
   - **Medium**: Balanced volume (default)
   - **Low**: Subtle volume for background play
3. **External Sounds**: SharedMedia/SoundPak integration (plays at full volume)

## 🎮 Compatibility

<div align="center">

### 🌍 **Supported WoW Versions**

**BLU v6.0.0-alpha.6 supports World of Warcraft Retail only.**

| WoW Version | Interface | Status |
|-------------|-----------|---------|
| The War Within (Retail) | 110005 | ✅ Fully Supported |

**Note**: For Classic support, please use [BLU Classic](https://github.com/donniedice/BLU_Classic).

</div>

## 📥 Installation

1. **Download** from your preferred platform:
   - [CurseForge](https://www.curseforge.com/wow/addons/blu-better-level-up)
   - [Wago.io](https://addons.wago.io/addons/blu)
   - [WoWInterface](https://www.wowinterface.com/downloads/info26465-BLU-BetterLevelUp.html)
   - [GitHub](https://github.com/donniedice/BLU)

2. **Extract** to your WoW AddOns directory:
   - `World of Warcraft/_retail_/Interface/AddOns`

3. **Restart** WoW and enable in AddOns menu

## 🆕 What's New in v6.0.0-alpha.6

### Major Updates:
- **Complete Rewrite**: No external dependencies (removed Ace3)
- **Modern UI**: Tabbed interface with dropdown menus
- **Enhanced Volume Control**: Per-event volume overrides
- **Better Performance**: Modular loading system
- **RGXMods Integration**: Community features and support
- **Dynamic Module Loading**: Modules are now loaded dynamically from the modules folder.
- **Dynamic Testable Events**: Testable events are now dynamically populated.

### Looking for Classic Support?
<div align="center">

[![BLU Classic](https://img.shields.io/badge/BLU%20Classic-Universal%20Version-FFD700?style=for-the-badge&logo=worldofwarcraft)](https://github.com/donniedice/BLU_Classic)

**BLU Classic** supports ALL WoW versions (Retail, Classic Era, Cataclysm) with a single addon!

</div>

## 🛠️ Configuration Tips

### Recommended Settings:
- **Level-Up**: Final Fantasy, Pokemon, or Zelda for nostalgic feels
- **Achievements**: Elden Ring or Dark Souls for epic moments  
- **Quests**: Skyrim or Witcher 3 for immersive RPG experience
- **Reputation**: Warcraft 3 sounds to stay in the Warcraft universe

### Performance:
- Use "Low" volume variants if you experience any audio delays
- Debug mode can help identify any issues with sound playback
- All sounds are optimized .ogg files for minimal impact

## 🐛 Known Issues

- Double quest accept sound in Classic is a Blizzard bug, not BLU-related
- Some sounds may have slight delays on first play (cached after)

## 🤝 Contributing

Contributions are welcome! Feel free to:
- Report bugs via [GitHub Issues](https://github.com/donniedice/BLU/issues)
- Submit pull requests with improvements
- Suggest new game sounds to add
- Help with translations

## 📊 Repository Statistics

<div align="center">

<a href="https://github.com/donniedice/BLU">
  <img align="center" src="https://github-readme-stats.vercel.app/api?username=donniedice&show_icons=true&include_all_commits=true&theme=radical&hide_border=true" alt="DonnieDice's GitHub Stats" />
</a>

<a href="https://github.com/donniedice/BLU">
  <img align="center" src="https://github-readme-stats.vercel.app/api/top-langs/?username=donniedice&layout=compact&theme=radical&hide_border=true" alt="Top Languages" />
</a>

</div>

<div align="center">

[![GitHub Activity Graph](https://github-readme-activity-graph.vercel.app/graph?username=donniedice&theme=react-dark&hide_border=true)](https://github.com/donniedice/BLU)

</div>

---

## 📈 Project Metrics

<div align="center">

| Metric | Value |
|--------|-------|
| **Total Lines of Code** | ![Lines of code](https://img.shields.io/tokei/lines/github/donniedice/BLU?style=flat-square) |
| **Repository Size** | ![GitHub repo size](https://img.shields.io/github/repo-size/donniedice/BLU?style=flat-square) |
| **Last Commit** | ![GitHub last commit](https://img.shields.io/github/last-commit/donniedice/BLU?style=flat-square) |
| **Open Issues** | ![GitHub issues](https://img.shields.io/github/issues/donniedice/BLU?style=flat-square) |
| **Pull Requests** | ![GitHub pull requests](https://img.shields.io/github/issues-pr/donniedice/BLU?style=flat-square) |
| **Contributors** | ![GitHub contributors](https://img.shields.io/github/contributors/donniedice/BLU?style=flat-square) |
| **Total Game Sounds** | 50+ unique games |
| **Sound Files** | 198 audio files |
| **Supported Events** | 10 event types |
| **Languages** | ![GitHub top language](https://img.shields.io/github/languages/top/donniedice/BLU?style=flat-square) |
| **Watchers** | ![GitHub watchers](https://img.shields.io/github/watchers/donniedice/BLU?style=flat-square) |

</div>

---

## 🤝 Contributors

<div align="center">

Thanks to all the amazing people who have contributed to BLU! 🎉

<a href="https://github.com/donniedice/BLU/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=donniedice/BLU" alt="Contributors" />
</a>

</div>

---

## 🏆 GitHub Achievements

<div align="center">

[![trophy](https://github-profile-trophy.vercel.app/?username=donniedice&theme=radical&no-frame=true&row=1&column=6)](https://github.com/donniedice/BLU)

</div>

---

## 🔥 Streak Stats

<div align="center">

[![GitHub Streak](https://github-readme-streak-stats.herokuapp.com?user=donniedice&theme=radical&hide_border=true)](https://github.com/donniedice/BLU)

</div>

---

<div align="center">

## 🌟 **Thank you for choosing RGX Mods!** 🌟

**Made with ❤️ by the RealmGX Community**
**Lead Developer: [DonnieDice](https://github.com/donniedice)**

*"Make every level count with sounds that matter!"*

<div align="center">

[![Join Discord](https://img.shields.io/badge/🎮%20Join%20RealmGX%20Discord-Realm%20Gamers%20eXtreme-7289da?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/N7kdKAHVVF)

[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Support%20RGX%20Mods-yellow?style=for-the-badge)](https://www.buymeacoffee.com/donniedice)
[![GitHub Stars](https://img.shields.io/github/stars/donniedice/BLU?style=for-the-badge&logo=github)](https://github.com/donniedice/BLU)

**🎮 RGX Mods - Powered by RealmGX Community**

</div>

</div>

</div>
