SkullMod: How to Edit Music, Stages, and More!

SkullMod is a tool that lets you have custom game music, edit stages, and change around other tidbits. This guide teaches you how to use it!

Introduction

Want to test your modding mettle and change Skullgirls to your liking? Look no further; SkullMod allows you to edit music, stage textures, lighting, UI, and non-essential sprites with relative ease.

This guide will cover using SkullMod to create a "new" stage with altered music, textures, and lighting.

Preparation

Download SkullMod here[github.com].

For editing textures, I recommend using Photoshop CS6 or later as it has built-in DDS support (DDS being the format SG's textures are in). You can also use Paint.NET or GIMP with a DDS plugin, but I haven't tested these myself.

For editing audio I recommend Audacity, which you can download here[audacity.sourceforge.net]. You'll also need ffmpeg[ffmpeg.zeranoe.com] and a tool that automatically converts mp3 songs to a format usable by Skullgirls, which you can download here[skullgirls.com].

Unpacking

This is Maplecrest! It's the stage that we're gonna be working with for this guide. It's a bright and colorful stage, so let's turn a 180 and make it into a moody night stage; Slumbercrest!

Before anything else, we'll need to gain access to Maplecrest's texture files. Navigate to C:Program Files/Steam/steamapps/common/Skullgirls/data01, and you'll find a bunch of GFS files. These files comprise the bulk of Skullgirls' data, and they're what SkullMod is made to edit! Stage textures are kept in levels-textures.gfs, our first target. Let's dig in; it's time to open SkullMod.bat.

SkullMod can unpack GFS files so that you can view and edit their raw contents. Click gfsEdit, and select the Unpack tab. Drag levels-textures.gfs into the drag-and-drop box, and click Unpack. SkullMod will unpack the contents of levels-textures.gfs into a folder in the directory that levels-textures.gfs is located in.

You can do this with any GFS file, and it's the crucial first step to modding Skullgirls. Don't forget it!

If you need to pack folders back into GFS files to test anything, skip forward to Packing.

Stage Textures: DDS Files and Transparency

Now that we've unpacked levels-textures.gfs, we can edit Maplecrest's texture files. This guide will assume you're using Photoshop for the job, which has built-in support for the DDS files that Skullgirls uses.

Navigate into the levels-textures folder you just created until you come across a bunch of DDS files. These files are the textures for everything in every stage; floors, backdrops, skyboxes, NPCs, everything. Maplecrest's texture files are:

• maple.dds - The bulk of Maplecrest's scenery, skybox, some NPCs
  
• maple_npcs_pets_01.dds - Animal NPCs
  
• maple_npcs_pets_02.dds - More NPCs
  
• maple2.dds - Part of Maplecrest's road and grassy knoll
  
• maplecrest_anim_npcs_01.dds - The remainder of Maplecrest's NPCs

First off, we'll want to remove some of the NPCs. Why would they be hanging around at night?

Opening maplecrest_anim_npcs_01.dds, you'll see a typical spritesheet of various characters. We want these guys gone, so we'll need to make them appear as transparent ingame. DDS files make use of a special alpha channel to determine what appears as transparent; you can find the alpha channel on the Channels tab next to Layers. Making the alpha channel visible while the RGB channels are visible will cause areas that will appear as transparent to be bathed in red. If only the alpha channel is visible, visible areas will be white and transparent areas will be black. While the alpha channel is selected, you can paint over any parts of the texture you don't want to be visible ingame. We'll use this to remove all of Maplecrest's NPCs except for the stray animals.

You can paint over the alpha channel to remove any elements of a stage you don't want visible (props like the blimp in Rooftops, NPCs, etc). Be mindful of the consequences if you are dealing with props that may cover up undrawn patches of the stage!

Stage Textures: Your Own Personal Touch

Here's the part where everything relies on your creativity and artistic ability. With Photoshop, you can edit any aspect of a stage's textures as you please! There's a ton you can do with this that I can't possibly all cover here, but I can document the progression of Slumbercrest to give you a general idea.

After some trial and error, I replaced Maplecrest's sunny blue skybox with one that has a bright full moon in a dark black sky.







I've dimmed maple.dds to match the skybox, but half of the map is still bright because the grassy knoll's texture is located in maple2.dds. If you do any major lighting changes, make sure to do them across the board to avoid inconsistency.





All of Maplecrest is now uniformly dimmed and very gently tinted blue. Also removed the last few non-animal NPCs.








All assets except the skybox are further darkened.









Maplecrest is now a pretty convincing nighttime stage, but our characters are still bright as if the sun's beating down on them! This brings us to our next section...

Character Lighting

While stage lighting is baked into the textures, character lighting is dynamic. There's no texture you can change to dim the lights on your character; instead you'll have to edit a stage's character light values.

Unpack levels.gfs, and navigate through the resulting folder until you find a collection of folders and LVL files. For this guide we need to edit Maplecrest's lighting, so open up maple_crest_3d.lvl in a plaintext editor like Notepad.

You'll notice a line commented #ambient light, and the line below it will contain three sets of numbers, three digits each. These numbers control Maplecrest's ambient lighting; how bright the natural lighting of Maplecrest is, and how said lighting is tinted. The left number controls red light, the middle number controls green light, and the right number controls blue light. The lower the number, the less of that type of ambient light there is and vice versa.

For Slumbercrest, we'll want to tone the ambient lighting down across the board so the characters appear dimmer, and make sure there is slightly more blue lighting than red or green so the characters are tinted alongside the stage. As such:

• Red ambient lighting (left) is lowered from 243 to 155.
  
• Green ambient lighting (mid) is lowered from 247 to 155.
  
• Blue ambient lighting (right) is lowered from 225 to 170, making it the most prominent lighting coloration.

BEFORE:


AFTER:


Most stages have additional point light sources; you may need to experiment on a stage-by-stage basis to tune them to your liking. In this case, the point lights can be left alone.

When relighting a stage, remember this rule of thumb used by Lab Zero themselves: A character should be around 20% lighter than the stage they're on so they look like they belong on the stage, but without blending in too much.

Music

Slumbercrest might as well be done, but let's give it a custom music track for good measure (and for tutorial purposes)! I want to use the song on the right as Slumbercrest's music, so I obtained an MP3 of it to prepare for our next few steps.

Unpack music-win.gfs and navigate through the newly-created folder until you find a collection of WAV files. This is the music of Skullgirls, and it's time to replace it with your own! Before we can do that, however, you need to make sure the song you want is prepared for the task.

Open the ffmpeg folder you downloaded earlier, enter the bin subfolder, and copypaste ffmpeg.exe to the same folder that adpcmencode.exe and convert.bat are in; the files in the other package you downloaded. Copy the MP3 you want to use into this same folder, and rename it "input". Click convert.bat and the program should convert your song into a game-ready WAV. If you do not perform this step, your stage music will output as incredibly loud static.

Every stage in Skullgirls has two WAV files associated with it; one that contains the intro of the stage theme, and another that contains the looping segment that follows. If you're clever and have a song well-suited for the job, you can edit your song into two WAVs so the intro of a song seamlessly segues into an indefinitely-looping segment without the song ever having to start over. The song above isn't suited to this unfortunately, so we'll just have to replace both slots with the same WAV. I'll overwrite skull_maple_1.wav and skull_maple_2.wav with the above song in this manner.

We're ready to go! We just need to bundle everything up...

Packing

Whether you're all finished and ready to go or merely want to test your changes, you'll soon need to pack your folders back up into GFS files. SkullMod has us covered!

Open SkullMod.bat, click gfsEdit, and select the Pack tab. Choose Select Directory, find the directory you wish to pack, and navigate downwards until you reach the temp folder. Doubleclick on temp, and click Open to confirm. Name your output file appropriately, check Include directory name, make sure alignment is on none (unless editing characters-art-pt.gfs), and click Pack.

If all went well, you should now have a new file sitting next to your temp directory in whatever folder you packed. Make sure this file matches the name of the file you originally unpacked, give it a gfs extension, and place it in C:Program Files/Steam/steamapps/common/Skullgirls/data01.

Additional Info

While SkullMod is a very useful tool, its uses are limited by Skullgirls' design. Some GFS files are protected; if the game detects them as edited in any manner, it will immediately crash. Files protected in this manner include:

• All "characters" files
  
• dev.gfs
  
• ui.gfs

While these files may still be unpacked and viewed at your leisure, editing them is impossible and should not be attempted.

Closing

With SkullMod, we successfully transformed this:


Into this!



While Slumbercrest was far from an ambitious project, I hope this guide helps and encourages you to make something bigger and better. I'd like to thank 0xFAIL[skullgirls.com] for creating SkullMod, and Fizzxwizz[skullgirls.com] for inspiring me with the stages to your right.

I really want Skullgirls modding to take off, so if there's anything beneficial that you want added to this guide, tell me about it! Alternatively, if you were stumped at any part of this guide I'd want to know so I can fix it up.

Hope it helped!

[Viket & Yuumi]

What about unpack .art-pt ? like theres a palette option in the skull dot exe but nota single files say anything about it

[Arjen]

heya, any update on character modding? especially considering, you know.

[theruler]

It seems the mod now requires python. Here is the new link:
https://github.com/0xFAIL/SkullMod2/

[Kito Ballard]

Is there a new guide/mirror list with this out there? Would love to goof around with some ideas.

[Devyatyi9]

Snd-wav Repacker [drive.google.com]
Example:
SndWavRepacker.exe -unpack "path/file_name.snd-wav" "alternative_path/etc"

SndWavRepacker.exe -repack "path/file_name.snd-wav" "alternative_path/etc"

[AntiqueEye162]

How do you open GBS files within OtterUI?

[LESBIAN CHAMPION SUPREME]

great guide, though i have a quick question: is it possible to replace the announcer's voice lines and the individual sound effects, or would those fall under the protected .gf files?

[peripractico]

Hi, I am an illustrator with some free time, I am interested in trying my luck with the idea of creating mods, however my knowledge is very limited outside my area, I would love to speak with you to ask for some suggestions.

[Kaneis]

Managed to find some of the broken links in case anyone still wanted to do some music modding.

Game music conversion files [skullheart.com]

FFMPEG [www.gyan.dev] (under 'release,' I used the first link)

Skullmod [drive.google.com] (found by @MrXade in the comments, drag and drop your gfs files onto the respective .bat files)

Thanks for the guide.

[Devyatyi9]

By the way, *.gbs files is OtterUI binary format by Aonyx Software, that contains info about fonts, textures, sounds, messages, views (ui animations and triggers).
https://github.com/ppiecuch/OtterUI