aruberuto-CustomAudio_LocationMusic icon

CustomAudio LocationMusic

Fork of the original CustomAudio by aedenthorn, allowing for the substitution of location music.

Last updated a month ago
Total downloads 13243
Total rating 6 
Categories Audio Utility
Dependency string aruberuto-CustomAudio_LocationMusic-1.5.10
Dependants 22 other packages depend on this package

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2105 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured and includes unstripped Unity DLLs.

Preferred version: 5.4.2105

README

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

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.