Zoma's Music player

🎵 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

• ✅ Example SoundPack is available here: Example-SoundPack

> ⚠️ 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!