Hypercat music mod

Required by all clients.

New fun config options added.

Your Own Personal Boombox

Chuub

This is for me and my friends and contains my music taste

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

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

Creating a boombox mod using this library mostly involves installing Visual Studios, copy and pasting the template code below, updating a few strings, and hitting the build button. The full steps should be easily found by googling.

See here for an example mod. You can copy and paste the template code from here.

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 a plugins folder.

From either the example mod OR the BepInEx/plugins/Your Own Personal Boomboxes folder, find the EXAMPLE.zip file. Extract its contents into a new folder inside the plugins folder. Insert your music into the newly created boombox 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.

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

If you want to know why we have to create a plugins folder, see here to why.

data.json

Name refers to the boombox name. It does not have to b