This is a fork of the original CustomAudio mod by aedenthorn. It adds support for substituting location-specific music, which was not implemented in the original version (as this feature was introduced in a later Valheim update).
The mod now supports layered folder loading, enabling compatibility with mod managers like r2modman:
It first loads audio tracks from:
BepInEx/plugins/CustomAudio (as in the original CustomAudio)
It then loads tracks from any of the following:
BepInEx/plugins/<modauthor>-<modname>/CustomAudio
Tracks and folders with matching names will be overwritten in alphabetical order — later names override earlier ones.
This means:
CustomAudio folder to the top-level plugins/ directory.Unlike regular music (which uses track lists), location music maps one location to one track.
To replace a location's music, place an audio file with the same name as the original track inside:
CustomAudio/Music/
Ashland - Fortress
Ashlands - Ruins 1
Ashlands - Ruins 2
Ashlands - Ruins 3
Black Forest - Greydwarf Camp
Black Forest - Haldor
Black Forest - Smouldering Tomb
LocationReveal
Meadows - Hildir
Meadows - Village & Farm
Mistlands - Dvergr Excavation Site
Mistlands - Dvergr Tower
Mountain Cave Sanctum
Mountains - Abandoned cottages
Mountains - Howling cavern
Plains - Fuling Camp
Plains - Sealed Tower
Plains - Stone Henges
Swamps - Bogwitch v2
LocationReveal is the track played when discovering burial chambers in the Black Forest.
All other names correspond to specific in-game locations, which are self explanatory.
For everything else, refer to the original CustomAudio README.
To see a working example, check out my Elderscrollian-themed soundtrack package.