YourOwnPersonalBoombox

Required by all clients

Verified to work for v50

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 Drag and Drop method. See below to see how. Only a maximum of 15 boomboxes can be loaded currently.

Overview

Once you add a personal boombox from either a mod or from dragging and dropping files, you can purchase the boombox from the terminal shop. They are labeled with pb. They act like the normal boombox and will arrive from the item dropship like any normal item. However, they will only contain songs specified by the mod or folder.

If the boomboxes are just too loud, you can press the +/- keys to adjust their volume globally. You can also set the maximum possible volume of all boomboxes in the config.

For funsies, you can set the boombox to continue playing in the pocket. You can also set their battery charge to last the entire day, or just 30 seconds if you are into that. These settings are found in the config and are automatically synced by the host.

The Drag and Drop Method

This method is for people who can't create the.dll necessary to create a companion mod. You will be creating and sharing folders to your friends.

Once you download and install this mod, run Lethal Company once. This will create a Your Own Personal Boomboxes folder in the plugins folder. If you don't know how to find this folder, go to your r2modman application and open the settings tab. Look for the Browse profile folder option and click on that. From there, open the BepInEx folder then the plugins folder. The Your Own Personal Boomboxes folder should be there.

Inside the Your Own Personal Boomboxes folder is an EXAMPLE.zip file. Extract the contents into a new folder, and insert your music into that 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 boombox folders as you like.

If you intend to use these boomboxes in multiplayer, your friends MUST have these exact same folders and files. Otherwise very weird bugs will happen.

Folder Structure

Refer to this image for the folder structure. The boombox folders (the folder with just songs and such) MUST be in the plugins/Your Own Personal Boomboxes folder.

The folder's name does not matter. DO NOT edit data.json file's name.

The Create a Mod Method

This method is for people who are able to create the.dll necessary to create a companion mod. If that sounds intimidating, it mostly involves installing Visual Studios, copy and pasting the template code below, updating a few strings, and hitting the build button. Please use the first half of this tutorial as a reference.

You can copy and paste the template code from here. You need to reference PersonalBoombox.dll (along with the other.dll's) for the code to build correctly. The.dll can be found in the plugins/Alice-YourOwnPersonalBoombox folder after downloading this mod.

Here's an example mod if interested.

If you are using the template code, please update the following strings or values. These are found near the top.

%YOUR_MOD_NAME% -> YOUR_MOD_NAME

%YOUR_MOD_NAME_PLUGIN% -> YOUR_MOD_NAME_PLUGIN

YOUR_UNIQUE_GUID -> "YOUR_USERNAME.YOUR_MOD_NAME" // in this format "x.x"

YOUR_MOD_NAME -> "YOUR MOD NAME"

YOUR_VERSION -> "YOUR_MOD_VERSION" // in this format "x.x.x"

An example could be like

%YOUR_MOD_NAME% -> MyAmazingBoombox

%YOUR_MOD_NAME_PLUGIN% -> MyAmazingBoomboxPlugin

YOUR_UNIQUE_GUID -> "xXMadSnipezXx.MyAmazingBoomBox"

YOUR_MOD_NAME -> "My Amazing Boombox"

YOUR_VERSION -> "1.0.0"

Don't forget the "" for the last 3 strings. Also do not forget the. in the GUID and VERSION strings.

Folder Structure

Refer to this image for the folder structure. Inside the package folder (the folder with the.dll file, manifest.json file, etc.), create