This tutorial is for people who are having trouble inserting songs that require AddmusicM.
Download AddmusicM from here: Click
(It requires ActivePerl if you are inserting songs with the .pl file)
Step 1) There should be 3 folders in the AddmusicM folder (addmusicM_English, addmusicM_Japanese and FIRcon). As far as I know, addmusicM_English and addmusicM_Japanese, they both have the same function. Most people prefer using the English version because it has a .exe file that allows us to insert music without having to install ActivePerl. It's your decision to choose the language. Open the folder (addmusicM_English/addmusicM_Japanese).
Step 2) Open the folder named 'INIT'.
Step 3) Open the .asm file named 'INIT.asm'.
Step 4) Look for this line (It should be located at the top of the file):
!FreeRAM = $7EC100 ;$10バイト連続した空きRAMが必要
"$10バイト連続した空きRAMが必要" means you need an empty RAM address that is 10 bytes long. Of course, the address can be longer than 10 bytes. If you haven't patched anything that uses the address $7E:C100, you can just leave the default address as it is. It shouldn't cause your ROM to corrupt as long as the length of the RAM address you're using is longer (or equaled) than/to 10.
Step 5) Once you've finished setting the RAM address, it's time for you to patch the .asm file. There are quite a few ways to patch things into your ROM. Just use the method you prefer. Oh, and Don't forget to make a backup of your ROM before you patch the file!
Also, make sure your ROM has been expanded to at least 2MB (2,049kb). (Preferably 4MB)
For those who don't know/forgot how to patch INIT.asm:
1) Download xkas from here: Click
2) If you have a search bar on your task bar, type in 'cmd.exe' and the .exe file named 'cmd.exe' should appear in the results list. Right click on the file and click on copy.
If you don't have a search bar, go to 'My documents' -> OS (C) (The hard drive icon) -> WINDOWS -> System 32. 'cmd.exe' can be found in system 32 folder. Don't move 'cmd.exe' to another directory, though.
3) Paste the file in the INIT folder.
4) Copy xkas.exe, and paste it in the INIT folder.
4.5) Put your ROM in the INIT folder.
5) Double click 'cmd.exe' and type in the following:
xkas.exe INIT.asm <yourROMname>.smc
..and hit enter.
Replace <yourROMname> with the name of your ROM. (e.g.
smw.smc, bodywash.smc or muzak.smc e.t.c...)
6) The .asm file should be patched into your ROM now. If you open your ROM with an emulator at this point, it will do nothing, except it will leave you a message reading 'SPC700 STALL DETECTED'. Don't panic. This should be fixed after you insert songs to your ROM.
Step 6) Put your ROM in the folder where addmusicM(_English).pl (addmusicM_English.exe) is located.
Step 7) Put the music files (.txt) you want to insert in the folder named 'music'.
Step 8) Open up 'list.txt' and list all the .txt files you want to use in your hack.
A brief example of how to list the names:
Step 9) Run addmusicM.pl (addmusicM_English.pl/addmusicM_English.exe). Enter the name of your ROM. You don't have to put the extension (.smc).
Step 10) The program will then ask if you want to use the shortcut option. Just type anything and hit the enter key. If you don't do that, then the things on blist.txt and list.txt won't be inserted.
That is pretty much it!
;=======How to insert .brr samples=======;
Sometimes when you download an AddmusicM port from this site (or other SMW hacking sites), you will be seeing files with the extension '.brr'.
Inserting .brr samples is easy once you get the hang of it.
Step A) Put all .brr files in the folder named 'brr'.
Step B) Open 'blist.txt', and you will see a list of .brr names.
Step C) Now, open the .txt file you want to insert, and take a look at the header.
See those numbers highlighted in red?
Numbers in the header are based on the numbers listed in blist.txt
Here is an example of how to list .brr names in blist.txt:
If you already used the same numbers in blist.txt and another song, change the numbers to something else. (e.g.
Save the file (blist.txt) after you listed the .brr names.
Step D) Now run addmusicM(_English).pl (addmusicM_English.exe) and insert the song like what you did in the previous section.
Well, that is how you insert .brr samples.
I will proofread this again tomorrow morning. If I missed something/or was being vague, please let me know. Also, feel free to ask me any questions.
edit: Yeah, this one is important too now.