Home›Java›Mods›Zoma's Music player
Zoma's Music player
ModsJava

Zoma's Music player

Java mod listed for Minecraft 1.20. Downloads from the MC Java Mods app on Android.

by Zoma1101 · on CurseForge

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 CurseForge

The 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

  1. Inside your .minecraft folder, navigate to the soundpacks directory.
  2. Set up your custom soundpack using the following structure:
soundpacks/
└── yourpackname/
    └── assets/
        └── your_pack_id/
            ├── conditions/
            │   └── predicate.json
            └── music/
                └── name.ogg

> ⚠️ Currently, soundpacks cannot be recognized in .zip format.
> This will be fixed in a future update.

  1. Apply a resource pack with the same name as your pack_id to 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!

Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

File checked by MCModsHub

These come from our own check of the pack file, not from the source page.

Explore more