Captain Audio

Custom audio replacement mod for Valheim.

English

Built-in Music (Embedded in DLL)

Total: 44 tracks

Custom Music Priority

When you add music files to the custom folder, ONLY your custom music will play!

The built-in music for that biome/location is completely replaced.

How to Use

1. Create folder: BepInEx/plugins/CaptainAudio/Music/{FolderName}/
2. Add your .ogg, .wav, or .mp3 files
3. Start game - only your custom music plays for that location

Example

BepInEx/plugins/CaptainAudio/
├── CaptainAudio.dll
└── Music/
    └── Meadow/            ← Add 2 custom songs here
        ├── my_song1.ogg
        └── my_song2.ogg

Result: Built-in 3 Meadow tracks are ignored. Only your 2 custom songs play randomly.

Folder Names

Use these exact folder names:

• 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

한국어

내장 음악 (DLL에 포함)

총합: 44곡

커스텀 음악 우선순위

커스텀 폴더에 음악을 넣으면, 해당 바이옴은 커스텀 음악만 재생됩니다!

내장 음악은 완전히 무시됩니다.

사용 방법

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

예시

BepInEx/plugins/CaptainAudio/
├── CaptainAudio.dll
└── Music/
    └── Meadow/            ← 여기에 커스텀 음악 2곡 추가
        ├── my_song1.ogg
        └── my_song2.ogg

결과: 내장된 초원 음악 3곡은 무시되고, 커스텀 음악 2곡만 랜덤 재생됩니다.

폴더명

아래 폴더명을 정확히 사용하세요:

• 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

Support

• GitHub: https://github.com/KorCaptain/Valheim_Captain_Audio
• Issues: https://github.com/KorCaptain/Valheim_Captain_Audio/issues

Changelog / 변경 로그

Update

[1.3.51] - 2026-05-25

• ✅fix1: Custom SFX & ambient

• BepInEx/plugins/korCaptain-CaptainAudio/ ├-- music/ (existing) ├-- sfx/ ← New support └-- Ambient/ ← New Support

• BepInEx/plugins/korCaptain-CaptainAudio/ ├── music/ (기존) ├── sfx/ ← 신규 지원 └── ambient/ ← 신규 지원

[1.3.41] - 2026-05-02

• ✅fix1: boss Music Fixed

[1.3.33] - 2026-03-30

• ✅fix1: Crash Fixed

[1.3.31] - 2026-03-29

• ✅fix1: Fixed persistent invalid seek position error (SoundChannel.cpp:345) during all music transitions (end/restart, biome change, zone travel)
• ✅fix2: Added Postfix to UpdateMusic patch — corrects invalid AudioSource.time after vanilla logic runs
• ✅fix3: Force m_resumeTime=0 unconditionally in Prefix (was conditional, allowing stale values to persist)
• ✅fix4: Now disables m_resume on both m_currentMusic and m_queuedMusic (previously only m_queuedMusic)
• ✅fix5: Increased loop-disable threshold 0.5s → 1.5s for FMOD buffer headroom
• ✅fix1: 음악 전환(끝·재시작·바이옴 변경·지역이동) 시 반복 발생하던 invalid seek position 에러(SoundChannel.cpp:345) 수정
• ✅fix2: UpdateMusic Postfix 추가 — 바닐라 로직 실행 후 AudioSource.time을 최종 검증·정정
• ✅fix3: m_resumeTime을 Prefix에서 무조건 초기화 (기존 조건부 초기화 → 잔여값 잔류 문제 해결)
• ✅fix4: m_currentMusic과 m_queuedMusic 양쪽 모두 m_resume 비활성화 (기존 m_queuedMusic만 처리)
• ✅fix5: 루프 비활성화 임계값 0.5초 → 1.5초 (FMOD 버퍼 여유 확보)

[1.3.2] - 2026-03-26

• ✅fix1: Fixed Malformed URL error when loading audio files with special characters (parentheses, spaces) in filename
• ✅fix1: 파일명에 괄호, 공백 등 특수문자가 포함된 경우 오디오 로드 실패(Malformed URL) 버그 수정

[1.3.1] - 2025-03-23

• ✅fix1: Vesion fixed
• ✅fix1: 버전 수정

[1.3.0] - 2025-03-6

• ✅fix1: Correction of error at home location
• ✅fix2: Change Start Music
• ✅fix1 : home 위치에서 에러 수정
• ✅fix2 : 시작 음악 변경

v1.2.2 (2025-02-01)

New Feature

• Custom Music Priority: When you add music files to a biome folder, only your custom music plays. Built-in music is completely ignored.

Example

• Add 2 songs to Music/Meadows/ → Built-in 5 Meadows tracks ignored, only your 2 songs play randomly

v1.2.1

Improvements

• Audio clip loading stability improved
• Parallel loading optimization
• Enhanced clip validation

v1.2.0

New Features

• Parallel audio loading support
• Loading retry mechanism
• StringMatchCache performance optimization

v1.1.0

New Features

• External file loading support
• Time-of-day music support (Morning, Day, Evening, Night)

v1.0.0

Initial Release

• Embedded music in DLL (EmbeddedResource)
• Background music, ambient, SFX replacement
• Harmony patch integration
• Console commands support

한국어

v1.2.2 (2025-02-01)

신규 기능

• 커스텀 음악 우선순위: 바이옴 폴더에 음악 파일을 넣으면 커스텀 음악만 재생됩니다. 내장 음악은 완전히 무시됩니다.

예시

• Music/Meadows/에 2곡 추가 → 내장 초원 음악 5곡 무시, 커스텀 2곡만 랜덤 재생

v1.2.1

개선사항

• 오디오 클립 로딩 안정성 향상
• 병렬 로딩 최적화
• 클립 유효성 검증 강화

v1.2.0

신규 기능

• 병렬 오디오 로딩 지원
• 로딩 재시도 메커니즘
• StringMatchCache 성능 최적화

v1.1.0

신규 기능

• 외부 파일 로딩 지원
• 시간대별 음악 지원 (아침, 낮, 저녁, 밤)

v1.0.0

최초 릴리즈

• DLL에 음악 파일 내장 (EmbeddedResource)
• 배경음악, 환경음, 효과음 교체
• Harmony 패치 연동
• 콘솔 명령어 지원