BigWigs - Encounter Music: Epic Music Pack

 

 

 

About The Project

This addon is an external music pack for BigWigs_EncounterMusic.

It is designed to stay simple and maintainable:

• It registers bundled epic tracks into the shared track registry.
• It supports user-added custom tracks through a generated Lua file.
• It keeps official tracks and custom tracks separated.
• It provides a lightweight Windows generation workflow for contributors and personal pack maintenance.

DMCA/Content notice: only include audio you are allowed to distribute or use. You are responsible for the rights to any custom audio added to this pack.

(back to top)

Features

• Registers Epic Music Pack tracks into BigWigs_EncounterMusic
• Load-on-demand companion addon
• Auto-generated CustomTracks.lua for user tracks
• GenerateMusicAutoList.bat launcher for Windows
• GenerateMusicAutoList.ps1 generator for scanning Music/custom/
• Optional music_overrides.csv for exact display names
• Optional artist_map.csv for artist code mapping

(back to top)

Requirements

• BigWigs
• BigWigs_EncounterMusic

(back to top)

Installation

Install the addon into your WoW AddOns folder:

World of Warcraft/_retail_/Interface/AddOns/BigWigs_EncounterMusic_EpicMusicPack

Make sure the core addon is also installed:

World of Warcraft/_retail_/Interface/AddOns/BigWigs_EncounterMusic

(back to top)

How it works

When this pack loads:

• CustomTracks.lua is loaded first
• Tracks.lua registers the official Epic Music Pack tracks
• Tracks.lua also registers generated custom tracks from BWGSEMP_CUSTOM_TRACKS
• all tracks become available in the BigWigs_EncounterMusic selector

This addon does not provide its own UI. Configuration happens through the main BigWigs_EncounterMusic addon.

(back to top)

Custom track workflow

To add custom tracks:

1. Put your .mp3 files inside Music/custom/
2. Run GenerateMusicAutoList.bat
3. Choose whether you want auto-guess enabled
4. If auto-guess is disabled, the script can prompt for Artist and Title
5. CustomTracks.lua is regenerated automatically
6. Launch the game or use /reload
7. Select the generated tracks in BigWigs Encounter Music

Related files:

• GenerateMusicAutoList.bat
• GenerateMusicAutoList.ps1
• CustomTracks.lua
• music_overrides.csv
• artist_map.csv
• MUSIC_ADDING_GUIDE.md

(back to top)

Music naming conventions

Recommended format:

EMP_<ArtistCodeOrName>_<Title_With_Underscores>.mp3

Also supported for better manual prompting and auto parsing:

Artist - Title.mp3
Artist_Name - Title.mp3

Notes:

• music_overrides.csv takes priority over auto-guess
• artist_map.csv is used when parsing artist codes such as RSM or ES
• for the Artist - Title format, artist underscores can be preserved

(back to top)

Architecture

Runtime files

• BigWigs_EncounterMusic_EpicMusicPack.toc
  • addon metadata
  • dependency declaration
  • load order for CustomTracks.lua and Tracks.lua
• Tracks.lua
  • official bundled tracks
  • registration helper
  • registration of generated custom tracks
• CustomTracks.lua
  • generated track table used at load time

Generation files

• GenerateMusicAutoList.ps1
  • scans Music/custom/
  • generates CustomTracks.lua
  • handles auto-guess, manual prompts, overrides, and artist mapping
• GenerateMusicAutoList.bat
  • convenience launcher for Windows
• music_overrides.csv
  • exact label overrides by filename key
• artist_map.csv
  • mappings for artist codes used by filename parsing

(back to top)

Notes for development

• Official pack tracks should stay in Tracks.lua
• Custom user tracks should live in Music/custom/
• CustomTracks.lua should be treated as generated output
• If you edit CustomTracks.lua manually, the generator may overwrite it
• The pack depends on BigWigs_EncounterMusic and should not duplicate core logic from the main addon

(back to top)

Troubleshooting

The tracks do not appear in game

Check that:

• BigWigs_EncounterMusic is installed and enabled
• BigWigs_EncounterMusic_EpicMusicPack is enabled
• the generated CustomTracks.lua file exists
• the audio files are present in the expected folder

Custom tracks are missing

Check that:

• your files are in Music/custom/
• you ran GenerateMusicAutoList.bat
• your filenames match the expected conventions
• your music_overrides.csv keys match the filename without extension

A track name is wrong

Check that:

• music_overrides.csv contains the correct key and label
• artist_map.csv contains the expected code mapping
• your filename uses either EMP_<Code>_<Title> or Artist - Title

(back to top)

Project structure

BigWigs_EncounterMusic_EpicMusicPack/
  BigWigs_EncounterMusic_EpicMusicPack.toc
  Tracks.lua
  CustomTracks.lua
  GenerateMusicAutoList.bat
  GenerateMusicAutoList.ps1
  MUSIC_ADDING_GUIDE.md
  artist_map.csv
  music_overrides.csv
  Music/
    custom/

(back to top)

Rights and content notice

Only use music you are legally allowed to include.

This addon is not affiliated with, endorsed by, or officially maintained by the BigWigs team.

All rights related to BigWigs, including its name, branding, and associated assets, belong to their respective owners.

If you distribute this pack publicly:

• verify the license of every bundled track
• keep attribution when required
• do not assume that user-added music is safe to redistribute

(back to top)