Troubleshooting Common Issues

Troubleshooting Common Issues

This page covers the most common BLU setup and playback problems.

---

BLU Does Not Show Up In WoW

Check:

• the folder is installed to World of Warcraft\_retail_\Interface\AddOns\BLU\
• BLU.toc is directly inside the BLU folder
• the addon is enabled on the character-select screen
• you are using the Retail client, not Classic

If you need Classic support, use BLU Classic.

---

BLU Loads But No Sound Plays

Check:

• BLU is enabled in the General tab
• the event module is enabled in the event tab
• your selected sound channel is not muted in WoW
• the selected event actually has a sound chosen
• Mute in instances or Mute in combat is not blocking playback

Use the Test button in the event tab to verify the selection directly.

---

Sound Pack Does Not Appear

Try:

/blu refresh
/blu rescan

Then verify:

• the other addon is enabled
• the pack paths point into Interface\AddOns\
• the pack is registered correctly if it is your own addon

For addon pack setup, see BLU Sound Pack Guide.

---

Custom Sound Does Not Resolve

If you add a custom sound and BLU cannot find it:

• try the base file name like myfile
• try the full file name like myfile.ogg
• try a full path beginning with Interface\AddOns\
• place the file in Interface\AddOns\BLU\user\sounds\

Supported formats:

• .ogg
• .mp3
• .wav

---

Wrong Volume Variant Plays

BLU's low, medium, and high switching only applies to BLU-native style packs that use:

name_low.ogg
name_med.ogg
name_high.ogg

and register through:

BLU:RegisterSoundPack(...)

If the pack uses BLU:RegisterExternalSoundPack(...), BLU plays the exact file that was registered.

---

UI Looks Out Of Date After Changes

Try:

• /reload
• reopen /blu
• run /blu refresh

If you changed sound pack files or registration code in another addon, a reload is usually the safest option.

---

Need More Help?

• Discord
• GitHub Issues