Custom Soundtrack
- By
A mod that allows you to change the default tracks, add your own, and even change and add cues for when tracks play.
Custom Soundtrack
Your music, your rules. Replace Minecraft's soundtrack with your own songs and choose exactly when each one plays: a battle theme when mobs attack, a boss track for the Wither, something calm underwater, something eerie in deep caves.
Drop in MP3, OGG, FLAC or WAV files of any length. The rest is set up in game, with no config editing.
Features
- Your own music, any length. MP3, OGG, FLAC and WAV are supported, and songs aren't limited to short clips.
- Music cues for every situation. It comes with cues for the menu, death screen, credits, bosses, combat, underwater, the Nether, the End, caves, night and day.
- Smart combat detection. Combat music only starts when mobs are actually fighting you. Mobs that are just nearby don't count. It keeps playing for a few seconds after the fight ends.
- Boss music. Any boss bar can start it, including the Wither, the Ender Dragon, raids and modded bosses. You can also match a boss by name.
- Make your own cues. Mix conditions such as biome, dimension, time of day, weather, health, height, elytra flight, riding, game mode and more. For example, a last stand track can play when you're in combat below 30% health.
- Smooth transitions. When the situation changes, the old song fades out as the new one fades in.
- Resume where you left off. Combat music can continue from the same spot in the next fight.
- Per-song control. Set titles, volume, start and end trims, a maximum length and fades for each song.
- Full in-game settings screen. Hover over any option to see what it does.
- Falls back to vanilla music. Any cue without songs plays normal Minecraft music, or you can choose silence instead.
Quick start
- Install the mod and launch the game once.
- Open
.minecraft/config/customsoundtrack/music/. There is a folder for each cue (combat,boss,cave,night…). - Drop your songs into the folders.
- Open Options → Music & Sounds → Custom Soundtrack... and press Done.
You now have your own soundtrack.
In-game settings
Open the settings from Options → Music & Sounds, from Mod Menu, or with /soundtrack settings.
| Screen | What you can do |
|---|---|
| Main | Volume, replace vanilla music, song titles, combat detection, skip or stop the current song |
| Music cues | Turn cues on or off, edit, copy, delete, add new ones, restore defaults |
| Edit cue | Name, priority, songs, shuffle, loop, silence between songs, fades, volume, resume, conditions |
| Add songs | Browse your music folder, pick folders or single files |
| Song options | Title, volume, start and end trim, max length, fades |
| Conditions | Pick from a list. Biomes are searchable, and there's a "where I am now" option |
Commands
| Command | What it does |
|---|---|
/soundtrack settings |
Open the settings screen |
/soundtrack reload |
Reload the config and rescan the music folders |
/soundtrack status |
Show the current cue and song, and everything the mod can see |
/soundtrack skip |
Play the next song |
/soundtrack stop |
Turn custom music off or on |
/soundtrack folder |
Open the config folder |
Requirements
- Minecraft 1.20.1, Fabric Loader 0.14.21 or newer
- Fabric API
- Mod Menu (optional)
The mod is client-side only. It works in singleplayer and on any server, and the server doesn't need it installed.
Notes
- Your music follows Minecraft's Master and Music volume sliders.
- Jukeboxes and note blocks are not changed.
- Some Java installs can't load 24-bit WAV files. FLAC, OGG and MP3 always work.
- Advanced users can edit
config/customsoundtrack/soundtrack.jsondirectly, for example to copy setups between instances.
License: MIT
Custom Soundtrack Team
