Description
ShetcanWilly’s Battle Music replaces World of Warcraft’s default combat music with your own customizable soundtrack. Every battle can trigger a random track from your music library, with support for general combat, elites, and boss encounters.
The addon is designed to be lightweight, highly configurable, and completely driven by your own music collection.
--------------------------------------------------
FEATURES
Random Combat Music
• Plays a random track from your music library when combat begins
• The track continues playing until combat fully ends
Separate Music Pools
Supports different music pools for different encounter types:
• General Combat
• Elite Enemies
• Boss Encounters
Each category can have its own track count and volume level.
--------------------------------------------------
Manual Track Skip
A keybind allows you to skip to a new random track at any time.
Useful if:
• A song doesn’t fit the fight
• You want something heavier for a big pull
• You simply want variety
--------------------------------------------------
Combat Start Sting
Optional combat start sting sound that plays when entering combat.
You can use either:
Single file:
sting.mp3
Or a pack of files:
sting1.mp3
sting2.mp3
sting3.mp3
The addon will randomly select one.
--------------------------------------------------
Combat End Sound (Accessibility Feature)
Optional combat end cue that plays when leaving combat.
This feature was added based on feedback from players who wanted a clear audible indicator when combat ends.
Single sound:
end.mp3
Or sound pack:
end1.mp3
end2.mp3
end3.mp3
--------------------------------------------------
Victory Fanfare
Optional victory sound after longer fights.
This plays when combat ends after the minimum combat time threshold.
--------------------------------------------------
Health-Based Music Ducking
If your health drops below a configurable threshold the addon will:
• temporarily lower the music volume
• restore the volume when your health recovers
This helps emphasize dangerous moments in combat.
--------------------------------------------------
Stealth Audio Behavior
When entering stealth:
• combat music volume can automatically drop
• volume restores when stealth ends
--------------------------------------------------
Spec-Based Music (Optional)
Music can optionally be organized by specialization.
Example folder structure:
Boss\Fury\
Boss\Protection\
Boss\Arms\
The addon will attempt to play spec-specific tracks if available.
--------------------------------------------------
Weighted Shuffle
Optional weighted randomization that reduces track repetition.
--------------------------------------------------
Anti-Repeat History System
Previously played tracks are remembered so the addon avoids repeating songs too frequently.
--------------------------------------------------
Track Toast Notifications
Optional UI message showing which track started playing.
Example:
Boss Track 3
Elite Track 2
General Track 12
--------------------------------------------------
MUSIC LIBRARY LOCATION (IMPORTANT)
The addon now uses an EXTERNAL music library folder by default.
This prevents addon updates from deleting or overwriting your music files.
Place your music here:
World of Warcraft\_retail_\Interface\Music\Battles\SCWBM\
--------------------------------------------------
FOLDER STRUCTURE
Example:
Interface
└ Music
└ Battles
└ SCWBM
├ 1.mp3
├ 2.mp3
├ 3.mp3
├ Elite
│ ├ 1.mp3
│ ├ 2.mp3
├ Boss
│ ├ 1.mp3
│ ├ 2.mp3
--------------------------------------------------
FILE NAMING RULES
Tracks must be numbered sequentially.
General Combat
1.mp3
2.mp3
3.mp3
Elite
Elite\1.mp3
Elite\2.mp3
Boss
Boss\1.mp3
Boss\2.mp3
The addon will randomly select from these numbered files.
--------------------------------------------------
SLASH COMMANDS
/scwbm help
Shows command list
/scwbm next
Skip to the next track
/scwbm stop
Stop current music
/scwbm test gen
/scwbm test elite
/scwbm test boss
Test different track types
--------------------------------------------------
KEYBIND
The addon includes a keybind:
Play / Skip Combat Song
This allows you to instantly skip to another random track during combat.
--------------------------------------------------
WHY THE EXTERNAL MUSIC FOLDER?
Earlier versions placed music inside the addon directory.
When the addon updated, players could lose their music files.
Using the external folder ensures:
• Music is never overwritten by addon updates
• Easy to manage large music libraries
• Works the same way as other combat music addons
--------------------------------------------------
FINAL NOTES
This addon is meant to give you complete control over your combat soundtrack.
Whether you want:
• orchestral boss themes
• metal battle music
• classic RPG combat tracks
• or something completely ridiculous
you decide what plays when the fight starts.