Custom Soundtrack

作者：Cazipaq

A mod that allows you to change the default tracks, add your own, and even change and add cues for when tracks play.

模组 Fabric 附属

介绍

中文介绍正在准备中，下面暂时显示原文。

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.json directly, for example to copy setups between instances.

License: MIT