BetterMediaControls

A simple plugin for On-Together: Virtual Co-Working that adds custom songs and shuffle functionality to the media controls.

Custom Songs

You can add your own custom songs to the media controls by placing audio files in the BepInEx/config/BetterMediaControls-Music directory.

Currently, .wav, .ogg, and .mp3 files are supported. Any other file formats will be ignored.

Use https://vert.sh/ for quick and easy audio file conversion, and https://cobalt.tools/ to download audio. (not an ad!)

Identifying

By default, the songs will be identified by their file names. However, you can create a playlist.json file in the same directory to provide this metadata. The playlist.json file should be structured as follows:

{
  "playlist": [
    {
      "file": "eta.wav",
      "title": "ETA",
      "artist": "NewJeans",
      "volume": 0.5
    },
    {
      "file": "ditto.wav",
      "title": "Ditto",
      "artist": "NewJeans",
      "volume": 0.5
    }
  ]
}

In game, your custom music will appear above the default tracks in the same order they were put into the playlist.json file.

Shuffle Functionality

The plugin adds a shuffle button to the media controls, located next to the loop button. It uses the Fisher-Yates algorithm (spotify shuffle) to shuffle the playlist.

When shuffle is enabled, the next track will be randomly selected from the playlist.

Configuration

You can configure the plugin by editing the BepInEx/config/BetterMediaControls.cfg file. The available configuration options are:

• MusicDirectory: The directory where custom music files are stored (default: music [starting from plugin directory]).
• EnableShuffle: Enable or disable shuffle functionality (default: true).
• EnableVanillaMusic: Enable or disable the default music tracks (default: true).