JuninCsr-Boombox_Controller_Remastered icon

Boombox Controller Remastered

Play YouTube/SoundCloud links, searches, local music and modpack music on the boombox, synced for every player. Anti-earrape, vote skip, walkie relay, terminal commands.

Last updated 2 months ago
Total downloads 3619
Total rating 0 
Categories Mods Audio BepInEx Client-side Server-side Boombox Music AI Generated
Dependency string JuninCsr-Boombox_Controller_Remastered-2.1.0
Dependants 0 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2100 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2100

README

Boombox Controller Remastered

Play YouTube and SoundCloud links (videos or whole playlists) or your own music files on the boombox. Everyone with the mod hears the same song at the same time.

An unofficial continuation of Boombox Controller by Koder-Teh (MIT), which is no longer maintained. The download, audio and network code was rewritten from scratch.

It replaces the original and uses the same plugin ID on purpose: if both are installed, BepInEx loads only this one. Uninstall the original Boombox Controller and BoomboxSyncFix anyway to keep your profile clean. Your old config and local music folder keep working.

What's new in 2.1

  • Search by name: /bplay never gonna give you up or /bsearch <terms>.
  • /badd appends to the queue; /bpacks and /bpack <name> play music packs from your modpack in perfect sync.
  • Volume normalization against earrape, and vote-to-skip for groups.
  • Music relayed through walkie-talkies, commands in the ship terminal, beat-reactive boombox.
  • Brazilian Portuguese translation, optional LethalCompanyInputUtils and LethalConfig support.

Commands

Open the chat with / while holding or looking at a boombox.

Command What it does
/bplay <link or search> Play a YouTube/SoundCloud video, playlist, or the first YouTube result for a search
/bsearch <terms> Search YouTube by name
/badd <link or search> Add to the end of the queue
/bpacks, /bpack <name> List / play music packs from other mods
/blocal \[n|all] List or play files from your local music folder
/btime 1:30 Seek
/bskip, /btrack <n> Next track / jump to track n (may need a vote, see below)
/bqueue Show the queue
/bstop Stop and go back to vanilla music
/bvolume 0-100 Your own volume (also Page Up / Page Down)
/bcache \[clear] Show or clear the downloaded songs cache
/bhelp Help

Multiplayer

  • The host must have the mod. Without it, the mod still works but only you hear your music.
  • Everybody must use the same version of this mod.
  • Players without the mod just hear the vanilla boombox.
  • Only links and metadata are sent over the network; every player downloads the audio on their own PC.
  • Local files are never uploaded: others hear them only if they have the identical file.
  • Music packs installed through a modpack (BoomboxMusic folders) are identical for everyone, so they always play in sync.
  • With 3 or more players, skipping someone else's track needs a majority vote (RequireVoteToSkip). For public lobbies, also enable OnlyHostCanControl.
  • Ship terminal: type command box help.

First launch: external tools

On the first start the mod downloads these tools (~150 MB) into BepInEx/plugins/<this mod>/bin, in the background, from their official GitHub releases, verifying SHA-256 checksums when published:

  • yt-dlp — downloads the audio (self-updates once a day)
  • FFmpeg (yt-dlp build) — converts the audio
  • Deno — JavaScript runtime needed by yt-dlp for YouTube

Nothing is installed outside your mod profile. You can disable automatic downloads in the config (AutoDownloadTools, DownloadDeno) and place the files yourself.

Optional mods

Files and config

  • Config: Lethal Company/BoomboxController/boombox\_controller.cfg (language: Languages = en, ru or pt)
  • Local music: Lethal Company/BoomboxController/other/local (mp3, ogg, wav, m4a, flac, opus)
  • Only YouTube and SoundCloud are allowed by default (AllowedDomains), checked on your own PC for every track.

Troubleshooting

Problem Fix
HTTP 403 / Forbidden Delete bin/.yt-dlp-last-update and restart to force a yt-dlp update
"Sign in to confirm you're not a bot" Set CookiesFromBrowser = chrome (or firefox/edge) in the config
Only I hear the music The host needs the mod; everyone needs the same version
Antivirus flags yt-dlp.exe / deno.exe Known false positive; allow the bin folder

Please report issues with your full BepInEx/LogOutput.log.

Credits

Original mod and idea: Koder-Teh. This package is not affiliated with or endorsed by the original author. Licensed under MIT; the original copyright notice is kept in LICENSE.