🎵 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 .minecraft folder, navigate to the soundpacks directory.
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_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

📦 How to Use

📄 Condition File Setup (predicate.json)

🎯 Available Playback Conditions

🗂️ Required Metadata File

📄 Condition File Setup (`predicate.json`)

Zoma's Music player