MinecraftBackgroundMusic

A mod for PEAK that replaces region music with custom MP3s, supporting per-region music folders and smooth track transitions. Pre-configured with minecraft music but can be changed easily.

Features

• Plays custom MP3s for PEAK’s regions: Beach, Tropics, Alpine, Mesa, Caldera, Kiln, Peak, and Tomb.
• Automatically switches to a new random track when the current one ends.
• Option to preload tracks so no stutter while tracks switch ingame(Note: Needs to be turned on in config, be aware it makes game lag for about 5-10 secs on the main menu when first launching as its loading the tracks into cache).
• Supports a folder structure with optional region-specific music and a Default fallback if no region-specific music specified.
• Configurable folder names via a config file, including an option to use vanilla Tomb music.
• Preconfigured with Minecraft music, including Nether Update and pre-1.16 Nether tracks for the later stages.

You can customize MP3s however you want! You can delete the included tracks and use your own. The mod plays any MP3s found in the specified folders, making it a versatile background audio mod.

Installation

1. I've only installed this mod manually, its drag and drop. Not sure if it works with thunderstore mod loader thingy.
2. Install BepInEx-BepInExPack_PEAK-5.4.75301 - I installed it manually, just drag contents of BepInExPack_PEAK to Program Files (x86)\Steam\steamapps\common\PEAK.
3. After you've installed BepInEx, you can install my mod.
4. Merge contents of my mod's BepInEx folder (includes the config and plugins folder) into Program Files (x86)\Steam\steamapps\common\PEAK\BepInEx.
5. Optionally add or edit MP3s to subfolders (e.g., CustomBackgroundMusic/Beach, CustomBackgroundMusic/Tropics, CustomBackgroundMusic/Mesa, CustomBackgroundMusic/Tomb, CustomBackgroundMusic/Default). See below to see how the folder structure works. Basically it defaults to the Default folder, and if theres any mp3s in the region specific folders, it uses those instead.

Folder Structure

The mod uses a CustomBackgroundMusic folder located in BepInEx/plugins. Inside, create subfolders for each region:

• Beach: Music for the Beach region.
• Tropics: Music for the Tropics region.
• Alpine: Music for the Alpine region.
• Mesa: Music for the Mesa region.
• Caldera: Music for the Caldera region.
• Kiln: Music for the Kiln region.
• Peak: Music for the Peak region.
• Tomb: Music for the Tomb region (optional, can use vanilla music via config).
• Default: Fallback folder used if a region’s folder is missing or empty. These will play in every region that does not have specific mp3s in their folder.

Currently every region is using the Minecraft Alpha and Classic music (and a couple beta songs I like) from the default folder. Then just for the later stages (Caldera and Kiln) i put the nether music in those folders, so these regions will cycle only between these mp3s. The Tomb region defaults to vanilla music unless you set UseDefaultTombMusic to false and add MP3s to the Tomb folder.

Example:

BepInEx/plugins/
├── CustomBackgroundMusic/
│ ├── Beach/
│ │ ├── track1.mp3
│ │ ├── track2.mp3
│ ├── Tropics/
│ │ ├── tropical_song.mp3
│ ├── Mesa/
│ │ ├── mesa_track.mp3
│ ├── Tomb/
│ │ ├── tomb_track.mp3
│ ├── Default/
│ │ ├── fallback_track.mp3
├── backgroundMusic.dll

• Place MP3s in the appropriate region folders. The mod randomly selects an MP3 from the region’s folder when you enter that region.
• If a region folder is missing or empty, the mod falls back to the Default folder.
• You can delete any region folders you don’t need (or just keep them empty), but ensure the Default folder has MP3s for fallback.

Configuration

The mod generates a config file at BepInEx/config/com.mthwj.minecraftmusic.cfg on first run. It contains entries for each region’s folder name:

