Your Own Personal Boombox

An API to easily create your own personal boombox with your own songs that's separate from the in-game boombox.

To add your boombox, you can either create a mod or use the tried-and-true'd copy and paste method. See here for an example mod.

Only a maximum of 5 boomboxes can be loaded currently. You can edit the maximum volume of all boomboxes in the config.

Required by all clients.

Was not tested in multiplayer, but there is no reason why it shouldn't work (in theory).

Folder Structure

Refer to this image for the folder structure. The folder's name does not matter. DO NOT edit data.json file's name.

Copy and Paste Method

Attached to this mod is a zip file. Extract and insert your music into the folder. You can edit the data.json file to edit the boombox's properties. See below for what those are. You can create as many folders as you like.

After you are done, share all these folders to your friends. They must all have exact same files and folders.

data.json

Name refers to the boombox name. It does not have to be unique but it should be recognizable. The text's maximum length is 20.

Description refers to the text displayed by the terminal INFO command.

Price refers to boombox's cost in the terminal. The range is 0 to 1000.

Volume refers to the boombox's volume. The range is 0 to 1. A good starting value is 0.4 or 0.5 so you don't blow your friend's eardrum.

Red, blue, and green refers to the boombox's model RGB color in-game. You can find the RGB values of any color by a quick google search or even this site.

Current limitations, issues, and future features

Only a maximum of 5 boomboxes can be loaded currently. This will be increased to 20.

It currently only supports .mp3 files. This is just maximum laziness atm.

All music files are loaded in the intro screen, and very slowly too. This will be addressed somehow.

The boombox model recoloring is just tinting the in-game texture. As such, you cannot get a white boombox. This will be addressed.

The boombox item icon does not change color. This will be addressed.

There is no volume control in game. This will be added.

You can only configure prices in the data.json file. This will be addressed.

Contact

Any complaints or questions can be sent to my discord dms, ladyraphtalia at this discord https://discord.gg/M7aZKP9Qvc or https://discord.gg/lethal-company

1.1.0

Added decal support
Added debug button at the main menu
Speeded up the music loading
Added support for mods to override their boombox prices with configs

1.1.1

Increased the boombox limit to 10
Changed where the boombox files are read from
Some UI cleanup

1.2.0

Fixed a network bug caused indirectly by IntroTweaks
Item icons now match the model's colour

1.3.0

Increased the boombox limit to 15
Decals will now scale to fill the boombox's backside
Improved visuals of debug window

1.4.0

Added volume control
Added fun config options for the boombox's
Decals use the game's postprocessing effects

1.4.1

Fixed the netcode

1.4.2

Verified to work for v47

1.4.3

Verified to work for v50

1.4.4

Fixed visual bug with Terminal Formatter