Custom Boombox Music Opus

v2.0.0·Updated 2025-12-16

Allows you to use your own music in the boombox. This fork adds Opus file/codec support. Does not require any "Fixer" mods. Will conflict with other Boombox mods.

About this mod Author’s original text

LC-Boombox / Custom Boombox Music (Now with Opus support!)

A fork of this mod by Steven that adds support for Opus (.opus) files.

It also adds native support for loading music files from Mods/Plugins and the Config folder so any fixer mods like this one are no longer needed.

What are Opus files?

Opus is a relatively new audio format (think MP3, WAV, OGG, etc.) that is designed to be very efficient and high quality. Many popular apps already quietly use it (like Discord), but Unity doesn't support it out of the box. This mod manually adds support for it when loading custom Boombox music.

Some benefits of using Opus files (and this mod) are:

  • Significantly better quality at smaller file sizes (even against MP3s)
  • Uses significantly less RAM/memory
  • Music no longer loops/ends early
  • "Fix" mods that work by copying files (doubling storage usage) are no longer needed
  • IDK I kind of just made this for my own music/modpack lol

Installing Songs

This mod supports loading songs from the following locations (double check the config)

  • Custom Songs/Boombox Music
  • plugins/*/Custom Songs
  • config/Custom Songs

It also adds an option to delete songs from Custom Songs/Boombox Music, just in case you used a fixer mod before (off by default).

Version 2

Version 2 adds an experimental method to load songs on-demand on separate threads. Enabling this functionality significantly reduces the game's memory usage and the amount of time it takes to load when joining a game. This experimental method can be found in the mod's config file (it is off by default).

Credits

  • This mod is mostly based off of the Custom Boombox Music by Steven
  • Opus is a fantastic free and open source audio codec that is used in this mod (and should be used by many others)
  • Concentus and Concentus.OggFile for their C# Opus decoder port, and also mainly for their Ogg file decoder.

Install & use Install: BepInEx plugin

  1. The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
  2. Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
  3. Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
  4. Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.

Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file.

Dependencies

Install these first, or the mod will not work:

BepInEx-BepInExPack

File & checksum

Filename
Custom_Boombox_Music_Opus-2.0.0.zip
File size
411.1 KiB