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.
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. You can also add a decal.png file to give it some flare. See below for what those are. You can create as many folders as you like.
If you intend to use this mod in multiplayer, your friends must have these exact same folders and files. Otherwise very weird bugs will happen.
Refer to this image for the folder structure. The folder's name does not matter. DO NOT edit data.json file's name.
If you are using the copy and paste method, the folders with the songs and such MUST be in the Alice-YourOwnPersonalBoombox folder.
If you are making a mod, place these folders into a folder called plugins. See here to why.
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.
You can add a decal to the back of your boombox. In the same folder with the songs and data.json file, add a decal.png file. There is no size requirement but currently the picture will scale to a square. Support for other sizes will be added later.
In the main menu, there is a music note button in the top right. Clicking on that will give you a debug log. The boomboxes and songs loaded will be displayed, along with any errors.
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.
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.
An option to send a boombox and its songs through the network will be added.
Any complaints or questions can asked in this discord thread. You can also dm personally at this discord, LadyRaphtalia.