• BeachFolder: Folder for Beach region music (default: Beach).
• TropicsFolder: Folder for Tropics region music (default: Tropics).
• AlpineFolder: Folder for Alpine region music (default: Alpine).
• MesaFolder: Folder for Mesa region music (default: Mesa).
• CalderaFolder: Folder for Caldera region music (default: Caldera).
• KilnFolder: Folder for Kiln region music (default: Kiln).
• PeakFolder: Folder for Peak region music (default: Peak).
• TombFolder: Folder for Tomb region music (default: Tomb).
• DefaultFolder: Fallback folder (default: Default).
• UseDefaultTombMusic: If true, uses vanilla Tomb music instead of custom MP3s (default: true).
• AllowStingerMusic: If true, allows ingame stinger effects (e.g. the game has default short tracks played, seperate to background music when sunset or sunrise or at nighttime or when changing region)(default: false).
• PreloadAudioClips: If true, preloads all MP3s during game startup to avoid lag spikes during gameplay, but may cause initial main menu screen lag (e.g., 10 seconds depending on amount and file size of audio tracks)(default: false). I do recommend turning it on, otherwise you get stutters between each track change, just defaulted it to off so people dont get spooked why their game lags horribly for 10 secs when first launched.

Folder names can be relative to CustomBackgroundMusic (e.g., Beach) or absolute paths (e.g., C:\Music\Beach). Edit the config to change folder names or point to custom locations.

Notes

• The mod is preconfigured with Minecraft music, including Nether Update tracks and pre-1.16 Nether music for less peaceful regions (e.g., Caldera, Kiln). The Mesa biome now supports custom tracks, and the Tomb region can use either vanilla or custom music based on the UseDefaultTombMusic config. Feel free to replace these with your own MP3s.
• Join the PEAK modding Discord and discuss in my mod's channel! https://discord.com/channels/1363179626435707082/1387427228932898846

Changelog

[0.4.5] - 2025-08-18

• Fixed tracks not going back to default if the region folder was empty of audio files (only happened when preload audio was true) ty catnamednoris for report.

[0.4.4] - 2025-08-16

• Added the option to preload tracks. I really recommend turning this on so there isn't ingame stutters when it changes between tracks. Just note it lags the game on launch up for 5 secs or so.

[0.4.3] - 2025-08-16

• Added a config option to block short musical stingers e.g. audio clips triggered at times of day like sunset the game plays, that can interfere with your audio listening pleasure.
• This is enabled by default. Previous versions didn't block these stingers at all so this is new. ty catnamednorris and tofudinner for detective work.

[0.4.2] - 2025-08-13

• Fixed some errors in the mod description.

[0.4.1] - 2025-08-13

• Added a link to the thread for my mod on discord for anyone to ask anything or discuss.

[0.4.0] - 2025-08-13

• Updated mod to support PEAK’s latest update, adding the Mesa biome with a new Mesa folder for custom MP3s.
• Added support for the Tomb region with a new Tomb folder and a UseDefaultTombMusic config (defaults to true for vanilla tomb music).

[0.3.1] - 2025-06-28

• Deleted an extra folder mistakenly included in the last upload.

[0.3.0] - 2025-06-28

• Removed abrupt track changes when moving between regions; now continues the same song if playing from the "Default" folder.
• Added crossfade when entering a region with specific music for smoother transitions.

[0.2.4] - 2025-06-27

• Made C418 Alpha (the credits song) the track for the final stage "Peak".

[0.2.3] - 2025-06-27

• More clarification on the Thunderstore description.

[0.2.2] - 2025-06-27

• Clarified the instructions.

[0.2.1] - 2025-06-27

• Edited description typos.

[0.2.0] - 2025-06-27

• Added dynamic music folder path (no longer hardcoded to C: drive).
• Introduced per-region folder structure (CustomBackgroundMusic/Beach, etc.).
• Added config file for customizable folder names.
• Included Minecraft Nether Update and pre-1.16 Nether music for later, scary regions.

[0.1.0] - [Previous Date]

• Initial release with Minecraft background music for PEAK regions.
• Supported random track selection from a single folder.