Ambient Music Player + Music Controller

关于版本 1.3.0 的重要说明：此版本新增了像音乐应用一样创建播放列表的功能。不过，由于播放音乐时使用的是 Ambient Player 系统，你需要先了解它的用法。为此，我更新了该模组的教程界面，并新增了一个播放列表 章节，阅读后即可了解它的工作原理。

另外，由于它使用相同的系统，我为 Ambient Manager 制作了配置界面，让你可以使用两套配置。因为两种模式的配置类型相同，我无法为播放列表模式设置默认值，所以需要你自行配置，例如关闭噪声检查或随机播放模式。

版本：1.2.0 日期：2026年4月23日

遇到任何问题，请在评论区留言，我会尽力帮忙。

我修复了许多问题，但没有添加新功能。以下是部分修复内容：

1. 修复了配置文件夹中没有添加环境音乐时界面崩溃的问题。

2. 改进了 mixin，使其兼容性更好，也不再那么激进。

3. 修复了事件延迟问题。现在你可以为任意事件设置最短和最长延迟，并且都能正常生效，不过可能需要先进入一个世界。

4. 启用后，Ambient Player 不会再干扰主菜单。

5. 为该模组添加了一个新的依赖项。

6. 修复了模组生物群系未使用自定义最短和最长延迟的问题。  

——————————————————————————

这是一个音乐控制器，旨在通过自定义配置菜单和界面控制音乐及声音事件，让游戏中的所有音乐都可自定义。虽然也有其他模组能实现类似功能，但它们都没有提供一种简单直接的方式来配置音乐，而不必处理它们的 SoundEvents；而这个模组可以全面控制游戏的音乐系统。

它还附带一个环境音乐播放器，可在游戏中动态加入另一套音乐系统，同时不会破坏 Minecraft 的音乐管理器。两者可以同时运行，互不干扰，并且有许多选项可用于调整它们各自的播放时长。

播放器提供了大量设置，几乎就是一套完整的环境音乐系统：它会检测静音状态和游戏中与声音相关的动作，并据此播放环境音乐。

界面截图请查看图片区域。

关于世界事件的一些说明：

• 探索：手持已完整填充地图的纸张时触发。
• 地下：位于 y-10以下。
• 深暗：基本上会检查屏幕亮度，因此在洞穴、黑暗区域、夜晚或监守者附近等情形下触发。

这些事件也有优先级：维度优先，其次是玩家状态（条件非常严格，只有你正在进行相应活动时才会触发），然后是海洋、地下；接着是天气中的雨和雷暴；之后是生物群系和世界状态；最后是昼夜时间，使用 Minecraft 的默认时间设置。

兼容性

我添加了三个 mixin，其中两个可以禁用，且不会导致模组失效。

若要禁用这些 mixin 以消除冲突，先使用压缩文件管理器打开该模组的 jar 文件，然后在其中打开musicontroller_k.mixins.json 文件，你会看到：

  “client”: [
    “MusicManagerMixin”,
    “SoundEngineAccessorMixin”,
    “SoundManagerAccessorMixin”,
    “SubtitleOverlayMixin”,
    “ToastInstanceMixin”
  ]

• “SubtitleOverlayMixin” 可以移除：这会禁用关闭声音字幕的功能。是的，我知道游戏里已经有这个选项，但它对我来说一直不起作用。
• “ToastInstanceMixin” 也可以移除。当 Minecraft 显示提示时会播放声音，我用这个 mixin 禁用了 MusicToast 实例的这段声音。所以移除它之后，只会重新启用这段声音，仅此而已。

Accessor 从来不会造成任何问题。至于 MusicManagerMixin，这个非常重要，不能移除，否则会导致崩溃。

我制作这个模组的原因是我自己需要它，而且实在找不到能让我实现现在这些功能的模组。

我也会制作其他自用模组，但它们都支持完整配置，因此其他人也可以根据自己的需要使用。我主要在 1.20.1 上开发和游玩。Minecraft 实在很难开发，因为版本和平台太多了。不过，如果有人需要这个模组的其他版本，我只能收费制作，或者等它在这里获得支持；因为在这里上传模组根本赚不到钱，而制作模组又要花上好几个月，这并不好玩。