Replace Valheim's music, ambient sounds, and sound effects with custom audio files embedded directly in the mod DLL.
Transform your Valheim experience with 64MB of custom music covering all biomes, bosses, time-based themes, and more. Captain Audio provides a complete audio replacement system with real-time controls and easy customization.
Captain Audio is an enhanced and extended version of aedenthornCustomAudio, adding:
This mod builds upon aedenthornCustomAudio's flexible audio replacement framework while providing a complete curated soundtrack experience.
This mod includes 44 embedded audio files (64MB total) covering:
BepInEx/plugins/ folderCaptainAudio (if it doesn't exist)Installation Path:
Valheim/
└── BepInEx/
└── plugins/
└── CaptainAudio/
└── CaptainAudio.dll
Press F5 in-game to open the console, then use these commands:
| Command | Description | Example Output |
|---|---|---|
captainaudio music |
Display current music info | Shows playing track, biome, time of day |
captainaudio env |
Display environment audio info | Shows ambient sounds, ocean/wind settings |
captainaudio reset |
Reload settings from config | Reapplies all config values |
Example:
F5 (open console)
> captainaudio music
Current Music: Meadows_Morning_01.ogg
Biome: Meadows
Time: Morning
Volume: 0.6
After first launch, edit the config file at:
BepInEx/config/captain.CaptainAudio.cfg
Available Settings:
| Setting | Default | Range | Description |
|---|---|---|---|
Enabled |
true |
true/false | Enable/disable the mod |
MusicVolume |
0.6 |
0.0 - 1.0 | Background music volume |
AmbientVolume |
0.3 |
0.0 - 1.0 | Environment sounds volume |
LocationVolumeMultiplier |
5.0 |
0.0 - 10.0 | Volume boost for location-specific music |
Example Config:
[General]
Enabled = true
MusicVolume = 0.6
AmbientVolume = 0.3
LocationVolumeMultiplier = 5.0
[Advanced]
LoadRetryCount = 3
LoadRetryDelay = 0.5
LoadTimeout = 15
EnableFallback = true
Note: Config changes apply immediately in-game. Use captainaudio reset to reload if needed.
Captain Audio automatically matches audio files based on folder and file names:
asset/Resources/
├── Music/
│ ├── Meadow/ ← Meadows biome music
│ │ ├── song1.ogg
│ │ └── song2.ogg
│ ├── BlackForest/ ← Black Forest music
│ ├── Boss_Eikthyr/ ← Eikthyr boss battle
│ ├── Morning/ ← Morning theme (all biomes)
│ └── Evening/ ← Evening theme
├── Ambient/
│ └── ocean_waves.wav
└── SFX/
└── portal_sound.mp3
Music Files:
Meadow, BlackForest, Swamp, Mountain, PlainBoss_Eikthyr, Boss_TheElder, Boss_Bonemass, Boss_Moder, Boss_Yagluth, Boss_TheQueenMorning, EveningHome, Menu, SailingSupported Audio Formats:
.ogg - Recommended (Vorbis compression, smaller file size).wav - Uncompressed (high quality, larger files).mp3 - MPEG compression (limited support)Method 1: External Files (✅ Recommended)
BepInEx/plugins/CaptainAudio/ folder (create if it doesn't exist)BepInEx/plugins/CaptainAudio/
├── Music/ # Your custom music files
├── Ambient/ # Custom ambient sounds
└── SFX/ # Custom sound effects
Music/custom_song.ogg)Music/Meadows/meadow1.ogg, Music/Boss_Eikthyr/boss_track.ogg)Supported Formats:
.ogg - Recommended (Vorbis compression, best compatibility).wav - Uncompressed (high quality, larger files).mp3 - MPEG compression (limited support)Note: Game restart required to detect new files. Files added during gameplay are not automatically loaded.
Captain Audio uses a 3-tier matching system:
Exact Folder Name (Priority 1)
Music/Meadows/ → Meadows biome musicMusic/Boss_Eikthyr/ → Eikthyr boss battle musicMapping Rules (Priority 2)
Music/Meadow/ → Also works for Meadows (mapped: "meadow" → "meadows")Music/Forest/ → Black Forest music (mapped: "forest" → "blackforest")Music/Menu/ or Music/MainMenu/ → Menu music (multiple aliases)Individual Clip Replacement (Fallback)
Recommended Folder Names:
Meadows, BlackForest, Swamp, Mountain, Plain, Mistland, AshlandBoss_Eikthyr, Boss_TheElder, Boss_Bonemass, Boss_Moder, Boss_Yagluth, Boss_TheQueenMorning, Evening, Home, Sailing, Menuforestcrypt, frostcavesMultiple Files Per Folder: Each folder can contain multiple tracks. The game will randomly select from available tracks.
Example Structure:
BepInEx/plugins/CaptainAudio/Music/
├── Meadows/
│ ├── peaceful1.ogg
│ ├── peaceful2.ogg
│ └── peaceful3.ogg # 3 tracks → random selection
├── Boss_Eikthyr/
│ └── epic_battle.ogg # 1 track
└── Mountain/
├── mountain_theme1.ogg
└── mountain_theme2.ogg # 2 tracks → random selection
Method 2: Rebuild from Source (Advanced)
.ogg or .wav files to asset/Resources/Music/[Folder]/dotnet build -c Releasecaptainaudio reset commandEnabled = true, MusicVolume > 0.0MusicVolume and AmbientVolume in config filecaptainaudio reset to apply changesLocationVolumeMultiplierLoadRetryCount and LoadTimeout in Advanced configLocationVolumeMultiplier if location music overlapsBepInEx/config/captain.CaptainAudio.cfgThis mod is provided as-is for personal use. Please respect the original audio creators' rights when using custom audio files.
Enjoy your personalized Valheim soundtrack! 🎵