Wiggsters-SimpleMusicReplacer icon

SimpleMusicReplacer

Custom music per biome or per game track, with playlists. Made for Sea Shanty 2 on the ocean.

Last updated a week ago
Total downloads 53
Total rating 0 
Categories Misc Audio Client-side AI Generated
Dependency string Wiggsters-SimpleMusicReplacer-1.1.0
Dependants 1 other package depends on this package

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2351 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2351

README

Replace Valheim's music with your own, per biome or per game track. Made for playing Sea Shanty 2 on repeat while you're out on the ocean.

No music is included. You add your own files.

Setup

  1. Install with a mod manager, or copy SimpleMusicReplacer.dll into BepInEx/plugins/SimpleMusicReplacer/.
  2. Start the game once. This creates BepInEx/config/SimpleMusicReplacer/ with an empty ocean folder and an available_music.txt file.
  3. Put .ogg, .wav or .mp3 files in a folder, then restart the game.
BepInEx/config/SimpleMusicReplacer/
  ocean/        <- Sea Shanty 2 goes here: loops while you're on the ocean (including sailing)
  meadows/      <- plays in the Meadows
  blackforest/
  combat/       <- replaces the vanilla "combat" music
  sailing/      <- replaces the vanilla sailing music (outside the ocean biome)
  • Biome folders (meadows, blackforest, swamp, mountain, plains, mistlands, ashlands, deepnorth, ocean) loop your music whenever you're in that biome, at any time of day.
  • Any other folder has to match a Valheim music name, and replaces that music. Every valid name is listed in available_music.txt, for example home, combat, sailing, intro and respawn.
  • Several files in one folder make a playlist. They play in alphabetical order, or shuffled if Shuffle is on.

Modpack authors can also put folders in BepInEx/plugins/SimpleMusicReplacer/music/.

Config (BepInEx/config/sakelig.simplemusicreplacer.cfg)

Setting Default Description
Volume 0.7 Volume of custom biome music, also scaled by the in-game music volume
Shuffle false Shuffle playlists
OceanReplacesSailingMusic true Play the ocean music instead of the vanilla sailing music while on the ocean

Only affects your own client. Other players don't need it installed.