CaptainAudio

Captain Audio

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.

📖 About This Mod

Captain Audio is an enhanced and extended version of aedenthornCustomAudio, adding:

• 44 high-quality music tracks embedded directly in the DLL (64MB total)
• Pre-configured music for all biomes, bosses, and activities
• Ready to use out-of-the-box - no additional setup required
• Full compatibility with the original CustomAudio external file system

This mod builds upon aedenthornCustomAudio's flexible audio replacement framework while providing a complete curated soundtrack experience.

---

✨ Features

🎵 Music Replacement

• 44 embedded audio files covering:
• 🐗 Boss battles (Eikthyr, Elder, Bonemass, Moder, Yagluth, The Queen)
• 🌲 All biomes (Meadows, Black Forest, Swamp, Mountains, Plains, Mistlands, Ashlands)
• 🌅 Time-based themes (Morning, Evening)
• 🏠 Activities (Home, Sailing, Menu)
• 🏰 Dungeons (Forest Crypt, Frost Caves)

🌊 Ambient Sound Replacement

• Environment sounds for each biome
• Ocean and wind sounds with special handling
• Day/night ambient variations

🔊 Sound Effects (SFX) Replacement

• Portal sounds
• Fireplace/torch sounds (5 types: ground torch, wall torch, bonfire, etc.)
• Customizable object sounds

⚙️ Real-time Controls

• Console commands for instant audio control
• Config file for persistent settings
• Volume controls that apply immediately
• Reset functionality to restore vanilla audio

---

🎵 Included Music Inventory

This mod includes 44 embedded audio files (64MB total) covering:

Biomes (23 tracks)

• Meadows: 3 tracks
• Black Forest: 3 tracks
• Swamp: 3 tracks + 1 rainy day variant
• Mountains: 3 tracks
• Plains: 3 tracks
• Mistlands: 3 tracks
• Ashlands: 2 tracks
• Forest Crypt (dungeon): 2 tracks
• Frost Caves (dungeon): 1 track

Boss Battles (10 tracks)

• Eikthyr: 1 track
• The Elder: 2 tracks
• Bonemass: 1 track
• Moder: 1 track
• Yagluth: 2 tracks
• The Queen: 1 track

Time & Activities (11 tracks)

• Morning: 2 tracks
• Evening: 1 track
• Home: 3 tracks
• Sailing: 3 tracks
• Menu: 1 track

---

📦 Installation

Method 1: r2modman (Recommended)

1. Install r2modman if you haven't already: r2modman Download
2. Select Valheim as your game
3. Search for "CaptainAudio" in the mod browser
4. Click "Download" and let r2modman handle everything
5. Launch the game through r2modman

Method 2: Manual Installation

1. Install BepInEx if not already installed: BepInExPack Valheim
2. Download CaptainAudio.dll from this mod page
3. Navigate to BepInEx/plugins/ folder
4. Create folder CaptainAudio (if it doesn't exist)
5. Copy CaptainAudio.dll into the folder
6. Launch Valheim

Installation Path:

Valheim/
└── BepInEx/
    └── plugins/
        └── CaptainAudio/
            └── CaptainAudio.dll

---

🎮 Usage

Console Commands

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

Configuration File

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.

---

🎨 Music Customization Guide

Audio File Organization

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

Naming Conventions

Music Files:

• Folder names should match game locations: Meadow, BlackForest, Swamp, Mountain, Plain
• Boss music: Boss_Eikthyr, Boss_TheElder, Boss_Bonemass, Boss_Moder, Boss_Yagluth, Boss_TheQueen
• Time-based: Morning, Evening