🎵 ShetcanWilly’s Battle Music — V1.1 Changelog

This update builds on the original release with quality-of-life features and more control — without breaking bindings, folder structure, or existing setups. Everything new is optional and toggleable.

✅ New in V1.1

Per-Type Volume Controls
You can now set separate volume levels for:

• General combat

• Elite / rare mobs

• Boss encounters

Turn bosses up, keep trash lower — simple and effective.

Scrollable Options Panel
The settings page now scrolls properly so nothing gets cut off and future options have room to grow. No more cramped layout.

Target Classification Toggle
Option to disable boss/elite detection entirely.
If turned off, the addon always uses General tracks (unless you manually test Elite/Boss). Good for players who want one consistent playlist.

Instance-Only Mode
Optional setting to only play combat music inside dungeons and raids.
Open-world questing can stay quiet if you prefer.

Minimum Gap Between Songs
Prevents rapid restarts during chain pulls by enforcing a user-set minimum time between track starts.

Repeat Protection Control
You can now adjust how many recently played tracks are remembered to avoid repeats — especially helpful for smaller music libraries.

On-Screen Track Popup (Optional)
Small center-screen message when a track starts (example: “Boss Track 2”). Lightweight and off by default.

Weighted Shuffle (Optional)
Elite and Boss playlists can use a smarter roll method to reduce obvious repeats without needing track metadata.

Spec-Based Folder Support (Optional)
Supports folders like:

If enabled, spec folders are used automatically.

Debug Path Mode
Shows the exact file path being played — useful for troubleshooting numbering or missing files.

🛠 Fixes

Victory fanfare no longer loops
The win track now plays once and stops correctly after combat instead of looping forever.

🔒 Stability & Compatibility

• No changes to Bindings.xml schema

• No keybind category issues introduced

• No taint / protected frame interaction

• Existing installs and settings remain compatible

📄 Updated Main Description (Human Tone Version)

Turn Combat Into Cinema

ShetcanWilly’s Battle Music plays your own music during combat and reacts to what you’re fighting, when combat starts and ends, and how close you are to danger.

It’s lightweight, taint-safe, and designed to stay out of Blizzard’s protected systems and your existing keybind setup.

No music is included — you bring your own tracks.

⚠️ Setup (Required)

To avoid copyright issues, this addon does not ship with music.
Add your own MP3 files here:

General Combat

Elite / Rare

Boss / Raid

Optional Sound Effects (Optional)

Place these in the main Music folder if you want them:

• win.mp3 — victory fanfare (Option to trigger only after boss fight).

• sting.mp3 — combat start hit

• scratch.mp3 — skip feedback sound

Addon works fine without them.

Features

• Automatic General / Elite / Boss music switching

• Low-health and stealth volume ducking

• Per-type volume controls

• Optional dungeon/raid-only mode

• Skip keybind support

• Built-in test buttons in the options panel