Van32's CombatMusic: Setup Instructions

IMPORTANT

Make sure you do all of this BEFORE you start World of Warcraft.

World of Warcraft only checks the file directory as it is started. Any new files added after the program is running, won't be found until you restart it. This won't cause any errors in the game. It just means your add on won't work until you restart.

Any instance of <WoWDir> is to be replaced with the on-disk path to your World of Warcraft directory.

Step 1: Initial Setup

Windows Vista/7 Specific steps

If you're not using Vista or 7, you can skip this step.

If you've got a shortcut to World of Warcraft on your desktop, right click on it, and click "Open File Location" near the top of the menu. This will bring you to where your WoW is currently stored.

Windows XP Specific Steps

If you're not using Windows XP, you can skip this step.

Navigate to your World of Warcraft install directory (Default is "C:\Program Files\World of Warcraft" for 32-bit systems.).

Macintosh Setup

I'm sorry, I can't help you here. Go buy a Windows machine?

Chances are you already know what you're doing... Follow the steps below to continue setting up the add on

Step 2: Creating the folders

Now that you're into your WoW directory: find the Interface folder, and open it.

The first step to setting up CombatMusic, is to create 3 folders. Right click in any of the white space in the window, and select from the New menu, "Folder". Do this three times. Now, name each folder, "Music", "Battles", and "Bosses" without the quotes.

Select the two new folders "Battles" and "Bosses" by holding CTRL and clicking each folder. Move those into the "Music" folder.

Open the Music Folder, and we'll continue from there.

Step 3: Adding your files

Now, that you're in "<WoWDir>\Interface\Music", you need to add your files.

We'll start by adding the "Game Over", "DING"(Optional), and "Fanfare" songs: Find the songs you want to use as these songs, and copy them into the "Music" folder. Take the song you want to use for the Game Over, and name it "GameOver". Take the song you want to use as your fanfare, and rename it "Victory". Lastly, take the song you want to hear when you level up, and rename it "DING". Make sure you don't change the file's extension! (The ".mp3" part!) Do make note, the extra DING file is optional. You do not need to use it if you don't want to. Should you choose to use it, see the section below on "Turning on the alternate level up fanfare"

Now for the songs it plays in Combat:

• For every song you want to be played in a normal battle: Copy it to your Battles folder.
• For every song you want to be played in a boss battle: Copy it into your Bosses folder.

Now, once you've done that, go into each folder, and rename the songs:

• For every song in the Battles folder, use the name "BattleX", replacing X with a counter, (i.e. 1, 2, 3, 4, 5), adding 1 for each new song in the folder, and starting at 1.
• For every song in the Bosses folder, use the name "BossY", replacing Y with a different counter, (i.e. 1, 2, 3, 4, 5), adding 1 for each new song in the folder, and starting at 1.

When you're done, you should have a directory structure exactly like the following: (This is the way the files should be stored!)

<WoWDIR>\Interface\
	AddOns\
		CombatMusic\
		<Your Other Addons> 
	Music\
		Battles\
			Battle1.mp3 
			Battle2.mp3 
			Battle3.mp3 
			... 
		Bosses\
			Boss1.mp3 
			Boss2.mp3 
			Boss3.mp3 
			... 
		GameOver.mp3 
		Victory.mp3
                DING.mp3

Now that that is done, you can start WoW!

The first thing you should do when you start World of Warcraft, is check to see what CombatMusic tells you when it starts:

CombatMusic: CombatMusic version 4.0 r277 loaded successfully! Use /cm help for command help.
CombatMusic: Configuration not found; setting default...
CombatMusic: BossList not found; setting default...

If you see those messages, (The version number and 'revision' (r<number>) may be different from this text.) then you've installed it correctly! Now, you can tell the add on how to behave! The first step, is to remember how many songs you put in the Battles, and Bosses folder (The ones you renamed, that is.) The simplest way to do this is to take biggest numbered song in the folder, and use it.

Let's do this then:

Use the numbers you got from each folder to fill in the blanks. "/cm battles X" and "/cm bosses Y", where X is the number of songs in the Battles folder, and Y is the number of songs in the bosses folder.

Once you've done that, go and find something to fight. If you don't hear any music, make sure your game sound is turned on. CombatMusic will handle volume level and music when it's running, but I do advise having Music turned on to make sure fading will work as intended.

Step 4: Optional Setup

Song Cooldowns

Song Cooldowns are particularly useful, as they keep CombatMusic from playing your really long victory fanfare repeatedly! You can change the coolodwns like this: (replace x and y with the length of the respective songs.)

/cm cooldowns gameover x
/cm cooldowns victory y

Turning on the alternate level up fanfare

If you chose to add the DING.mp3 file, in order to hear it, you'll need to tell CombatMusic that you have it. Use the command /cm useding on to tell it to use the DING.mp3 file instead of the regular Fanfare one.