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

3. 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": "",
  }
}