ShetcanWilly's Battle Music

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.

CurseForge: https://www.curseforge.com/wow/addons/shetcanwillys-battle-music