YPlayBoombox

Description

YPlay allows you to play YouTube audio on your boombox from a YouTube URL and allows you to pause and resume your music.

Everyone in the lobby can have their own personal music playing at the same time, which means no more fighting for control of the boombox!

All actions are networked including volume control.

DISCLAIMER: This mod has not been field-tested, there may be bugs or it may not work as intended, if you come across any bugs you can get in touch by reading the Wiki and I will do my best to address it. There will also be sync issues if a player joins and leaves the lobby, as long as everyone is on when the link is entered you should all hear the same thing - you can enter the same link again if you want them to resync with everyone else.

Installation

• All players should have this installed to hear the music.
• Disable/uninstall other boombox mods as they may interfere.
• Install using a compatible mod manager i.e. r2modman/thunderstore or place the YPlay folder into your BepInEx/plugins folder.

Chat commands

Open the chatbox with the '/' key

Load music (while holding or looking at another boombox)
/yplay YOUTUBE_URL
/yplay https://www.youtube.com/watch?v=dQw4w9WgXcQ
ALT: /yp

Select previous links from your play history (while holding or looking at another boombox)
/yplay -h or /yplay -h INDEX
/yplay -h to see your history, /yplay -h 1 ALT: h, hist, history

Change boombox music time (while holding or looking at another boombox)
/yplay -t SECONDS
/yplay -t 60
ALT: t, time

Change boombox color (while holding or looking at another boombox)
/yplay -c R,G,B
/yplay -c 255,255,255 or -c red (try other colors too!)
ALT: c, col, color

Change boombox volume (while holding or looking at another boombox)
/yplay -v 1-10
/yplay -v 6
ALT: v, vol, volume

Keybinds

Increase the boombox volume (while holding or looking at another boombox)
Hit the 'PageUp' key

Decrease the boombox volume (while holding or looking at another boombox)
Hit the 'PageDown' key

Reset boombox time to 0 (while holding or looking at another boombox)
Hit the 'R' key

Sync boombox with another boombox (while holding or looking at another boombox or player holding a boombox, only available if 'Boombox sync' is set to 'true' in the config)
Hit the 'Q' key

Config

[HOST OVERRIDE]
Allow the boombox to play in the inventory
Set 'Boombox pocket play' to 'true' in the config

[HOST OVERRIDE]
Allow the boombox to sync with another boombox
Set 'Boombox sync' to 'true' in the config

• 2.1.4

  • Skip checking for existing tools if they already exist
  • Fixed wrong video id being shown for some requests
  • Fixed YPlayBoombox not working with some mods

• 2.1.3

  • Fixed invalid URL error not being caught
  • Potential fix for getting stuck in downloading tools state
  • NiceChat compatibility patch (messages will no longer delete the rest of the chat history)

• 2.1.2

  • Fixed time parameter not always working

• 2.1.0-2.1.1

  • Fixed whitespace in multi-commands
  • Added help (displays the YPlayBoombox wiki link) and status commands
  • Fixed temporary files not deleting
  • Fixed audio clearing prematurely when using multiple boomboxes
  • Fixed cancellation exception
  • Boombox will now unmute locally automatically if muted and toggled on
  • Removed "random" boombox color aliases
  • Potential conflicting mods warning will now only show in the console
  • User interface changes

• 2.0.4

  • Temporary file management

• 2.0.3

  • Fixed "Boombox sync" keybind working even if it was disabled
  • Temporary file cleanup
  • Increased maximum audio duration to 12 minutes

• 2.0.1-2.0.2

  • Bug fixes

• 2.0.0

  • Fixed YPlayBoombox not working on some boomboxes
  • Changed bindable mute key from [#] to [Backspace] for compatibility with more keyboard layouts
  • Added "rainbow" boombox color
  • User interface changes
  • Added YPlayUtil.dll dependency
  • Changed mod folder structure
  • Updated tools and added checksum
  • Asynchronous tools downloading
  • Increased server-side timeouts
  • Audio normalisation

• 1.1.4

  • Changed chat message implementation to improve mod compatibility
  • Removed bindable mute key [M], now changed to [#] for compatibility with TooManyEmotes random emoting
  • Possible fix for the boombox showing as muted
  • Added more boombox colors
  • User interface changes
  • Updated tools

• 1.1.3

  • Fixed keybinds activating in the terminal menu
  • Fixed random boombox colors sometimes not working
  • Fixed resync not being available when "Boombox sync" was disabled
  • Increased server-side timeouts
  • Fixed long URLs not loading in offline mode

• 1.1.0-1.1.2: ONE MONTH ANNIVERSARY UPDATE!

  • Audio resuming and syncing now only apply to YPlayBoombox audio
  • Improved mod compatibility
  • Play history formatting
  • You can view your play history without a boombox
  • Added server-side timeouts
  • Improved multi-boombox sync
  • Improved memory management/reduced memory usage
  • Boombox volume can be set to 0
  • Boombox can be muted locally
  • Tools caching changes
  • Improved stability
  • Added randomized boombox colors ("Boombox random color" in the config, disabled by default)
  • Added warning if the host does not have YPlayBoombox installed or there is a version mismatch
  • Added boombox resync for late-joiners
  • Updated and optimised user interface
  • Added more informative logging
  • Added experimental offline mode so you can bring your music with you wherever you go (even if the host doesn't have YPlayBoombox installed!)

• 1.0.8

  • Tools caching
  • Play history now shows the most recently played audio first
  • URL parsing fix

• 1.0.7

  • Fixed encoded titles not downloading
  • Fixed error messages not sending

• 1.0.5-1.0.6

  • Improved audio syncing

• 1.0.4

  • Fixed audio file limits
  • Audio quality changes

• 1.0.1-1.0.3

  • Fixed invalid package

• 1.0.0

  • Initial release