Biome Beats

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

特性

该模组允许你添加自定义曲目，消除歌曲之间的静音，并让你控制每首曲目的播放时机。

自定义音乐

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

连续背景音乐

通常，Minecraft 有超过 70 首曲目，但由于 Minecraft 在曲目之间设置的长暂停，你每小时只能听到几首。这个模组消除了这些暂停，为你带来稳定的背景音乐流。

控制曲目的播放时机

你可以决定特定歌曲的播放时机。例如，你可以设置水下音乐在海洋生物群系之外播放，或在夜晚引入阴森曲目。这让你可以微调游戏氛围，使其符合你的期望感觉。

该模组使用条件来确定特定音乐曲目的播放时机。条件可以是类似于：

• “玩家位于平原生物群系中。”
• “玩家位于‘寒冷’生物群系中。”
• “玩家处于水下。”
• “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 库，它可能使播放几乎任何音频格式成为可能，尽管切换到它需要额外的工作。

整合包作者

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

支持

如果你发现错误或有建议，请创建工单。

许可证

此模组在 MIT 许可证 下可用。