MusicBox

v1.0.2·Updated 2026-03-18

Spawns a music box in every level. Play your local MP3/WAV files with multiplayer sync.

About this mod Author’s original text

🎵 MusicBox

Spawns a MusicBox item in every R.E.P.O. level. Play your own local MP3/WAV files directly in-game, with full multiplayer sync so everyone hears the music at the same time.

🚀 Installation

  • Install this mod Mod Manager
  • Navigate to the songs folder:

BepInEx/plugins/ErMichos-MusicBox/songs/

  • Drop your.mp3 or.wav files in there
  • Launch the game — the MusicBox will appear in every level!

🎮 How to use

  • Press M to open/close the music menu
  • Click any song in the list to play it
  • Use the ▶ Play and ⏹ Stop buttons at the bottom
  • Use the 🔊 Volume slider to adjust your local volume
  • The object can be grabbed and moved around the level like any other item

🌐 Multiplayer

  • Works in multiplayer — the MusicBox spawns for all players automatically
  • Audio commands (play/stop) are synced via Photon so everyone hears the same song
  • 🔊 Volume is local — each player can adjust it independently to their preference
  • ⚠️ Each player needs the same song files in their local songs/ folder for audio to play on their end

📁 Supported formats.mp3 and.wav

🔗 Source Code

github.com/ErMichoss/MusicBox

Install & use Install: BepInEx plugin

  1. The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
  2. Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
  3. Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
  4. Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.

Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file.

Dependencies

Install these first, or the mod will not work:

BepInEx-BepInExPack

File & checksum

Filename
MusicBox-1.0.2.zip
File size
64.3 KiB