π΅ Music Player Mod
Music Player is a mod that lets you freely set and switch background music (BGM) based on in-game conditions.
Customize your soundtrack to match the worldβs atmosphere β whether it's day or night, peaceful or in battle!
π¦ How to Use
- Inside your
.minecraftfolder, navigate to thesoundpacksdirectory. - Set up your custom soundpack using the following structure:
soundpacks/
βββ yourpackname/
βββ assets/
βββ your_pack_id/
βββ conditions/
β βββ predicate.json
βββ music/
βββ name.ogg
- β Example SoundPack is available here: Example-SoundPack
> β οΈ Currently, soundpacks cannot be recognized in .zip format.
> This will be fixed in a future update.
- Apply a resource pack with the same name as your
pack_idto activate the BGM in-game.
π Condition File Setup (predicate.json)
{
"priority": 100, // Higher priority takes effect when multiple conditions match
"music": "music/name.ogg" // Path relative to your music folder
// Playback conditions listed below
}
π― Available Playback Conditions
| Key | Type | Description |
|---|---|---|
biomes |
string[] |
Plays in the specified biomes. Biome tags are supported. |
is_night |
true / false |
Plays only at night if true. |
is_combat |
true / false |
Plays during combat if true (triggers when nearby hostile mobs prepare to attack). |
isVillage |
true / false |
Plays when villagers are nearby if true. |
min_y |
number |
Plays above the specified Y-coordinate. |
max_y |
number |
Plays below the specified Y-coordinate. |
weather |
["clear", "rain", "thunder"] |
Plays during specified weather. |
dimensions |
string[] |
Plays in the specified dimensions. |
gui_screen |
string[] |
Plays only while the specified GUI screen is open. Supported: crafting, brewing_stand, shulker_box, furnace, anvil, enchantment, cartographytable, smithing, merchant. |
ποΈ Required Metadata File
Also include the following file to ensure your soundpack is recognized:
soundpacks/your_pack_id/pack.mcmeta
{
"pack": {
"pack_format": 15,
"description": ""
}
}
πΆ Now you can create an immersive soundtrack tailored to every moment in your Minecraft adventure!

