CustomAudio – Now with Location Music Support

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).

Important Changes from the Original CustomAudio

The mod now supports layered folder loading, enabling compatibility with mod managers like r2modman:

1. It first loads audio tracks from:
   BepInEx/plugins/CustomAudio (as in the original CustomAudio)

2. 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:

• Mod authors can bundle soundtracks with their mods.
• Users no longer need to manually copy the CustomAudio folder to the top-level plugins/ directory.

How to Replace Location Music

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/

List of Location Music Tracks (as of Valheim 0.221.4)

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.

More Information

For everything else, refer to the original CustomAudio README.

To see a working example, check out my Elderscrollian-themed soundtrack package.

• 1.5.12: update for 0.221.10
• 1.5.9: update for bog witch
• 1.5.8: fixed swapped music/ambient folders
• 1.5.7: now first loads audios in plugins/CustomAudio, then looks for and loads in plugins/<modfolder>/CustomAudio
• 1.5.6: readme cleanup
• 1.5.5: now correctly looks for the CustomAudio folder in BepInEx\plugins, rather than where the .dll is located
• 1.5.4: initial release