世界音乐播放器

World Music Player

一个面向 Minecraft NeoForge 的客户端世界音乐模组，为早晨、中午、傍晚和午夜分别提供独立的播放列表，每个列表最多支持 10 首曲目。每个时间段只会随机播放一首曲目。播放结束后，音乐将保持静默，直到下一个时间段。

支持的版本

Minecraft	最低 NeoForge 版本	资源包格式
26.1.2	26.1.2.94	84.0
26.3	26.3.0.3-beta	97.1

当前模组版本为 1.0.1。最低 NeoForge 版本已经过测试；更高的构建版本尚未逐一验证。

功能

• 为四个时间段提供独立播放列表，支持单独的原版曲目和资源包中的自定义 Ogg Vorbis 音乐。
• 当新时间段开始时，上一个时间段未播放完的曲目会停止，并选择一首新曲目。
• 一旦某首曲目播放过，编辑播放列表、重新加载资源或切换维度都不会在同一时间段内再次获得播放机会。离开并重新加入会开始一个新的会话，并重新评估当前时间段。
• 默认替换主世界音乐，并可选择让其他维度跟随主世界时钟。
• 如果尚未播放任何曲目，且播放列表为空或不包含有效曲目，你可以选择使用原版音乐或保持静默。
• 遵循游戏的主音量和音乐音量设置，不会影响唱片机或其他音效。

时间段	游戏刻	游戏内时间	正常速度下的现实时长
早晨	0–5999	06:00–12:00	5 分钟
中午	6000–11999	12:00–18:00	5 分钟
傍晚	12000–17999	18:00–00:00	5 分钟
午夜	18000–23999	00:00–06:00	5 分钟

睡觉、时间命令以及对游戏时钟速率的更改都会影响时间段的切换时机。

安装与配置

将适用于你的 Minecraft 版本的模组 JAR 放入客户端的 mods 文件夹。无需在服务器上安装。通过模组列表中的 World Music → Config 编辑播放列表，或在世界中使用 /worldmusic config。

配置文件位于游戏实例内的 config/world_music-client.toml。如果没有自定义音乐，默认播放列表会引用游戏中已包含的 12 首原版曲目。

有关其他内置单曲目引用，请参阅 sounds.json。原版声音事件（例如 minecraft:music.game）本身可能包含多首随机选择的曲目。

客户端命令	功能
/worldmusic 或 /worldmusic status	显示当前时间段和播放状态
/worldmusic config	打开配置界面
/worldmusic next	停止并跳过当前时间段的音乐，然后等待下一个时间段
/worldmusic reload	重新检查播放列表，但不会重置已使用的播放许可

不需要服务器管理员权限。

自定义音乐

**本模组不包含用户音乐、Minecraft 音频文件或生成的音乐 ZIP。 要使用自定义音乐，请参考源代码项目中的说明来创建资源包。

许可证

源代码基于 MIT License 授权。用户添加的第三方音频不在此仓库中分发。模组文件基于 CC BY-NC-SA 4.0 许可证授权。