# <img src="https://raw.githubusercontent.com/donniedice/BLU/main/media/Textures/logo.png" width="25" height="25"> <span style="color:#05dffa">B</span><span style="color:#05dffa">L</span><span style="color:#05dffa">U</span> <span style="color:#3598db">|</span> <span style="color:#05dffa">B</span><span style="color:#fff">etter </span><span style="color:#05dffa">L</span><span style="color:#fff">evel-</span><span style="color:#05dffa">U</span><span style="color:#fff">p!</span>
## <img src="https://raw.githubusercontent.com/donniedice/SimpleQuestPlates/main/images/kiwi.gif" height="20"> <span style="color:#8B1538">R</span><span style="color:#8B1538">G</span><span style="color:#8B1538">X</span> <span style="color:#4ecdc4">Mods</span> <span style="color:#3598db">-</span> [<span style="color:#8B1538">R</span><span style="color:#7598b6">ealm</span><span style="color:#8B1538">G</span><span style="color:#8B1538">X</span>](https://realmgx.com) <span style="color:#05dffa">Community Project</span>

<div align="center">

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

[![BLU](https://img.shields.io/badge/BLU-Better%20Level%20Up!-05dffa?style=for-the-badge&logo=github&logoColor=white)](https://github.com/donniedice/BLU)
[![RGX Mods](https://img.shields.io/badge/RGX-Mods%20Collection-8B1538?style=for-the-badge&logo=github&logoColor=white)](https://discord.gg/N7kdKAHVVF)

### <span style="color:#05dffa">🌟 Join the </span> <span style="color:#8B1538">R</span><span style="color:#7598b6">ealm</span><span style="color:#8B1538">G</span><span style="color:#8B1538">X</span> <span style="color:#4ecdc4">Community</span> <span style="color:#3598db">-</span> <span style="color:#8B1538">G</span><span style="color:#7598b6">amers e</span><span style="color:#8B1538">X</span><span style="color:#7598b6">treme!</span> <span style="color:#05dffa">🌟</span>
[![Discord](https://img.shields.io/discord/N7kdKAHVVF?color=7289da&label=Join%20Our%20Discord&logo=discord&logoColor=white&style=for-the-badge)](https://discord.gg/N7kdKAHVVF)

### <span style="color:#05dffa">🎵 </span> <span style="color:#e67e23">*Experience level-up sounds from your favorite games in WoW!*</span> <span style="color:#05dffa">🎵</span>

**<span style="color:#05dffa">B</span><span style="color:#05dffa">L</span><span style="color:#05dffa">U</span> <span style="color:#e67e23">is a professional</span> <span style="color:#06c">World of Warcraft</span> <span style="color:#e67e23">addon that replaces default sounds with iconic audio from 50+ games, with extensive customization options.</span>**

**<span style="color:#05dffa">🎯 </span> <span style="color:#e67e23">Connect with fellow gamers, get support, and be part of the</span> <span style="color:#8B1538">R</span><span style="color:#8B1538">G</span><span style="color:#8B1538">X</span> <span style="color:#4ecdc4">Mods</span> <span style="color:#e67e23">family!</span>**

---

<!-- GitHub Stats & Badges -->
[![GitHub release](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)

<!-- Platform Badges -->
[![CurseForge](https://img.shields.io/badge/CurseForge-Downloads-orange?style=flat-square&logo=curseforge)](https://www.curseforge.com/wow/addons/blu-better-level-up)
[![Wago](https://img.shields.io/badge/Wago.io-Downloads-purple?style=flat-square&logo=wago)](https://addons.wago.io/addons/blu)
[![WoWInterface](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-Retail%20Midnight-05dffa?style=flat-square&logo=worldofwarcraft)](https://worldofwarcraft.com)
[![Version](https://img.shields.io/badge/Version-v6.2.0-blue?style=flat-square)](https://github.com/donniedice/BLU/releases)

[Features](#features) • [Quick Start](#quick-start) • [Commands](#command-reference) • [Compatibility](#compatibility) • [Installation](#installation) • [Support](#support)

</div>

---

## <span style="color:#05dffa">🌟 Join the </span> <span style="color:#8B1538">R</span><span style="color:#8B1538">G</span><span style="color:#8B1538">X</span> <span style="color:#4ecdc4">Mods Community!</span>

<div align="center">

### <span style="color:#b96ad9">💬 </span> <span style="color:#8B1538">R</span><span style="color:#7598b6">ealm</span><span style="color:#8B1538">G</span><span style="color:#8B1538">X</span> <span style="color:#05dffa">Discord</span> <span style="color:#3598db">-</span> <span style="color:#2dc26b">Your Gaming Home!</span>

[![Join Discord](https://img.shields.io/badge/Join%20Our%20Discord-RealmGX%20Community-7289da?style=for-the-badge&logo=discord&logoColor=white&labelColor=5865F2)](https://discord.gg/N7kdKAHVVF)

**<span style="color:#05dffa">🎮 </span> [<span style="color:#8B1538">R</span><span style="color:#7598b6">ealm </span> <span style="color:#8B1538">G</span><span style="color:#7598b6">amers e</span><span style="color:#8B1538">X</span><span style="color:#7598b6">treme</span>](https://realmgx.com) <span style="color:#3598db">-</span> <span style="color:#4ecdc4">Where WoW Enthusiasts Unite!</span>**

**<span style="color:#e67e23">✨ What awaits you in our Discord:</span>**
- <span style="color:#2dc26b">🛠️ **Instant addon support**</span> <span style="color:#e67e23">from the</span> <span style="color:#8B1538">R</span><span style="color:#8B1538">G</span><span style="color:#8B1538">X</span> <span style="color:#4ecdc4">Mods</span> <span style="color:#e67e23">team</span>
- <span style="color:#ff6b6b">🎯 **Feature requests**</span> <span style="color:#e67e23">and direct dev communication</span>
- <span style="color:#b96ad9">🚀 **Beta testing**</span> <span style="color:#e67e23">opportunities for new releases</span>
- <span style="color:#4ecdc4">🤝 **Community of WoW players**</span> <span style="color:#e67e23">sharing tips and experiences</span>
- <span style="color:#05dffa">📢 **First to know**</span> <span style="color:#e67e23">about new</span> <span style="color:#8B1538">R</span><span style="color:#8B1538">G</span><span style="color:#8B1538">X</span> <span style="color:#4ecdc4">Mods</span> <span style="color:#e67e23">releases</span>
- <span style="color:#e67e23">🎉 **Events, giveaways**, and community activities</span>

<img src="https://raw.githubusercontent.com/donniedice/SimpleQuestPlates/main/images/kiwi.gif" alt="RealmGX Kiwi" width="100">

**<span style="color:#ff6b6b">⚠️ WARNING:</span>** <span style="color:#e67e23">May cause excessive nostalgia for your favorite games.</span>

**<span style="color:#2dc26b">The Kiwi Says:</span>** <span style="color:#b96ad9">"Bwwiiiee."</span>

</div>

---

## <span style="color:#05dffa">💖 Support </span> <span style="color:#8B1538">R</span><span style="color:#8B1538">G</span><span style="color:#8B1538">X</span> <span style="color:#4ecdc4">Mods</span>

<div align="center">

**<span style="color:#e67e23">Your support helps keep</span> <span style="color:#8B1538">R</span><span style="color:#8B1538">G</span><span style="color:#8B1538">X</span> <span style="color:#4ecdc4">Mods</span> <span style="color:#e67e23">alive and constantly improving!</span>**

| | |
|---|---|
| [![Donate](https://img.shields.io/badge/Donate-CashApp-00C853?style=for-the-badge&logo=cash-app&logoColor=white)](https://bit.ly/3fyxxSU) | [![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Support-FFDD00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=black)](https://buymeacoffee.com/donniedice) |
| [![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](https://img.shields.io/badge/⭐-Star%20this%20repository-yellow?style=for-the-badge&logo=github)](https://github.com/donniedice/BLU) |

_<span style="color:#e67e23">Every coffee helps fund new features and sound additions!</span>_

</div>

---

## <span style="color:#05dffa">🎯 What is BLU?</span>

**<span style="color:#05dffa">B</span><span style="color:#05dffa">L</span><span style="color:#05dffa">U</span> <span style="color:#3598db">|</span> <span style="color:#05dffa">B</span><span style="color:#fff">etter </span><span style="color:#05dffa">L</span><span style="color:#fff">evel-</span><span style="color:#05dffa">U</span><span style="color:#fff">p!</span>** <span style="color:#e67e23">transforms the repetitive sounds in</span> <span style="color:#06c">World of Warcraft</span> <span style="color:#e67e23">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.</span>

### <span style="color:#05dffa">🔥 Why Choose BLU?</span>
- **<span style="color:#2dc26b">🎮 50+ Games:</span>** <span style="color:#e67e23">Iconic sounds from Final Fantasy, Zelda, Mario, Skyrim, and many more</span>
- **<span style="color:#05dffa">🌟 Sound Pack API:</span>** <span style="color:#e67e23">Addon devs can register custom sound packs directly with BLU</span>
- **<span style="color:#b96ad9">🛠️ Modular:</span>** <span style="color:#e67e23">Only load the feature modules you actually use</span>
- **<span style="color:#4ecdc4">🎯 No Dependencies:</span>** <span style="color:#e67e23">Auto-discovers sounds from other addons — no libraries required</span>
- **<span style="color:#ff6b6b">💬 Active Support:</span>** <span style="color:#e67e23">Join our Discord for instant help!</span>

**<span style="color:#e67e23">Note</span><span style="color:#3598db">:</span>** <span style="color:#e67e23">For Classic WoW support, use</span> [<span style="color:#05dffa">BLU Classic</span>](https://github.com/donniedice/BLU_Classic)<span style="color:#e67e23">.</span>

---

## <span style="color:#05dffa">✨ Features</span>

<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 |
| 📦 **Sound Pack Support** | Auto-discovers sounds from other addons — no dependencies required |
| 🗂️ **User Custom Sounds** | Drop your own `.ogg`/`.mp3`/`.wav` files in `BLU\user\sounds\` |
| 🔌 **Third-Party API** | Addon devs can register packs via `BLU:RegisterExternalSoundPack()` |
| ⚙️ **Modular System** | Only load the features you need |
| 💾 **Profile Support** | Save different configurations |
| 🎨 **Modern UI** | Clean tabbed interface with inline sound previews |
| 🔧 **Debug Mode** | Built-in debugging for troubleshooting |

</div>

---

## <span style="color:#05dffa">🎵 Available Game Sounds</span>

<div align="center">

### <span style="color:#05dffa">🎮 50+ Games Available!</span>

| | | |
|---|---|---|
| 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._

### <span style="color:#05dffa">🎯 Special Sound Collections</span>
- **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>

---

## <span style="color:#05dffa">🎮 Sound Events</span>

### <span style="color:#4ecdc4">Supported Events:</span>
- **<span style="color:#2dc26b">Level-Up</span><span style="color:#3598db">:</span>** <span style="color:#e67e23">Play custom sounds when you gain a level</span>
- **<span style="color:#05dffa">Achievements</span><span style="color:#3598db">:</span>** <span style="color:#e67e23">Celebrate achievements with unique sounds</span>
- **<span style="color:#b96ad9">Quest Accept</span><span style="color:#3598db">:</span>** <span style="color:#e67e23">Custom sound when accepting quests</span>
- **<span style="color:#ff6b6b">Quest Complete</span><span style="color:#3598db">:</span>** <span style="color:#e67e23">Rewarding sounds for quest turn-ins</span>
- **<span style="color:#4ecdc4">Reputation Gains</span><span style="color:#3598db">:</span>** <span style="color:#e67e23">Audio feedback for reputation increases</span>
- **<span style="color:#2dc26b">Battle Pet Level-Up</span><span style="color:#3598db">:</span>** <span style="color:#e67e23">Special sounds for pet leveling (Retail only)</span>
- **<span style="color:#05dffa">Trading Post</span><span style="color:#3598db">:</span>** <span style="color:#e67e23">Completion sounds for activities (Retail only)</span>
- **<span style="color:#b96ad9">Honor Ranks</span><span style="color:#3598db">:</span>** <span style="color:#e67e23">Recognition for PvP progression (Retail only)</span>
- **<span style="color:#ff6b6b">Renown</span><span style="color:#3598db">:</span>** <span style="color:#e67e23">Sounds for renown reputation gains (Retail only)</span>
- **<span style="color:#4ecdc4">Delve Companion</span><span style="color:#3598db">:</span>** <span style="color:#e67e23">Level-up sounds for your companion (Retail only)</span>

### <span style="color:#4ecdc4">Sound System:</span>
**<span style="color:#05dffa">BLU uses a 3-tier sound system:</span>**

1. **<span style="color:#2dc26b">Default WoW Sounds</span><span style="color:#3598db">:</span>** <span style="color:#e67e23">Original game sounds (no volume control)</span>
2. **<span style="color:#05dffa">BLU Internal Sounds</span><span style="color:#3598db">:</span>** <span style="color:#e67e23">Custom sounds with 3 volume variants — High, Medium (default), Low</span>
3. **<span style="color:#b96ad9">External Sound Packs</span><span style="color:#3598db">:</span>** <span style="color:#e67e23">Auto-discovered from other loaded addons at startup. If `LibSharedMedia-3.0` is present, BLU also hooks into it. Devs can register packs via `BLU:RegisterExternalSoundPack()`</span>

### <span style="color:#4ecdc4">Sound Pack API (for addon developers):</span>
```lua
-- Register your sound pack directly with BLU
BLU:RegisterExternalSoundPack("My Pack Name", {
    { name = "My Sound", path = "Interface\\AddOns\\MyAddon\\sounds\\mysound.ogg" },
})
```

---

## <span style="color:#05dffa">🚀 Quick Start</span>

1. **<span style="color:#2dc26b">Install</span>** <span style="color:#05dffa">B</span><span style="color:#05dffa">L</span><span style="color:#05dffa">U</span> <span style="color:#e67e23">from your preferred platform</span>
2. **<span style="color:#4ecdc4">Launch</span>** <span style="color:#06c">World of Warcraft</span>
3. **<span style="color:#b96ad9">Type</span>** `/blu` <span style="color:#e67e23">to open the options panel</span>
4. **<span style="color:#ff6b6b">Choose</span>** <span style="color:#e67e23">your favorite sounds for each event</span>
5. **<span style="color:#05dffa">Enjoy</span>** <span style="color:#e67e23">your personalized WoW experience!</span>

---

## <span style="color:#05dffa">📋 Command Reference</span>

<span style="color:#e67e23">Use</span> <span style="color:#2dc26b">`/blu`</span> <span style="color:#e67e23">followed by</span><span style="color:#3598db">:</span>

<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 refresh` | Rebuild external and user custom sound pack registry |
| `/blu rescan` | Rescan for newly registered media |
| `/blu addcustom myfile` | Tries common AddOns folders and adds the first matching `.ogg`/`.mp3`/`.wav` |
| `/blu removecustom path` | Removes a previously added custom sound |

</div>

---

## <span style="color:#05dffa">📋 Compatibility</span>

<div align="center">

### <span style="color:#05dffa">🌍 Supported WoW Versions</span>

| WoW Version | Interface | Status |
|-------------|-----------|--------|
| **Midnight (Retail)** | `120001` | ✅ Fully Supported |

**<span style="color:#e67e23">Note</span><span style="color:#3598db">:</span>** <span style="color:#e67e23">For Classic support, use</span> [<span style="color:#05dffa">BLU Classic</span>](https://github.com/donniedice/BLU_Classic)<span style="color:#e67e23">.</span>

</div>

---

## <span style="color:#05dffa">📥 Installation</span>

1. **<span style="color:#2dc26b">Download</span>** <span style="color:#e67e23">from your preferred platform</span><span style="color:#3598db">:</span>
   - [<span style="color:#ff6b6b">CurseForge</span>](https://www.curseforge.com/wow/addons/blu-better-level-up)
   - [<span style="color:#b96ad9">Wago.io</span>](https://addons.wago.io/addons/blu)
   - [<span style="color:#4ecdc4">WoWInterface</span>](https://www.wowinterface.com/downloads/info26465-BLU-BetterLevelUp.html)
   - [<span style="color:#24292e">GitHub</span>](https://github.com/donniedice/BLU/releases)

2. **<span style="color:#4ecdc4">Extract</span>** <span style="color:#e67e23">to your</span> <span style="color:#06c">WoW</span> <span style="color:#e67e23">AddOns directory</span><span style="color:#3598db">:</span>
   - <span style="color:#e67e23">**Retail**: `World of Warcraft/_retail_/Interface/AddOns`</span>

3. **<span style="color:#b96ad9">Restart</span>** <span style="color:#06c">WoW</span> <span style="color:#e67e23">and enable in AddOns menu</span>

---

## <span style="color:#05dffa">🆕 What's New in v6.2.0</span>

<details>
<summary><strong><span style="color:#05dffa">🎉 Click to see the latest updates!</span></strong></summary>

### <span style="color:#4ecdc4">🆕 Latest Updates</span>
- <span style="color:#2dc26b">✅ **Expanded localization coverage**</span> <span style="color:#e67e23">— added new localized strings for module lifecycle messages and event debug output</span>
- <span style="color:#05dffa">✅ **Module debug cleanup**</span> <span style="color:#e67e23">— standardized debug messaging across Quest, Reputation, Battle Pet, Honor, Renown, Trading Post, Delve, and Housing</span>
- <span style="color:#ff6b6b">✅ **Improved debug consistency**</span> <span style="color:#e67e23">— aligned updated modules around profile-backed debug checks for more predictable in-game logging</span>

</details>

---

## <span style="color:#05dffa">🛠️ Configuration Tips</span>

<table width="100%">
<tr>
<td width="50%" valign="top">

### <span style="color:#4ecdc4">Recommended Settings:</span>
- **<span style="color:#2dc26b">Level-Up</span><span style="color:#3598db">:</span>** <span style="color:#e67e23">Final Fantasy, Pokemon, or Zelda for nostalgic feels</span>
- **<span style="color:#05dffa">Achievements</span><span style="color:#3598db">:</span>** <span style="color:#e67e23">Elden Ring for epic moments</span>
- **<span style="color:#b96ad9">Quests</span><span style="color:#3598db">:</span>** <span style="color:#e67e23">Skyrim or Witcher 3 for immersive RPG experience</span>
- **<span style="color:#ff6b6b">Reputation</span><span style="color:#3598db">:</span>** <span style="color:#e67e23">Warcraft 3 sounds to stay in the Warcraft universe</span>

</td>
<td width="50%" valign="top">

### <span style="color:#4ecdc4">Performance:</span>
- <span style="color:#e67e23">Use "Low" volume variants if you experience any audio delays</span>
- <span style="color:#e67e23">Debug mode can help identify issues with sound playback</span>
- <span style="color:#e67e23">All sounds are optimized `.ogg` files for minimal impact</span>

</td>
</tr>
</table>

---

## <span style="color:#05dffa">🐛 Known Issues</span>

- <span style="color:#e67e23">Double quest accept sound in Classic is a Blizzard bug, not BLU-related</span>
- <span style="color:#e67e23">Some sounds may have slight delays on first play (cached after first use)</span>

---

## <span style="color:#05dffa">🔧 Troubleshooting</span>

**<span style="color:#ff6b6b">No sound playing?</span>**
- <span style="color:#e67e23">Check that your in-game Master volume is not muted</span>

**<span style="color:#ff6b6b">Sound pack not showing up?</span>**
- <span style="color:#e67e23">Run</span> `/blu rescan` <span style="color:#e67e23">to re-discover newly registered media</span>
- <span style="color:#e67e23">Run</span> `/blu refresh` <span style="color:#e67e23">to rebuild the external and user custom sound pack registry</span>

**<span style="color:#ff6b6b">Still having trouble?</span>**
- <span style="color:#e67e23">Join our</span> [<span style="color:#7289da">Discord</span>](https://discord.gg/N7kdKAHVVF) <span style="color:#e67e23">for instant support</span>
- <span style="color:#e67e23">Open a</span> [<span style="color:#ff6b6b">GitHub Issue</span>](https://github.com/donniedice/BLU/issues)

---

## <span style="color:#05dffa">🤝 Contributing</span>

<span style="color:#e67e23">Contributions are welcome! Feel free to</span><span style="color:#3598db">:</span>
- <span style="color:#2dc26b">🐛 **Report bugs**</span> <span style="color:#e67e23">via</span> [<span style="color:#b96ad9">GitHub Issues</span>](https://github.com/donniedice/BLU/issues)
- <span style="color:#ff6b6b">💡 **Suggest features**</span> <span style="color:#e67e23">in our</span> [<span style="color:#7289da">Discord</span>](https://discord.gg/N7kdKAHVVF)
- <span style="color:#4ecdc4">🌍 **Help with translations**</span> <span style="color:#e67e23">for global players</span>
- <span style="color:#05dffa">🎵 **Suggest new game sounds**</span> <span style="color:#e67e23">to add to the library</span>
- <span style="color:#2dc26b">⭐ **Star the repository**</span> <span style="color:#e67e23">to show your support</span>

---

## <span style="color:#05dffa">📄 License</span>

<span style="color:#e67e23">This project is licensed under the</span> [<span style="color:#2dc26b">MIT License</span>](https://github.com/donniedice/BLU/blob/main/LICENSE)<span style="color:#e67e23">.</span>

---

<div align="center">

### <span style="color:#4ecdc4">🌟 Thank you for choosing </span> <span style="color:#8B1538">R</span><span style="color:#8B1538">G</span><span style="color:#8B1538">X</span> <span style="color:#4ecdc4">Mods! 🌟</span>

**<span style="color:#e67e23">Made with ❤️ by the</span> [<span style="color:#8B1538">R</span><span style="color:#7598b6">ealm</span><span style="color:#8B1538">G</span><span style="color:#8B1538">X</span>](https://realmgx.com) <span style="color:#05dffa">Community</span>**
**<span style="color:#2dc26b">Lead Developer</span><span style="color:#3598db">:</span>** [<span style="color:#b96ad9">DonnieDice</span>](https://github.com/donniedice)

_<span style="color:#e67e23">"Make every level count with sounds that matter!"</span>_

**<span style="color:#05dffa">⚠️ WARNING:</span>** <span style="color:#e67e23">May cause excessive nostalgia for your favorite games.</span>

<img src="https://raw.githubusercontent.com/donniedice/SimpleQuestPlates/main/images/kiwi.gif" alt="RealmGX Kiwi" width="80">

**<span style="color:#2dc26b">The Kiwi Says:</span>** <span style="color:#b96ad9">"Bwwiiiee."</span>

---

## Custom Sound Shortcuts

BLU still supports no-edit auto-detect for common numbered files like `custom01.ogg`, but you can now add arbitrary file names in game more easily.

Examples:

```text
/blu addcustom myfile
/blu addcustom myfile.ogg
/blu addcustom Interface\AddOns\myfile.ogg | My Custom Sound
```

If you only provide a short file name, BLU will try these common locations automatically:

- `Interface\AddOns\`
- `Interface\AddOns\sounds\`
- `Interface\AddOns\BLU\`
- `Interface\AddOns\BLU\sounds\`
- `Interface\AddOns\BLU\media\sounds\`

The first compatible `.ogg`, `.mp3`, or `.wav` match gets registered and appears under `User Custom Sounds` in the nested dropdown.

### <span style="color:#05dffa">Part of the RGX Mods Collection</span>

[<span style="color:#05dffa">BLU Classic</span>](https://github.com/donniedice/BLU_Classic) | [<span style="color:#9b59b6">CCU</span>](https://github.com/donniedice/CoordinationCloakUtility) | [<span style="color:#ffe568">FFLU</span>](https://github.com/donniedice/FFLU) | [<span style="color:#58be81">PetBuddy2</span>](https://github.com/donniedice/PetBuddy2) | [<span style="color:#e74c3c">RND</span>](https://github.com/donniedice/remove_nameplate_debuffs) | [<span style="color:#58be81">SQP</span>](https://github.com/donniedice/SimpleQuestPlates) | [<span style="color:#8B4513">SRLU</span>](https://github.com/donniedice/SRLU)

**<span style="color:#8B1538">🎮</span> <span style="color:#8B1538">R</span><span style="color:#8B1538">G</span><span style="color:#8B1538">X</span> <span style="color:#4ecdc4">Mods</span> <span style="color:#3598db">-</span> <span style="color:#e67e23">Powered by</span> [<span style="color:#8B1538">R</span><span style="color:#7598b6">ealm</span><span style="color:#8B1538">G</span><span style="color:#8B1538">X</span>](https://realmgx.com) <span style="color:#e67e23">Community</span>**

</div>
