promotional bannermobile promotional banner

Zoma's Music player

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 resource pack to enjoy dynamic background music!

🎡 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!

The Zoma's Music player Team

profile avatar
  • 7
    Followers
  • 2
    Projects
  • 5.3K
    Downloads

More from Zoma1101