Zoma's Music player
Java mod listed for Minecraft 1.20. Downloads from the MC Java Mods app on Android.
Situational BGM mod that lets you play custom music based on conditions like biome, time, or combat. Just set your soundpack and apply the matching…
⬇ Download on CurseForgeThe author built this one for Minecraft 1.20.1 on Forge. On other versions it may install and then do nothing.
🎵 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!
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 1.20.1
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on CurseForge — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
- Ships as music_player-1.0-beta.jar — drop this file into the mods folder
- Download size: 35 KB
- Download link checked 19 Oct 2026 — working
These come from our own check of the pack file, not from the source page.