A splash screen would be nice for showing users that the application has started. Right now it hangs in the background until the main window is up, and that isn't very user-friendly.

I love it so far, its by far one of the easiest tools I have used to date that does anything but edit a text document. However, the process is a bit different to how you describe and I end up with the palette failing to change.

To make a sheet for the game I had to:

1. Make a 16 colour palette for my character (Blaze) consisting of the BG colour first.
2. Import that in as a PNG to convert it to GBA colours.
3. Export that as a PNG.
4. Convert my sprites into the new colour palette.
5. Put the new GBA palette in the corner of the character's sheet (I was using Sonic)
6. Make the sheet as described.
7. Import that onto Sonic, then write to ROM.

Then I end up with this:
Left: In game
Right: In editor

The sprite imports flawlessly but the palette doesn't. I suppose this could be remedied using an older version where the palette swapping works (The one where you demo-ed Tails Doll) or changing the palette with another program.

But I am glad to finally get my hands on this and use it.

Possible false alarm, I tested it with Visual Boy Advance and it worked flawlessly, its probably something wrong with Retroarch.

Phi's palette is at 47AB78.
Robo's palette is at 47AB58.

The battlefields, as said on the SCHG, are done using two background layers - BG2 and BG3, with BG2 being the upper layer and BG3 being the lower layer. The walls are sprites drawn in after to create the '3D Battlefield' effect.

In the game's RAM, BG2 begins at 0600E000 and BG3 begins at 0600F000. The way the fields are set up is by numbering the tiles used on the ground. For instance, and using Green Hill Zone as an example, if we were to change the values 0600E600 from

to

then we could change this platform from

to

Which is all fine and dandy. The tile layouts of the maps are stored in the same exactly way they pop up in the RAM, too, so it's easy to find. For instance, the upper layer part of Green Hill Zone begins at 467478.

The issue with this, however, is how the game decides these platforms can be stood on. The walls aren't drawn in based on the position of the platforms or anything - I modified Green Hill Zone a bit to be sure - and the walls seem to be what make platforms able to be stood on. Without them, you just fall through any additions to the upper layer. I haven't the slightest idea how the game decides where to write in walls. As such, completely retooling maps is impossible right now.

You can totally fiddle with the tiles and make pretty elaborate texture hacks of already existing levels, though.

As anyone in the discord will know, Me, Glimmer and Blade have been working on finding every single effect that can be inputted into a certain bit of the ROM to change the effects of moves. Currently, we have 65 moves documented in this Google Sheet:

https://docs.google.com/spreadsheets/d/14zrFFsG9KxL9ny8wgZ4Mi5eYtOrIMSEWTkyDPINK8L4/edit?usp=sharing

As of now, the only areas we know we can insert it are the following:

• 539AC: Sonic Shockwave Move

~ Lavender

@Glimmericious created a nice tutorial that I'm copying here to archive. (Copying all of these images was very annoying because Google Docs makes it a hassle.)

Alright, so, to transfer music from one game to another, you’ll want to do a few things:

Export the tracks from the game you want to borrow a track from.

This one’s self-explanatory - just hit ‘export tracks’ while the track you wanna use is selected.

Check everything on the list and name them in 2 however you would like. I would recommend naming it something simple. $T is replaced by the track number and $P is replaced by the track’s pointer, so do what you gotta. After that:

It’s important to make sure that $I is included, as it shows what instrument you’ll be replacing in your voice table. The format I usually use is $I $T, for simplicity’s sake.

Now, on the target game…

Go to the track you’re replacing and import the tracks.

The tracks you exported will be where your ROM file is, which is lovely.

Use

To navigate to the folder where your rom is, and hit ‘OK’. Then, check off of the tracks you want to import, and hit ‘Import.’ Viola! Now your tracks from the song are imported, but you still need to import samples to make sure that your song sounds right.

Importing Samples

This is a bit less simple.

You’ll want to browse to where your samples are stored. How you stored them doesn’t matter that much - .raw, .s, .wav, et cetera. Once it’s selected, you’ll need free space to import it to. In Sonic Battle, you’ll find that FB0000 and beyond are free, so if you haven’t messed with anything, use that instead.

And then, Import. It will tell you what space is being occupied by the samples, and I suggest you keep track of it and which instrument is stored where. You don’t want to import your samples in places overlapping, and you definitely want to know where you stored everything for later.

You can only insert samples at the beginnings of lines. What that means is that if your sample is stored from, say, FB0000 to FB1432, you would have to import the next sample at FB1440.

Checking Instrument Use/The Voice Table

Beside every track, there’s a handy-dandy arrow. Click it to show more detailed information about the track.

There’s a lot of stuff here, but what you’re really worried about are the red numbers on the far left. Play the song for a moment, and those will change to something else -

These numbers are what instrument is playing. On your imported track, these numbers will be important, so pull up the Voice Table.

