Skip to content

DonnieDice/BLU

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

344 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

BLU | Better Level-Up!

RGX Mods - RealmGX Community Project

BLU Logo

BLU RGX Mods

๐ŸŒŸ Join the RealmGX Community - Gamers eXtreme! ๐ŸŒŸ

Discord

๐ŸŽต Experience level-up sounds from your favorite games in WoW! ๐ŸŽต

BLU is a 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 release GitHub stars GitHub forks GitHub issues GitHub license

GitHub last commit GitHub commit activity GitHub repo size

CurseForge Wago WoWInterface

WoW Retail Version

Features โ€ข Quick Start โ€ข Commands โ€ข Compatibility โ€ข Installation โ€ข Support


๐ŸŒŸ Join the RGX Mods Community!

๐Ÿ’ฌ RealmGX Discord - Your Gaming Home!

Join Discord

๐ŸŽฎ Realm Gamers eXtreme - Where WoW Enthusiasts Unite!

โœจ What awaits you in our Discord:

  • ๐Ÿ› ๏ธ Instant addon support from the RGX Mods team
  • ๐ŸŽฏ Feature requests and direct dev communication
  • ๐Ÿš€ Beta testing opportunities for new releases
  • ๐Ÿค Community of WoW players sharing tips and experiences
  • ๐Ÿ“ข First to know about new RGX Mods releases
  • ๐ŸŽ‰ Events, giveaways, and community activities
RealmGX Kiwi

โš ๏ธ WARNING: May cause excessive nostalgia for your favorite games.

The Kiwi Says: "Bwwiiiee."


๐Ÿ’– Support RGX Mods

Your support helps keep RGX Mods alive and constantly improving!

Donate Buy Me a Coffee
GitHub Sponsor Star

Every coffee helps fund new features and sound additions!


๐ŸŽฏ 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.

๐Ÿ”ฅ Why Choose BLU?

  • ๐ŸŽฎ 50+ Games: Iconic sounds from Final Fantasy, Zelda, Mario, Skyrim, and many more
  • ๐ŸŒŸ Sound Pack API: Addon devs can build BLU-compatible sound packs with 3-tier volume variants and register them directly with BLU
  • ๐Ÿ› ๏ธ Modular: Only load the feature modules you actually use
  • ๐ŸŽฏ No Dependencies: Auto-discovers sounds from other addons โ€” no libraries required
  • ๐Ÿ’ฌ Active Support: Join our Discord for instant help!

Note: For Classic WoW support, use BLU Classic.


โœจ Features

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 Add your own .ogg/.mp3/.wav files from the Sounds tab or with /blu addcustom
๐Ÿ”Œ Third-Party API Addon devs can register BLU-compatible packs via BLU:RegisterSoundPack() or bridge simple single-file 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

๐ŸŽต Available Game Sounds

๐ŸŽฎ 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

๐ŸŽฎ 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, Medium (default), Low
  3. External Sound Packs: Auto-discovered from other loaded addons at startup through BLU's native bridge/discovery system. Devs can register full BLU-compatible packs via BLU:RegisterSoundPack() or simple bridge packs via BLU:RegisterExternalSoundPack()

Sound Pack API (for addon developers):

For clear instructions on both supported pack types รขโ‚ฌโ€ simple single-file third-party packs and full BLU-compatible _low / _med / _high packs รขโ‚ฌโ€ see the Sounds Guidelines wiki.

-- Full BLU-compatible pack with low / medium / high variants
BLU:RegisterSoundPack("my_pack", "My Pack", {
    my_pack_victory = {
        name = "Victory",
        file = "Interface\\AddOns\\MyPack\\media\\sounds\\victory_med.ogg",
        category = "all",
        source = "BLU",
    },
})

The wiki covers both supported approaches: BLU:RegisterExternalSoundPack() for simple single-file third-party packs and BLU:RegisterSoundPack() for full BLU-compatible 3-volume packs.


๐Ÿš€ 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

Use /blu followed by:

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

๐Ÿ“‹ Compatibility

๐ŸŒ Supported WoW Versions

WoW Version Interface Status
Midnight (Retail) 120001 โœ… Fully Supported

Note: For Classic support, use BLU Classic.


๐Ÿ“ฅ Installation

  1. Download from your preferred platform:

  2. Extract to your WoW AddOns directory:

    • Retail: World of Warcraft/_retail_/Interface/AddOns
  3. Restart WoW and enable in AddOns menu


๐Ÿ†• What's New in v6.4.1

๐ŸŽ‰ Click to see the latest updates!

๐Ÿ†• Latest Updates

  • โœ… Sounds tab custom sound manager โ€” add, view, and remove user custom sounds directly from the dedicated User Custom Sounds column
  • โœ… Better shorthand custom sound resolution โ€” short names like test or water resolve more reliably to compatible .ogg, .mp3, or .wav files
  • โœ… Cleaner custom sound playback flow โ€” custom sound entries normalize earlier so UI, logs, and playback stay more consistent
  • โœ… Header and Sounds tab polish โ€” alignment, layout, and custom sound row sizing have been cleaned up across the updated options UI

๐Ÿ› ๏ธ Configuration Tips

Recommended Settings:

  • Level-Up: Final Fantasy, Pokemon, or Zelda for nostalgic feels
  • Achievements: Elden Ring 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 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 first use)

๐Ÿ”ง Troubleshooting

No sound playing?

  • Check that your in-game Master volume is not muted

Sound pack not showing up?

  • Run /blu rescan to re-discover newly registered media
  • Run /blu refresh to rebuild the external and user custom sound pack registry
  • If you're building your own pack or adding custom files, follow the Sounds Guidelines wiki for the current folder paths and registration examples

Still having trouble?


๐Ÿค Contributing

Contributions are welcome! Feel free to:

  • ๐Ÿ› Report bugs via GitHub Issues
  • ๐Ÿ’ก Suggest features in our Discord
  • ๐ŸŒ Help with translations for global players
  • ๐ŸŽต Suggest new game sounds to add to the library
  • โญ Star the repository to show your support

๐Ÿ“„ License

This project is licensed under the MIT License.


๐ŸŒŸ Thank you for choosing RGX Mods! ๐ŸŒŸ

Made with โค๏ธ by the RealmGX Community Lead Developer: DonnieDice

"Make every level count with sounds that matter!"

โš ๏ธ WARNING: May cause excessive nostalgia for your favorite games.

RealmGX Kiwi

The Kiwi Says: "Bwwiiiee."


Custom Sound Shortcuts

BLU still supports no-edit auto-detect for common numbered files like custom01.ogg, but the main user-friendly flow is now built into the Sounds tab.

Recommended in-game flow:

  • Open /blu
  • Go to the Sounds tab
  • Use the User Custom Sounds panel on the right
  • Click Add Custom Sound
  • Type a short name like myfile or myfile.ogg

BLU will try common AddOns locations automatically and add the first compatible match it finds.

You can also use slash commands if you prefer:

Examples:

/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 and in the Sounds tab manager list.


Part of the RGX Mods Collection

BLU Classic | CCU | FFLU | PetBuddy2 | RND | SQP | SRLU

RGX Mods - Powered by RealmGX Community

About

BLU | Better Level Up! Play sounds from other games when you Level Up, complete Trade Post Activities, or Gain Reputation!

Resources

Stars

Watchers

Forks

Contributors

Languages