aedenthornCustomAudio
Mod ported. Allows you to swap music, ambient sounds, and sound effects with your own audio files.
About this mod Author’s original text
Now updated with most recent aedenthorn update
This mod lets you replace pretty much any sound in the game with audio files by placing them in the folder BepInEx/plugins/CustomAudio.
The mod should support wav, mp3, and ogg files.
It has a config variable for adjusting music volume beyond the 60% cap the game seems to impose.
When you start the game with this mod, it will create the following folders in your main Valheim folder:
BepInEx\plugins\CustomAudio\Ambient
BepInEx\plugins\CustomAudio\Music
BepInEx\plugins\CustomAudio\SFX
If you place a wav file in any of these folders with the right file name (see below), it will replace that specific audio clip with your file.
If you place a list of clips in a folder with the right folder name (file names don't matter), it will replace the entire list of clips with your list.
Clips are selected from lists to be played at random, so you can get repeats of music or ambient sounds.
Here's an example of replacing an entire SFX list with a different list of wav files:
Finding the Names
Sound Effects
Sound effects are too numerous to list. If you want to find a specific sound effect, you can turn on the config variable DumpInfo and look at the console when the effect is played (one exception to this is fireplace type sounds, see below).
The console will show things like:
[Info: Unity Log] CustomAudio checking SFX: sfx_footstep, clip: Player_Footstep_Wood_Walk_M_08
Here the sound effect is called sfx_footstep and the clip is called Player_Footstep_Wood_Walk_M_08
So, if you want to replace the entire list of clips, create a folder:
BepInEx\plugins\CustomAudio\SFX\sfx_footstep
And fill it with whatever clips you like, names of files don't matter.
If you want to only replace this one clip, you must rename your file to the clip name:
BepInEx\plugins\CustomAudio\SFX\Player_Footstep_Wood_Walk_M_08.wav
Portal Sound
The sound an portal makes when you are close is changed by using
BepInEx\plugins\CustomAudio\SFX\portal.wav
Fireplace Sounds
There are five types of fireplace sounds that this mod replaces. They don't work the same way as ordinary sound effects. To replace them, use the following:
BepInEx\plugins\CustomAudio\SFX\groundtorch.wav
BepInEx\plugins\CustomAudio\SFX\walltorch.wav
BepInEx\plugins\CustomAudio\SFX\fire_pit.wav
BepInEx\plugins\CustomAudio\SFX\bonfire.wav
BepInEx\plugins\CustomAudio\SFX\hearth.wav
Music
Music tracks are sorted into lists based on context, but you can also replace individual tracks if you know the name (turning on the info dump should show the name when music starts).
You can either create a folder named after the list, or create a file named after the track.
So, to change the main menu music, for example, either:
- Create a folder named:
BepInEx\plugins\CustomAudio\Music\menu
and fill it with one or more custom music file - file names don't matter.
- Create a single file named
BepInEx\plugins\CustomAudio\MainMenu.wav
To get a list of vanilla music lists, type customaudio music into the game console (F5). If you type this while in game, it will also display a list of possible music lists for all the environments in the game.
Environment folders will override the vanilla folders for that environment. For example, creating a Music\RainDay folder should do something like override meadows when it's raining during the day (untested).
Ambient Sounds
Wind and ocean ambient sounds are fixed and can be replaced by adding files called wind and ocean in the Ambient folder, e.g.:
BepInEx\plugins\CustomAudio\Ambient\wind.wav
BepInEx\plugins\CustomAudio\Ambient\ocean.wav
Other ambient sounds are organized into biomes, and each biome has three lists, one ordinary list, one for day only, and one for night only.
You can either replace one of the three lists, or replace single clips by name.
To replace an entire list, create a subfolder in CustomAudio\Ambient named after the list (e.g. Forest, F
Install & use Install: BepInEx plugin
- The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
- Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
- Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
- Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.
Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file. In multiplayer, the host and every client need the same mods installed.