BoomboxCartUpgrade

Adds a "Boombox" component into the cart with its own UI that plays video links as audio from the cart. Has volume and quality sliders as well to configure the music to your liking. One player can control the Boombox UI at any time, and everyone (with the mod installed) can hear the songs you play too!

Current websites you can play audio from:

• Youtube (Music)
• SoundCloud
• Rutube
• music.yandex
• Bilibili

Reach out to me (link at the end) for issues with any service listed here, or suggestions on adding new ones from these sites

Usage

Everyone in the lobby needs the mod to be able to hear the boombox. However, if someone does not have the mod, you will still be able to play together.

Incompatible with the original BoomBox mod. May cause crashes.

How to use mod:

1. Grab on to a cart
2. Press 'Y' on your keyboard (note: 'Y' is the default key - can be changed. Only one person can have the UI open at a time)
3. Paste in a video link for the music/video you want to play
4. Press 'Play', wait a moment for the video to download (longer videos may take longer), and audio should start playing!
5. To adjust config options ingame use something like REPOconfig

Known Issues:

• When the menu is opened you can still move and click through it
• A lot of browsers will not work for the downloader
• Singleplayer does NOT work at all. Clicking "Host Game" and playing solo works though!

Possible Future Features:

• Suggest some maybe!

Features

• Supports timestamps from YouTube (music) and Soundcloud embedded in the link. (Also has a config setting)
• Cookie passthrough
• Some cool visual effects: RGB underglow and a frequency visualiser

Issues

No audio

• Causes

  • Pressing the mute button (default key "M")
  • Outdated mod, or different version to the lobby host
  • The audio service you are downloading from does not support your region
  • An internal error of ffmpeg or yt-dl (dependencies)
  • Error when downloading dependencies

• Fixes

  • If you can view the game logs, they might provide some helpful information, e.g. a dependency download error, region block, etc.
  • Delete the BoomboxedCart located here: ../Steamlibrary/steamapps/common/REPO/BoomboxedCart or enable the flag in the config file (BepInEx/config/Doppelclick.BoomboxCartUpgrade.cfg - Debug - ReinstallResources: true) and launch the game
  • If your region is blocked, use a VPN server in e.g. America or Central Europe, or view the fixes for "Sign in to confirm you're not a bot"

"Sign in to confirm you're not a bot"

• Causes

  • YouTube does not like your ip :(
  • You have been flagged for "suspicious" activity

• Fixes

  • Use a different streaming service, e.g. Soundcloud - This is the easiest and most reliable fix
  • Head to the mod's settings and select a browser for Downloader - Browser: (NONE, chrome, firefox, edge, brave, safari) Please note: This will most likely not work, as a lot of browsers do not store your cookies in plain text anymore.
  • Alternatively: Extract your cookies to a file using an extension such as this. Then paste the path to the cookies file into Downloader - CustomCookiePath, such as C:\Users\Me\Downloads\cookies.txt
  • Please note. It is highly recommended to use a youtube account that is not your main for this, although it is highly unlikely, you may get it banned for botting. (Be signed into an alt account when extracting cookies, or while using the Browser)

• To enable the console window, head to your mod config directory, into the BepInEx config file and enable the console (BepInEx/config/BepInEx.cfg / Logging.Console / Enabled)

• Ideally also turn on log level Debug.

No fix found

Launch the game with the console enabled and send the log into the mod thread on the REPO Modding discord server

Credits

A HUGE thanks to @survivalq and their SemiBoombox Mod for critical funcionality for parts of this mod. If you're looking to make your own boombox mod or just play audio from a third-party, check their mod out, it is much better code!!!

Big thanks to all the members in the R.E.P.O Modding Server that report bugs and help me test new versions! This includes but not limited to: Dan, Dreepye, Vehzx, and Wiz!

Also big thanks to Dan for the incredible cover art. Go download his mods too!

This mod is based on PhilTec-Philip's BoomboxCartUpdate fork of the original BoomBoxCartMod by ColtG5

Contact

Feel free to reach out to me on in the repo modding community discord (https://discord.com/invite/vPJtKhYAFe) in this thread: https://discord.com/channels/1344557689979670578/1439361913933795489

Changelog

1.3.4

• Add cookie passthrough
• Add javascript dependency
• Add download timeout estimate
• Fix Song Info
• Rework packet system
• Sync visual effects

1.3.3

• Fix mod for latest REPO update
• Fix AutoResume
• Add ability to delete dependcies on startup, via config value
• Fix Resetting Boombox

1.3.2

• Improved Stability
• Underglow better!!!

1.3.1

• Non-MasterClient hotfix

1.3.0

• Add ffmpeg & yt-dl Updater
• Minimize log spam for players without the mod

1.2.9

• Fix Auto Resume
• Add a button to masterclient gui to reset cart data
• Fix some sync issues

1.2.8

• Fix Audio Download causing game to stutter (stream audio from storage instead of loading all instantly)
• Fix displayed value in gui for personal volume
• Change default audio volume to prevent TOO loud audio without every user setting their personal volume too

1.2.7

• Keep queue between levels (config options), as well as cart settings
• Fixed mute keybind
• Overhauled late join
• Fixed time bar
• Add Config option to hide Visualizer when music paused
• Please note: There may still be (minor) issues with syncing the queue betwen levels, especially time sync

1.2.6

• Fixed timestamps
• Fixed late join
• Fixed UI when there are multiple carts in the lobby

1.2.5

• Fixed playback on non-master-clients THANKS TO Omniscye
• Fixed some minor issues
• Better playback sync

1.2.4

• Added Global Mute Keybind
• Added Ability to dismiss queue, with config option to only allow the master client to do so
• Improved link handling, added support for youtube music links
• Added support for link timestamps (?t=42 or &t=42), with config option
• Should work now if not all players in the lobby have the mod

1.2.3

• Added Playback Queue instead of History
• Ensured that Playback time is synced between players
• Add time slider, play/pause
• Add setting: "Apply Quality Setting to Downloads"

1.2.2

• Fixed a bug where the Cart despawned when unchecked Checkbox for the Audio Visualizer
• Fixed a bug where the Visualizer Blocks didn't despawn when unchecked Checkbox for the Audio Visualizer
• Added a "Recently played" History (UI)

1.2.1

• Added an Audio Visualizer (+ UI Checkbox)

1.2.0

• Added functionality to Force Stop Downloads (+ UI Button)
• Added functionality to decide whether a Monster should hear the played audio or not (+ UI Checkbox)
• Added functionality to decide whether the current audio listening to should be looped or not (+ UI Checkbox)
• Added functionality to Mute or Unmute audio (Client only) (+ UI Checkbox)
• Added functionality to Fast-Forward and one for rewinding (10 seconds each click) (+ UI Button)
• Added functionality to toggle a Visual Effect on the Cart (+ UI Checkbox)
• Configurable Keybind for opening the Boombox UI (only with the REPOConfig Mod)
• Edited the position of the 'Close' Button and enlarged it
• Replaced broken Discord Link in the Readme Thanks to @philtec for Coding

1.1.1

Added GitHub link

1.1.0

• Important fix for incorrect timeout error
• Added support for more URL's than just youtube, see README for supported websites (probably more to come)
• Known issue: cannot recover from some timeouts. working on a fix

1.0.3

Fixed youtube videos with special characters in the title not able to be played

1.0.2

Minor tweaks to the boombox UI, updated youtube url validator for less false negatives

1.0.1

Fixed code which I think prevented upload

1.0.0

Initial release!