ElsaMusicMod

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 Mod Manager (Recommended)

• Open r2modman or 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 | ` | 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 | ` | 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 i