Elsa Music Mod

🐕🎵 When Elsa gets angry — she sings! And Huntsman gets a custom gunshot!

A mod for R.E.P.O. that adds immersive custom sounds:

• Plays a musical track when the Elsa enemy (the dog) enters an aggressive state (Big form). The track loops for the entire duration of her aggression and smoothly fades out upon her death or calming down.
• Plays a custom one-shot sound when the Huntsman enemy fires his weapon.
• Everything is fully positional in 3D space — the sounds originate directly from the enemies!

🎮 Features

• 🔊 3D Positional Audio — music and gunshots originate from the enemies and fade with distance.
• 🏹 Huntsman Support — custom gunshot sounds for the Hunter!
• 🔇 Spatial Muffle — sound gets muffled at a distance (Low-Pass Filter effect), just like the robots in the game.
• 🎶 Smooth Transitions (Fade) — Elsa's music fades in and out smoothly without abrupt cuts.
• 🔁 Looped Playback — plays continuously while Elsa is in her aggressive (big) form.
• 💀 Auto-Stop — music stops upon the dog's death, despawn, or calming down.
• 📁 Custom Sounds — set your own tracks for both Elsa and Huntsman via config (.ogg, .mp3, .wav).
• ⚙️ REPOConfig Ready — fully integrated with REPOConfig! All sliders and drop-downs look and work perfectly in the in-game menu.
• 🇷🇺 Auto-Localization — automatically translates debug and info messages to Russian if your system language is Russian.

📦 Installation

Via r2modman / Thunderstore Mod Manager (Recommended)

1. Open r2modman or Thunderstore Mod Manager
2. Select the game R.E.P.O.
3. Search for ElsaMusicMod (author: jaffyfox) in the online catalog
4. Click Install with Mod Manager
5. Done! Launch the game via the mod manager.

Manual Installation

1. Make sure BepInEx 5.x is installed.
2. Download the latest release of the mod.
3. Copy the ElsaMusicMod folder into BepInEx/plugins/. The directory structure should look like this:

   BepInEx/
   └── plugins/
       └── ElsaMusicMod/
           ├── ElsaMusicMod.dll
           ├── elsa_theme.ogg
           └── huntsman_shoot.ogg
   

4. Launch the game.

⚙️ Configuration

The configuration file is created automatically upon the first launch of the mod: BepInEx/config/ua.jaffyfox.elsamusicmod.cfg

It is highly recommended to use REPOConfig, as all mod settings are fully integrated and available in a convenient in-game menu with proper sliders and drop-downs!

General Settings

Audio Settings

Debug

🎶 Custom Sounds

Want to use your own music or gunshot sounds? Easy!

1. Prepare an audio file in .ogg, .mp3, or .wav format.
2. Place it in a convenient location, for example: C:\MyMods\my_elsa_theme.ogg.
3. Open the configuration file ua.jaffyfox.elsamusicmod.cfg (you must do this via text editor, as file paths are hidden from the in-game REPOConfig UI to prevent errors).
4. Enter the full path in the SoundPathElsa or SoundPathHuntsman field.
5. Restart the game or the level.

Notes

• If the file is not found or is corrupted, the mod will automatically use the default track.
• A warning about an inaccessible file will be printed to the BepInEx console.
• Recommended format: .ogg (fastest loading and best compatibility with Unity).

🔧 Compatibility

• R.E.P.O. — tested on the current version (v0.4.4+).
• BepInEx 5.x — required dependency.
• Multiplayer — fully compatible (the mod works exclusively Client-side).
• REPOConfig — supported and highly recommended.

📝 Known Issues

None so far. If errors occur, enable DebugMode in the config, reproduce the issue, and provide the LogOutput.log from BepInEx.

⚖️ License

MIT License — use, modify, and distribute freely.