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.

🎵 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

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: 2 tracks
• Menu: 1 track

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/
        └── korCaptain-CaptainAudio/
              └── CaptainAudio.dll

Console Commands

Press F5 in-game to open the console, then use these commands:

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

Example Config:

[General]
Enabled = true
MusicVolume = 0.6
AmbientVolume = 0.3
LocationVolumeMultiplier = 5.0

[Advanced]
LoadRetryCount = 3
LoadRetryDelay = 0.5
LoadTimeout = 15
EnableFallback = true

Config changes apply immediately in-game. Use captainaudio reset to reload if needed.

Adding Your Own Music

Method 1: External Files (✅ Recommended)

1. Navigate to: BepInEx/plugins/korCaptain-CaptainAudio/
2. Create folders:

   BepInEx/plugins/korCaptain-CaptainAudio/
   ├── Music/       # Your custom music files
   ├── Ambient/     # Custom ambient sounds
   └── SFX/         # Custom sound effects
   

3. Add your audio files (.ogg, .wav, .mp3)
4. Restart Valheim to load new music

Custom music overrides embedded tracks for that biome/boss.

Folder Names

Use these exact folder names:

• Biomes: Meadows, BlackForest, Swamp, Swamprainday, Mountain, Plain, Mistland, Ashland
• Bosses: Boss_Eikthyr, Boss_TheElder, Boss_Bonemass, Boss_Moder, Boss_Yagluth, Boss_TheQueen, Boss_Fader
• Activities: Morning, Evening, Home, Sailing, Menu
• Dungeons: forestcrypt, frostcaves

Multiple files per folder = random selection each time.

Example Structure

BepInEx/plugins/korCaptain-CaptainAudio/Music/
├── Meadows/
│   ├── peaceful1.ogg
│   └── peaceful2.ogg   # 2 tracks → random
├── Boss_Eikthyr/
│   └── epic_battle.ogg
└── Mountain/
    └── mountain_theme.ogg

Supported Audio Formats

• .ogg - Recommended (best compatibility, smaller size)
• .wav - Uncompressed (high quality, larger files)
• .mp3 - MPEG compression (limited support)

Music Not Playing

1. Check console (F5) for error messages
2. Verify BepInEx is installed correctly
3. Try captainaudio reset command
4. Check config file: Enabled = true, MusicVolume > 0.0

Volume Too Low/High

• Adjust MusicVolume and AmbientVolume in config file
• Use captainaudio reset to apply changes
• For location music, adjust LocationVolumeMultiplier

Audio Cuts Out or Stutters

• Check LoadRetryCount and LoadTimeout in Advanced config
• Ensure sufficient disk space
• Try reducing LocationVolumeMultiplier if location music overlaps

Config File Not Found

• Launch the game once to generate the config file
• Location: BepInEx/config/captain.CaptainAudio.cfg
• Default values will be created automatically

• Framework: .NET Standard 2.1
• BepInEx Version: 5.4.2200+
• Total Audio: 64MB embedded (44 files)
• Audio Formats: OGG (primary), MP3, WAV
• Harmony Patches: 10 patches for comprehensive audio replacement
• Performance: Parallel loading, reflection caching, retry logic

• ✅ Singleplayer: Fully supported
• ✅ Multiplayer: Client-side only (other players won't hear your music)
• ✅ Dedicated Servers: No server-side installation needed
• ✅ Other Mods: Compatible with most mods (no known conflicts)

총합: 44곡

커스텀 폴더에 음악을 넣으면 내장 음악을 완전히 대체합니다.

사용 방법

1. 폴더 생성: BepInEx/plugins/korCaptain-CaptainAudio/Music/{폴더명}/
2. .ogg, .wav, .mp3 파일 추가
3. 게임 재시작 - 해당 지역에서 커스텀 음악만 재생

폴더명

• Meadow, BlackForest, Swamp, Swamprainday, Mountain, Plain
• Mistland, Ashland, Sailing, Home, Menu
• Morning, Evening, forestcrypt, frostcaves
• Boss_Eikthyr, Boss_TheElder, Boss_Bonemass, Boss_Moder
• Boss_Yagluth, Boss_TheQueen, Boss_Fader

예시

BepInEx/plugins/CaptainAudio/
├── CaptainAudio.dll
└── Music/
    └── Meadow/
        ├── my_song1.ogg
        └── my_song2.ogg   ← 랜덤 재생

같은 폴더에 여러 곡을 넣으면 게임이 랜덤으로 선택합니다.