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)
- Open r2modman or Thunderstore Mod Manager
- Select the game R.E.P.O.
- Search for ElsaMusicMod (author:
jaffyfox) in the online catalog
- Click Install with Mod Manager
- Done! Launch the game via the mod manager.
Manual Installation
- Make sure BepInEx 5.x is installed.
- Download the latest release of the mod.
- 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
- 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
| Parameter |
Default |
Description |
EnableMod |
true |
Enable or disable the mod entirely. |
EnableSoundElsa |
true |
Enable sound for Elsa. |
EnableSoundHuntsman |
true |
Enable sound for Huntsman. |
Language |
en (or ru) |
Plugin language for internal logs/messages. Auto-detects your system language by default! |
Audio Settings
| Parameter |
Default |
Description |
SoundPathElsa |
<empty> |
Absolute path to a custom audio file for Elsa (.ogg/.mp3/.wav). Leave empty for the default track. (Hidden from REPOConfig UI, edit in .cfg directly) |
SoundPathHuntsman |
<empty> |
Absolute path to a custom audio file for Huntsman (.ogg/.mp3/.wav). Leave empty for the default track. (Hidden from REPOConfig UI, edit in .cfg directly) |
Volume |
0.8 |
Playback volume (from 0.0 to 1.0). |
AudioMode |
Spatial |
Spatial — 3D sound from the enemy, Global — 2D sound for all players. |
SpatialMaxDistance |
20.0 |
Maximum hearing distance in Spatial mode (in game units). |
FadeDuration |
0.5 |
Duration of the smooth fade in/out effect in seconds (for Elsa). |
SpatialMuffle |
true |
Enable distance muffling effect (Low-Pass Filter), similar to robots in the game. Works only in Spatial mode. |
Debug
| Parameter |
Default |
Description |
DebugMode |
false |
Enable detailed logging of all events (state changes, audio loading) to the BepInEx console. Useful for troubleshooting. |
🎶 Custom Sounds
Want to use your own music or gunshot sounds? Easy!
- Prepare an audio file in
.ogg, .mp3, or .wav format.
- Place it in a convenient location, for example:
C:\MyMods\my_elsa_theme.ogg.
- 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).
- Enter the full path in the
SoundPathElsa or SoundPathHuntsman field.
- 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.
