Zoma's Music player

Quick rating

Community listing page, reviews here may not be monitored by the author.

Zoma's Music player

By Zoma1101Owner

No reviews yet

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!

Mod Loaders
Minecraft
26.2

About

Description

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

🎵 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 soundpacks.
  2. Set up your custom soundpack like this:

soundpacks/pack_name/assets/pack_id/conditions/predicate.json soundpacks/pack_name/assets/pack_id/music/name.ogg

Example SoundPack

Example SoundPack is here

Soundpack cannot be recognized in zip file format

This will be fixed in the future.

  1. Apply a resource pack with the same name as your pack_id to activate the BGM.

📄 Condition File Setup (predicate.json)

{
  "priority": 100, // Higher priority takes effect when multiple conditions match
  "music": "music/name.ogg",
  // Playback conditions listed below
}

🎯 Available Playback Conditions

Condition Description
"biomes": [] Plays in the specified biomes (biome tags supported).
"is_night": true/false Plays only at night if true.
"is_combat": true/false Plays during combat if true (triggers when nearby mobs prepare to attack).
"isVillage": true/false Plays when villagers are nearby if true.
"min_y": n Plays when player Y position is higher than n.
"max_y": n Plays when player Y position is lower than n.
"weather": [clear/rain/thunder] Plays during specified weather.
"dimensions": [] Plays in specified dimensions.
"gui_screen": [ ... ] Plays only when specified GUI screens are open. Supported screens: crafting/inventory/furnace/brewing_stand/chest/creative
"entity_conditions": [] The sound will play if the specified entities are within the radius and their count is between min_count and max_count.
"radius": n Checks for entities within n blocks.
"min_count": n Minimum number of matching entities required.
"max_count": n Maximum number of matching entities allowed.

🎶 Now you can create an immersive soundtrack tailored to every moment in your Minecraft adventure!

  • Add this to your pack too soundpacks/pack_id/pack.mcmeta
{
  "pack": {
    "pack_format": 15,
    "description": "",
  }
}