Audio Modding Overview

Modding MMXOD audio generally doesn't require many tools. The only one that's recommended is an audio file editing tool like Audacity (you can download this tool for free online). Aside from that everything is just done in the file system, as MMXOD audio modding was designed to not require any special tools or separate text files; everything is done via dot delimited file extensions.

There are three types of audio in MMXOD: sounds, music and voices. Each one uses a separate system so it's important to understand the differences and consult the right section for the right steps.

If on Windows, before starting to mod sounds, it's highly recommended to change the folder properties of any folder with audio files. Right click the folder, go to the Customize tab, and under "Optimize this folder for", select "General items" if it's not already selected. This will stop Windows Explorer from trying to enumerate track data for each audio file which takes forever when opening large audio folders. Be sure to do it on the root folder that encompasses all the audio and select the "Also apply this template to all subfolders" checkbox to recursively apply the setting to all subfolders. (Note, behind the scenes this will place a hidden desktop.ini file in the folder.)

Sound Mods

The assets\sounds folder contains the in-game sounds, and are further organized by character folder. Any of these existing sounds can be replaced with new sounds to change them in the game.

You can't add or remove sounds in this folder or any subfolders without changing the game's checksum version, which would force others to do the same edits you did to play in the same matches you host. So don't do that. You shouldn't need to, anyway as there's no use. If you need to make a sound silent, you can use a tool like Audacity and edit the sound file itself.

Sounds in this folder must either be .wav or .ogg. If a sound is too big, or improperly formatted, it might not work. Opening in Audacity and exporting as .wav or .ogg could fix things. Also note, a sound must have a length greater than 0 seconds or the game will error out, so if you make a sound silent you need to add at least a small period of silence in the track.

There are some sounds you might want to be specific to a character, but are shared by multiple characters. For example, you may want a unique jump sound for a certain character. This is possible via the assets\sounds_overrides folder. Create an override sound file with the same base name in this folder, but add the character id string before .ogg in the file extension, for example jump.zero.ogg. This tells the engine that when playing this sound for the character, it'll use the character-specific override instead of the shared sound. Note this won't work for all sounds, only ones the game engine plays at the character's position.

The character id strings are mmx, zero, vile, axl and sigma (note, Maverick sounds are all shared by sigma).

You can also leverage assets\sounds_overrides for overriding sounds globally (not specific to a character). Just exclude the character in the file extension, i.e. jump.ogg. This has the same effect as simply replacing the file in assets\sounds and is simply a cleaner method. Note that files in assets\sounds_overrides don't need to match the folder structure in assets\sounds, as all overrides are done on file names (for this reason, you can't have duplicate sound files in assets\sounds or the game will error out.)

NOTE: character voices are a special type of sound and you should not follow the above steps for them. See the Voice Mods section below, as they have separate steps due to the unique characteristics of voice lines.

Music Mods

All music (except custom map music) is in the assets\music folder. The format must be ogg. To loop the music, the file name should end with .[START TIME].[END TIME].ogg where the start and end times are decimal numbers in seconds, representing the point in the track in which to loop. Note, you need to use comma for the decimal point. For example, highway.44,44.87,463.ogg tells the game to start looping at 44,44 seconds in go back to the start loop position at 87,463 seconds (for people in the US, UK and other locales that use dot for decimal, this is 44.44 seconds - 87.463 seconds.) Look at any music file for an example. Note that you'll need to configure Windows Explorer to show file name extensions, if you have not already, or else you won't be able to access the dots after the file name (for how to do this, just google the steps, it's pretty standard).

This same format for music looping is used by every music file, regardless of location. Custom maps use it, too.

The format can also be extended even further, if you want a version of a music that plays for a specific character only. Here's the extended format: .[START TIME].[END TIME].[mmx|zero|vile|axl|sigma].ogg. For example, adding a file called highway.7,017.106,772.vile.ogg to the music folder will tell the game to play this music file with the specified looping (start at 7,017 seconds and end at 106,772 seconds) on the highway stage if Vile is selected. You'll need to keep the original highway music file or else the game will error out if not Vile.

Voice Mods

Voices are the most complex audio type, so read carefully to get all the details. Be sure to download the official voice pack from the bonuses section of this website so you can follow along.

A "voice" is simply a special sound file that is interpreted differently by the game engine. The file type is the same as a regular sound and follows the same rules: only wav/ogg, etc. But voices are treated specially by the game engine. For example, only one of them can play at a time per character, and there are rules and overrides when a voice can interrupt another voice.

Voices are placed in the assets\voices folder. In the official voice pack, if you open the voices folder you'll see folders for each character. However you'll also see a ".v50" at the end of some of the character folders. This tells the game to reduce the volume by 50% for all sounds in this folder, a huge time-saving feature to properly normalize voice volumes. This format can also be applied directly to voice audio files as well.

Open the X folder. You will find a bunch of wav and ogg sounds, with a bunch of differing file extension formats. In general, here's the extension format:

[NAME].[ID].[w|s|v[VOLUME PERCENT]|mmx|zero|vile|axl|sigma]

If you want a sound with a certain time delay before playing, you will need to edit the voice file and add in silence in the beginning. Zero's Raijingeki voice clip is an example of this in action.

There isn't a system right now to re-use a voice clip for multiple different animations without copy-pasting the clip. This could get really complicated and the sound system was meant to be simple and not require tools or separate txt files.