CodeEnder-Custom_Boombox_Fix icon

Custom Boombox Fix

Allows basic content mods to integrate with Custom Boombox Music

Last updated 5 months ago
Total downloads 1576694
Total rating 19 
Categories Audio Client-side Boombox Music
Dependency string CodeEnder-Custom_Boombox_Fix-1.2.5
Dependants 3248 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2100 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2100
Steven-Custom_Boombox_Music-1.4.0 icon
Steven-Custom_Boombox_Music

Allows you to use your own music in the boombox.

Preferred version: 1.4.0

README

CustomBoomboxFix

Workaround to allow music content mods to easily integrate with Custom Boombox Music.

Usage

(FOR ADVANCED USERS)

Creates plugins/Custom Songs directory and copies all folders inside plugins with name 'Custome Songs' into main custom boombox folder. Read decompiled code before use.

If you want to add some songs for personal use, just add the .mp3 / .wav / .ogg files to BepInEx/plugins/Custom Songs.
THIS WILL NOT SHARE WITH YOUR FRIENDS. If you want to share music with your friends, you either need to make a content mod or enable the share feature in the mod's configs.
You need permission from the creator to upload their music onto Thunderstore or to share music with friends!
Do NOT just violate copyright.

To create your own content mod, follow the guide How to Create an Asset Replacement Mod.

To learn more about "share songs via configs", please read the guide Sharing Music via Configs.

Enabling the "share feature" will create a new configs/Custom Songs directory where you can put your music. The mod will handle the songs/folders in this directory the same way as the ones in the plugin directory. If you use this feature, simply sharing your Thunderstore profile code/file will now share the music you put in there too!
WARNING: Sharing songs via profile code has a size limit of 20MB! If you plan on using a lot of songs that way, you'll have to share your profile file!

CLIENT SIDE MOD. Everyone needs to have it and the same music installed if you want everyone to listen to the same music.
To fix music not being synced you can add mods like FutureSavior's Boombox Sync Fix.

FAQ

I can't hear the music

Your files might not work, verify that they actually play music before installing them.

It's only playing the default songs

You likely didn't put the songs in the right folder. If you encounter this issue making a content mod, verify that your .zip file structure looks like this:

If you use personal music, you might have selected the wrong config and put your music in the wrong place

  • useStandardMethod = music should be in plugins/Custom Songs (also here if you haven't changed any configs)
  • useConfigShareMethod = music should be in configs/Custom Songs

Where did the default songs go?

If you want to bring the default songs back, you'll have to go into the config of the parent mod Custom Boombox Music.

My friends can't hear the music

They need this mod installed too, as well as your content mod.

My friends all hear different songs

Due to how Custom Boombox Music works, everyone needs to have the exact same songs installed for the boombox to be synced.
However, if this is the case and there are still problems, you can add mods like FutureSavior's Boombox Sync Fix to fix the issue.

Support

This mod has been verified to be working correctly. Questions that can be answered by reading the available material will be ignored. If you still think you have a question, contact me on discord.

Credits

Mod created by CodeEnder.
v1.2.5 by Inoyu.

Custom Boombox Music created by Steven.