REPO SoundBoard Mod

Description

REPO SoundBoard Mod is a customizable soundboard that allows you to play your own sound buttons through proximity voice chat.

Features

• Add and play custom sound buttons
• Hotkey support
• Supports .wav audio files
• Adjustable (local) volume for each sound button

Usage

Sound buttons can be configured using a JSON configuration file named Moli.REPOSoundBoard.json located in the BepInEx config directory of your Thunderstorm game profile.

Locating the config directory

You can locate the BepInEx config directory directly inside Thunderstorm. Go to R.E.P.O. > (your profile) > Settings > Browse profile folder. This will open the Explorer and in there you can navigate to BepInEx > config. Inside this directory you should see the Moli.REPOSoundBoard.json config file. If it does not exist your can create it.

Configuration File Structure

Below is an example of the Moli.REPOSoundBoard.json file structure.

Important Notes:

• The Path to the audio file has to be absolute (meaning it has to start from C:\).
• The Volume is a value from 0 to 1 and adjusts the volume only for you.
• For the names of Keys refer to Unity KeyCode documentation.

{
    "SoundBoard": {
        "StopHotkey": {
            "Keys": ["H"]
        },
        "SoundButtons": [
            {
                "Path": "C:\\Path\\To\\Your\\Clip.wav",
                "Volume": 0.7,
                "Hotkey": {
                    "Keys": ["LeftControl", "Alpha1"]
                }
            },
            {
                "Path": "C:\\WhereEver\\OtherClip.wav",
                "Volume": 0.4,
                "Hotkey": {
                    "Keys": ["Keypad0"]
                }
            }
        ]
    }
}

Converting to .wav Format

If your sound file is not in .wav format, you can convert it using the following methods:

Online Tools

Use online converters to easily transform .mp3 or other formats into .wav.

Local Conversion

To convert locally, follow these steps:

1. Download and install ffmpeg from ffmpeg.org.
2. Open a terminal window (press Win + R, type cmd, and press Enter).
3. Navigate to the directory containing your sound file:

   cd C:\path\to\soundbutton\
   

4. Convert the file using the following command:

   ffmpeg -i <inputfile.mp3> <outputfile.wav>
   

   Replace <inputfile.mp3> with your file name and <outputfile.wav> with the desired output name.
5. The .wav file will be created in the same directory.

Troubleshooting

• Ensure the config file exists and has the correct name.
• Ensure the file paths in the configuration file are absolute (starting from C:\) and correctly formatted.
• Verify that the .wav files are not corrupted and can be played in other media players.
• Check that the keys for the hotkey have the correct names.

Changelog

All notable changes to the mod will be documented in this file.

v0.2.0 - 2025-04-19

Added

• A UI to manage the sound buttons / the sound board
• Support for title-screen audio playback

v0.1.1 - 2025-04-09

Added

• Added support for various audio and video formats:
  • Audio: mp3, aiff
  • Video: avi, mov, mp4, webm, ogg

Fixed

• Fixed audio playback issue where sounds would cut off when triggered multiple times
• Improved sound button behavior for concurrent playback

v0.1.0 - 2025-04-08

General

• Initial release of REPOSoundBoard