This is where keeping track of where each track is stored is important - go to the instrument shown that isn’t playing correctly. Change the Output Device to DirectSound, and change Address1 to where you stored your track earlier. For example, if Instrument 48 isn’t right, you will Import sample 48 and change Address1 to where you imported Sample 48 to. You’ll want to repeat this process for every instrument that plays.

Other Instruments

If the instrument is not a DirectSound, it doesn’t have a sample. So, instead, you’ll want to pull up the game you’re copying from again. Go the defective instrument in its Voice Table, and copy down the properties of the instrument.

This instrument has an Atk of 0, Dec of 0, Sus of 15 and Rel of 0. Copy everything down and head back to your other game. Copy the properties down, and you’re already done! Way fewer steps than with samples.

From a MIDI

This is a bit out of my territory, but I can try. You can use mid2agb to convert midis to tracks that Sappy can then use. You’ll want to Assemble the Song instead of something else, however.

That part’s simple. After that, you have to get the samples that the MIDI is using. I’m not sure how to do this, but Google does provide a few samples you could import and probably get something pretty similar. The process of importing the samples and changing the instruments to the new addresses should, theoretically, remain the same.

Character Voices

Character voices are also on instruments, so it’s pretty easy. Import the voice you want to use - although it has to be a .wav file - and repeat the process of finding the instrument and changing the Address1 of the instrument.

I used every version with the text editor feature, and each didn't work. I clicked the "Write to ROM" button after making edits, and nothing happens.

Whenever I import a spritesheet (After I initially succeeded, it now breaks.) it only imports a background colour. Typically just the light blue.

I have tried saving as a 16 bit bitmap, converting the entire image to the indexed palette to no avail. It is then unusable as the character is invisible.

Forcing me to convert the character I want to insert into the base pallette (In this case, sonics) then change the palette in SBHS

Glimmer found the attack offsets and here's everything we've found.

00053370 - Sonic Attack One
000533E8 - Sonic Attack Two
00053460 - Sonic Attack Three
000534E4 - Sonic Heavy
000535D8 - Sonic Upper
00053860 - Sonic Eagle Kick Thing
000538D0 - Aerial Kick Thing
00053940 - Sonic Ground Special Ball Thing
00053A58 - Sonic Air Special Shockwave Ball Thing
00053CCC - Sonic Ball Special Part 1
00053DA0 - Sonic Ball Special Part 2
00053DE8 - Sonic Ball Special Part 3

Here's a reference image for the values we're modifying.

Original: 05 00 27 00 01 00 25 00 02 00 26 00 42 00 00 10 04 00 F0 FF 43

53376 value	Description	Gif
25	Normal?
anything else?	Sets the attack type of the move to the attack type you last used.

5337F value	Description	Gif
10	Normal
01	Flickering?
11	Shifted forward
12	Shifted downward

Attack Type

Value at 0x53374	Description	Gif
01	Weak Hit
02	Heavy Hit
03	Heavy Hit Up
04	Weak Hit Up
05	Nothing (for projectile attacks?)
06	Weak Hit
07	Heavy Hit Down
08	Light Launch
09	Stun
0A	Hit Up
0B	Heavy Launch
0C	Some glitchy thing
0D	Hit Up
0E	Launch
0F	Hit Up

People want IPS patches very badly, so allowing users to export a spritesheet along with the IPS patch should help (or both in a zip) should help users on mobile.

I can't run 1.2 and 1.2.1 a java exception occured, but old version ok.

alright, so I've made a special list of goals for the project we can look around. If you could, you set this issue as some sorta of milestone.

Major Goals:

• Make every playable character sprite doable for customization
• Eggman and Phis can be edited
• Every character's stats can be changed
• Hitboxes and Hurtboxes can be edited
• Arena textures can be swapped
• Story dialogue can be edited

Minor Goals:

• Story Art can be altered
• Skill Cards stats can be changed
• Sprite canvas can be resized to it's possible max
• Effects sprites can be edited
• entire arenas can be changed
• event areas can be placed anywhere in Story Mode
• map graphics can be changed

Dream Goals:

• every graphic can be altered, from title to final credits
• option to add custom character/arena slots
• option to add custom chapters in Story Mode
• option to add custom Skill Cards
• option to add more custom Enemies and Boss characters beyond Phis and Eggman
• feats to push the game further than its former.

edited by Phase for formatting

Images in the ROM are (well, should be) LZ77 compressed. Being able to edit these images in the suite would awesome, as using more than one tool is always a hassle.

A good way to start this would be to figure out how UNLZ GBA finds the compressed images in the ROM (probably through a header or something).

Emerl has a billion colors that you can use to customize him with. This means there are a billion palettes that are modifiable, including character palettes, the original Emerl palette, multiplayer palettes, and copy palettes.

These are the character offsets.

0047AA18 - Sonic Color
0047AA38 - Tails Color
0047AA58 - Knuckles Color
0047AA78 - Shadow Color
0047AA98 - Rouge Color
0047AAB8 - Amy Color
0047AAD8 - Cream Color
0047ABF8 - Gamma Color
0047AB18 - Chaos Color
0047AB38 - Emerl Color