Biome Beats

这个模组旨在改进 Minecraft 的音乐系统。

功能

这个模组允许你添加自定义曲目、移除歌曲之间的静音间隔，并让你掌控每首曲目的播放时机。

自定义音乐

只需将新曲目放入模组的音乐文件夹即可添加。

背景音乐持续播放

Minecraft 通常有 70 多首曲目，但由于游戏会在曲目之间插入很长的间隔，你每小时只能听到几首。这个模组会去掉这些间隔，让背景音乐持续播放。

控制曲目的播放时机

你可以决定特定歌曲何时播放。例如，可以设置让水下音乐在海洋群系之外播放，或是在夜晚播放诡异的曲目。这样你就能微调游戏氛围，使其符合自己想要的感觉。

这个模组会使用条件来判断何时播放特定音乐曲目。条件可以是：

• “玩家位于平原群系。”
• “玩家位于‘寒冷’群系。”
• “玩家在水下。”
• “Boss 的生命值条可见。”

你可以为每个条件选择在条件满足时播放的曲目。

你可以选择多个独立条件，将它们组合起来。只有所有部分都满足时，组合条件才会生效，让你更灵活地控制特定曲目的播放时机，并根据具体情况微调音乐。例如，你可以设置一个组合条件，让它在玩家于夜晚身处寒冷森林时触发。

兼容性

• Forge、NeoForge、Fabric：三种主流模组加载器均有对应版本。
• 客户端模组：与所有服务器完全兼容。
• 其他模组：自动识别其他模组添加的音乐曲目、群系和群系标签。
• Minecraft 版本：目前仅支持 Minecraft 1.21。

配置

你可以在游戏内通过配置菜单进行设置。进入世界后，按下“打开配置”按键（默认为“B”）即可打开配置界面。退出界面后，配置会自动保存。

主界面分为两部分。左侧可以通过选项卡按类别浏览并选择条件。选中条件后，右侧会显示其设置，你可以在此指定音乐曲目等。

左下角有两个按钮：

• “重新加载”按钮会重新加载配置文件，并重新检测群系和群系标签。
• “打开音乐文件夹”按钮会打开可添加音乐文件的文件夹。添加文件后，按下重新加载按钮，即可让它们显示在配置界面中。

条件类别

条件分为四类，可通过左侧的选项卡访问。使用搜索框可在各类别中查找特定条件。

群系条件

每个群系都有对应的群系条件；玩家在该群系中停留至少三秒后，条件就会触发。模组添加的群系也包括在内。

群系标签条件

群系（及子群系）带有描述其特征的标签，例如“寒冷”“干燥”“多雪”或“主世界”。这些标签适合用于设置跨维度或适用于相似群系的曲目。其他模组添加的群系标签也包括在内。

其他条件

此类别中的大多数条件反映了 Minecraft 的内部机制，另有少数条件是为了方便而添加的。“当前没有播放其他音乐”条件是一个始终满足的后备条件（优先级最低），可用于在没有其他条件生效时播放背景音乐。

组合条件

这些条件适用于特定情境，只有当所有子条件都满足时才会生效。例如：

• 玩家夜间身处寒冷的山地（条件“寒冷”“山地”“夜晚”）。
• 玩家身处下界且处于创造模式（条件“下界”“创造模式”）。
• 玩家在洞穴中且位于水下（条件“洞穴”“水下”）。

配置条件：优先级和音乐曲目

选中一个条件后，你可以配置其优先级，并指定在该条件满足时播放的音乐曲目。

优先级

当多个条件同时生效时，优先级决定哪些条件优先。优先级数值越高，重要性越高。如果较高优先级的条件得到满足，较低优先级的条件就会被忽略。详情请参阅本节。

音乐曲目

你可以为一个条件指定任意数量的音乐曲目。条件满足时，系统会从中随机选择一首。曲目按以下顺序排列：自定义歌曲在最上方，其次是 Minecraft 的背景音乐和唱片音乐，最后是其他模组的曲目。

使用搜索框查找特定歌曲。点击曲目旁边的按钮即可试听。

添加和编辑组合条件

组合条件标签页中有一个额外按钮，可用于添加新条件；每个已有的组合条件旁边也都有编辑按钮。除此之外，配置优先级和指定音乐曲目的方式与标准条件相同。

创建或编辑组合条件时，会打开一个新界面，你可以在其中自定义条件详情。你可以：

• 为条件设置名称。
• 添加简短描述。
• 选择必须全部满足才能激活组合条件的子条件。

模组如何选择音乐曲目

模组会持续监控当前生效的条件，并按以下步骤确定要播放的音乐：

1. 找出已满足条件中的最高优先级。
2. 筛除所有优先级与其不同的条件。
3. 收集剩余条件关联的所有音乐曲目。
4. 如果当前播放的曲目不在列表中，就从列表中随机选择一首新曲目。

模组会记录最近播放过的曲目，并尽可能避免连续重复播放。

当前限制

• 可添加以下格式的自定义音乐曲目：.wav、.mp3、.ogg（Vorbis）、.flac、.aiff/.aif/.aifc、.au、.ape、.spx。
• 该模组会覆盖 Minecraft 的默认音乐系统，因此依赖此系统的其他模组可能会出现兼容性问题。

后续计划

我还有一些想法，希望在未来实现。

• 单独调节曲目音量：可以分别调整每首曲目的音量，这在自定义曲目的音量各不相同时会很有用。
• 界面改进：添加一些小调整，例如显示哪些条件已分配音乐，以及哪些条件当前处于激活状态。
• 移植到较早的 Minecraft 版本：由于我采用了多加载器方案，将模组移植到旧版本有些棘手。不过，按加载器和版本逐一移植应该可行，只是比较耗时。
• 更多设置：
  • 恢复歌曲之间的随机静音间隔，满足喜欢原版 Minecraft 中歌曲间歇的玩家。
  • 调整曲目之间的淡入和淡出时长。
• “Winamp”：可放在屏幕角落（或其他位置）的迷你播放器，显示当前歌曲、时长等信息，也可以提供暂停或跳过歌曲等控制功能。
• 条件分组：将条件分组，以便一次性为所有条件分配音乐，而不必逐个手动设置。
• 支持更多音频格式：我正在寻找一种 Java 前置库，它或许能实现几乎所有音频格式的播放，不过切换到它需要额外的工作。

整合包作者

欢迎在任何整合包中使用此模组。

支持

如果你发现了 Bug 或有任何建议，请提交工单。

许可证

此模组采用MIT 许可证。