Tool: M4A build in assembler (Music)

I think everyone who already hacked music knows that the "main" tool Sappy is very buggy and some of them are really nasty.

So I thought about making my own tool and now I want to present it to you.
I think you also should know Sappy's button "Assemble song". My tool actually does exactly the same job than this function but it doesn't "destroy" your ROM and it has also compatiblity to 32MB ROMs.
*UPDATE* the tools now also deletes the old song!

This tool should work for all games that are using the M4A engine (also called sappy engine).
I already tried out Wario Land 4, Golden Sun, Kirby NID, and of course Pokemon.

So let's have a look to the GUI:


The steps how to insert a song:
1. Make sure the "MPlayDef.s" library is placed in the same folder than the program.
2. Selcect your mid2agb output (.s file) and your ROM.
3. Type in the track group. Huh, I think you even don't know what it is. Which values you have insert here depends on the game you are using and on the type of song. So if you're using Pokemon games insert "0" for normal song, "1" for a sound effect and "2" for a fanfare and "3" for sound map sound efect (like rain).
4. Type in the songpointer offset. The songpointer is an entry of the songlist and it is needed to change the songpointer that it'll point to your new song. The songpointer is calculated like this:
I will post the songlist offsets of Pokemon games below.
5. Just type in an offset of free space (it has to be word aligned).
6. Specify your soundbank/voicegroup
7. Define the "delete byte". The tool will fill the area of the old song with this byte.
8. Than click on "build in this song" and you will finally have a new sequence build in the ROM.

Just note that there are ways to make the program crash or even the song you'll insert:
-The input file is not an mid2agb output or the song syntax is not correct.
-You don't have write access to the programs folder (it will store temporary files there).

Also note that I won't bring out any updates for this toll because it does its job and I'm working on a new uitility that will be a little bit more blind user firendly than this one and will also contain diffrent functions like a music player and such or maybe an instrument set editor.

You can donwload the program from the file attatchment.
It should work on any OS that supports .NET 3.5 ( I used VC# 2008)

So now here are the offset of the songlists:
BPRE: 0x4A32CC
BPGE: 0x4A2BA8
AXVE: 0x45548C
AXPE: 0x4554E8
BPEE: 0x6B49F0
BPRD: 0x4A18F0
AXVD: 0x463428
BPED: 0x6C5BDC

So I hope you'll enjoy the tool!

PS: Greetings from Germany ;)

Great, excellent! I am so glad we've finally gotten a better music assembler than what Sappy has. Sappy is rather unstable and can crash easily (and crash with certain loop points while testing out the song) and can only support a few .gba ROMs. I'm also looking forward to seeing a sound testing function on it so that anyone can test out their new song that they've inserted and being able to play every single soundbank in the ROM. Sappy could not support every single soundbank and some of them got replaced with simple beeps while testing out a song.

I would also like to suggest having a function that can edit the soundbank possitions and offsets and if there isn't a tool where you can convert a .wav file to a soundbank, then there should be a function in this tool to do so, that way anyone can record and convert their .wav to a soundbank. ;)

I'm a noob, so few questions if you don't mind.

1) 1. Make sure the "MPlayDef.s" library is placed in the same folder than the program.

What is this? I don't understand / I don't have a MPlayDef.s library? Where or how do I create one?

2) 6. Specify your soundbank/voicegroup

What is this? Is there a list of these anywhere? Or a method of locating them?

Thanks. All I wanna do is change a Pokémon battle theme x__X How difficult does this need to be D: I tried Sappy but it hates me.

Thanks so much, actually managed to get a song imported now.

One thing I can't figure out (my sappy doesn't work), could someone tell me the soundbank offset for the wild battle theme in pokemon ruby?

Appreciated.

It Does not Work for me. When i open a Rom or S.file i get an annoying error

I have a problem. If I press "build in this song" it simply does nothing.

@ruup20:

Tell me exactly what you've done and can you upload your .s file?

@WrathOfArceus:

What kind of error message do you get?
Are all your offsets word aligned?

@ilovecrumpe:

You may tiy out the old Version of Sappy (2005), or the MIDI only version (1.6).
Sappy 2005: http://www.megaupload.com/?d=UYUJRP62
Sappy 1.6 (midi only): http://www.megaupload.com/?d=45LLIDH8

I just did what I had to do and nothing worked.

My error says Unhandled Exception has occurred in your application

okay now it just freeze... Or it just take much time to load.

@ruup20:

I'm sorry, the version I uploaded was out of date and didn't worked with .s with only 1 track.

I now uploaded a newer version!

@WrathOfArceus:
Can you give me your .s file or even tell me what kind of Unhandled Exception occurred (click on the details button).

And how do I put it in a town/route?

Full Metal said:

@ipatix - what language is this written in?

Click to expand...

Visual C# 2008 (.NET 3.5)

Okay, so I loaded my ROM, loaded my .s file, put in the Song Pointer, the track data, and the soundbank offset. When I clicked assemble, I got the Unhandled Exception error, but I pressed continue, and the log continued to work. But then it got stuck on "Getting lengths of tracks". What did I do wrong?