megalon2d-CustomMusicMod icon


This mod allows you to add custom stage music, menu music, and victory themes!

Last updated 10 months ago
Total downloads 10524
Total rating 4 
Categories Mods
Dependency string megalon2d-CustomMusicMod-1.6.0
Dependants 12 other mods depend on this mod

This mod requires the following mods to function

BepInEx-BepInExPack_NASB-5.4.16 icon

BepInEx pack for Nickelodeon All-Star Brawl. Preconfigured and ready to use.

Preferred version: 5.4.16
Bobbie-JsonDotNet-12.0.3 icon

Json.NET is a popular high-performance JSON framework for .NET

Preferred version: 12.0.3


NASB Custom Music Mod

This mod allows you to add custom songs to each stage and menu in the game!



  • Added support for Jenny's stage "Tremorton Joyride"
  • When a custom song is played on Tremorton Joyride, that one song will play throughout the entire match
  • Fixed songs not loading (thanks DHNishi)
  • Added Jenny's character id. NO stage support yet.

🚀 Installation

Slime Mod Manager

Download the latest version of this mod from the Slime Mod Manager!

ℹ Usage

Folder structure

    ↳ CustomSongs
        ↳ Menus
            ↳ ArcadeMap
            ↳ LoseV1
        ↳ Stages
            ↳ CatDogs House
            ↳ Glove World
        ↳ Victory Themes
            ↳ Aang
            ↳ April

Place .wav, .ogg, or .mp3 files into the folder corresponding to the stage or menu you want to change.

For example, if you want to use a different song for the Jellyfish Fields stage, place the audio file in BepInEx\CustomSongs\Stages\Jellyfish Fields

If multiple audio files are in the same folder, one is randomly selected each time that stage / menu is loaded!

⟲ Loop points (optional)

To define a loop start and end point, create a JSON file in the same folder as your audio file, and give it the same name as your audio file.

A JSON file is just a regular text file, but instead of .txt it is .json

You may need to turn on file extensions on Windows to be able to see and edit the .json extension.

File structure example

    ↳ Jellyfish Fields
        ↳ Song1.wav
        ↳ Song1.json

JSON file contents

  "loopStartPointSec": "16.109",
  "loopEndPointSec": "62.215"

When 62.215 seconds have elapsed in the song, it will loop back to 16.109 seconds!

To find loop points in your song, you can use some free audio software like Audacity.

I would recommend using a DAW with more precise BPM / looping support, such as Reaper, Ableton Live, FL Studio, etc.

📝 Configuration

Run the game once with the mod installed to generate the config file:


Setting Possible Values Default Description
Use Default Songs true or false true Include the built-in songs when the mod is randomly selecting a song to play. However, character specific Victory Themes will always play, if available.
Skip OnlineMenu Music if Empty true or false true If no song files are found in the OnlineMenu folder, the online menu music will not play.

Simply edit this file in a text editor, and save it, then launch the game again.


"My .mp3 didn't work!"

I've had multiple people unable to load certain mp3 files.

If you've downloaded a file from a youtube downloader, such as, your file might actually be an .m4a disguised as a .mp3

Unity cannot load these (it seems).

Use a different converter, or convert to .ogg instead! Thanks.

"What happens if I have multiple songs in the same folder?"

The mod will randomly select a song to play each time that stage / menu / victory is loaded.

"Can I include the default songs in the random selection?"

Yes. You must enable the option in the config file. See Configuration above.

Available versions

Please note that the install buttons only work if you have compatible client software installed, such as the Thunderstore Mod Manager. Otherwise use the zip download links instead.

Upload date Version number Downloads Download link  
2022-5-16 1.6.0 1154 Version 1.6.0 Install
2022-5-13 1.5.4 309 Version 1.5.4 Install
2022-2-6 1.5.2 917 Version 1.5.2 Install
2021-12-9 1.5.1 862 Version 1.5.1 Install
2021-12-9 1.5.0 61 Version 1.5.0 Install
2021-10-25 1.4.1 2470 Version 1.4.1 Install
2021-10-22 1.4.0 675 Version 1.4.0 Install
2021-10-18 1.3.3 1521 Version 1.3.3 Install
2021-10-18 1.3.2 135 Version 1.3.2 Install
2021-10-17 1.3.1 478 Version 1.3.1 Install
2021-10-13 1.2.1 1614 Version 1.2.1 Install
2021-10-13 1.2.0 206 Version 1.2.0 Install
2021-10-12 1.1.0 122 Version 1.1.0 Install