Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
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
BepInEx pack for Mono Unity games. Preconfigured and ready to use.
Preferred version: 5.4.2100README
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 upor/bsearch <terms>. /baddappends to the queue;/bpacksand/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 (
BoomboxMusicfolders) 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 enableOnlyHostCanControl. - 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
- LethalCompanyInputUtils: volume keys in Settings > Controls.
- LethalConfig: edit the options in game.
Files and config
- Config:
Lethal Company/BoomboxController/boombox\_controller.cfg(language:Languages = en,ruorpt) - 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.