megalon2d-CustomMusicMod icon

CustomMusicMod

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

Last updated a week ago
Total downloads 9170
Total rating 4 
Categories Mods
Dependency string megalon2d-CustomMusicMod-1.6.0
Dependants 9 other mods depend on this mod

This mod requires the following mods to function

BepInEx-BepInExPack_NASB-5.4.16 icon
BepInEx-BepInExPack_NASB

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

Preferred version: 5.4.16
Bobbie-JsonDotNet-12.0.3 icon
Bobbie-JsonDotNet

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

Preferred version: 12.0.3

README

NASB Custom Music Mod

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

Changelog

v1.6.0

  • 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
v1.5.4
  • 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

BepInEx
    ↳ 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

Stages
    ↳ 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:

BepInEx\config\megalon.nick_custom_music_mod.cfg

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.

❔ FAQ

"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 ytmp3.cc, 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 295 Version 1.6.0 Install
2022-5-13 1.5.4 271 Version 1.5.4 Install
2022-2-6 1.5.2 872 Version 1.5.2 Install
2021-12-9 1.5.1 824 Version 1.5.1 Install
2021-12-9 1.5.0 21 Version 1.5.0 Install
2021-10-25 1.4.1 2431 Version 1.4.1 Install
2021-10-22 1.4.0 628 Version 1.4.0 Install
2021-10-18 1.3.3 1483 Version 1.3.3 Install
2021-10-18 1.3.2 90 Version 1.3.2 Install
2021-10-17 1.3.1 432 Version 1.3.1 Install
2021-10-13 1.2.1 1570 Version 1.2.1 Install
2021-10-13 1.2.0 168 Version 1.2.0 Install
2021-10-12 1.1.0 85 Version 1.1.0 Install