Zoma的音乐播放器

🎵 音乐播放器模组

音乐播放器 是一个让你可以根据游戏内条件自由设置和切换背景音乐（BGM）的模组。
自定义你的配乐以匹配世界氛围——无论是白天还是夜晚，和平还是战斗！

---

📦 使用方法

1. 在你的 .minecraft 文件夹中，找到 soundpacks 目录。
2. 使用以下结构设置你的自定义音效包：

soundpacks/
└── yourpackname/
    └── assets/
        └── your_pack_id/
            ├── conditions/
            │   └── predicate.json
            └── music/
                └── name.ogg

• ✅ 示例音效包可在此处获取：Example-SoundPack

> ⚠️ 目前，.zip 格式的音效包无法被识别。
> 此问题将在未来的更新中修复。

1. 应用一个与你的 pack_id 同名的资源包，即可在游戏中激活背景音乐。

---

📄 条件文件设置 (predicate.json)

{
  "priority": 100,           // 当多个条件匹配时，优先级更高者生效
  "music": "music/name.ogg"  // 相对于你的音乐文件夹的路径
  // 下方列出播放条件
}

---

🎯 可用的播放条件

键	类型	描述
biomes	string[]	在指定的生物群系中播放。支持生物群系标签。
is_night	true / false	如果为 true，则仅在夜晚播放。
is_combat	true / false	如果为 true，则在战斗期间播放（当附近敌对生物准备攻击时触发）。
isVillage	true / false	如果为 true，则在附近有村民时播放。
min_y	number	在指定 Y 坐标以上播放。
max_y	number	在指定 Y 坐标以下播放。
weather	["clear", "rain", "thunder"]	在指定的天气条件下播放。
dimensions	string[]	在指定的维度中播放。
gui_screen	string[]	仅在指定的 GUI 界面打开时播放。支持：crafting、brewing_stand、shulker_box、furnace、anvil、enchantment、cartographytable、smithing、merchant。

---

🗂️ 必需的元数据文件

还需包含以下文件，以确保你的音效包能被识别：

soundpacks/your_pack_id/pack.mcmeta

{
  "pack": {
    "pack_format": 15,
    "description": ""
  }
}

---

🎶 现在，你可以为 Minecraft 冒险中的每一个瞬间打造沉浸式的配乐了！