MusicBox Radio

音乐盒电台

在《我的世界》中播放真实的网络电台。放置一个音乐盒，选择一个电台，附近的所有玩家都会听到相同的内容。戴上耳机，无论走到哪里，都能以完整立体声继续收听。

音乐盒电台播放的是来自真实互联网的实时 MP3 广播流，而非游戏自带的音乐唱片。电台列表完全可配置，你可以将其指向任何你喜欢的电台。

---

功能特性

• 实时网络电台。 播放直接的 MP3 流，包括 Shoutcast 和 Icecast 服务器。自动跟随指向 .m3u 和 .pls 播放列表的链接。
• 服务器权威。 所选电台、播放状态和音量都存储在方块本身上。当一个玩家更换电台时，所有正在收听的玩家都会同步随之改变。
• 默认近距音频。 音乐会像其他方块声音一样随距离衰减，且范围可配置。
• 随处可听的耳机。 戴上耳机后，音频将以完整立体声跟随你，无论距离多远，甚至跨维度也有效。
• 将耳机与特定音乐盒配对。 同时运行多个音乐盒也没问题。将耳机与你想要的那个配对，配对到同一音乐盒的玩家将保持收听同一电台。
• 完全可配置的电台。 一个由标签和 URL 对组成的简单 JSON 文件。支持最多 100 个电台。
• 客户端静音开关。 任何玩家都可以在自己机器上完全禁用流媒体播放，这在录制或直播时非常有用。
• 支持 Forge 和 Fabric。 两种加载器均支持 Minecraft 1.19.2。

---

工作原理

音乐盒

放置方块并右键点击以打开界面。你将看到已配置的电台列表、播放和停止开关，以及音量滑块。选择一个电台，它就会开始为范围内的所有玩家播放。

耳机

耳机放入头盔槽。如果你在 Forge 上安装了 Curios，或在 Fabric 上安装了 Trinkets，它们将改用饰品槽，这样你的头盔槽就空出来了。但这两个模组都不是必需的。

佩戴耳机时，音频不再随距离衰减。无论你身在何处，都能获得清晰的立体声播放，包括在另一个维度或远超渲染距离的地方。

配对

未配对的耳机只会跟随最近的在播放的音乐盒。要锁定特定音乐盒，请执行以下任一操作：

• 佩戴或手持耳机时，潜行并右键点击音乐盒。
• 打开音乐盒界面并按下 配对 按钮。

重复该操作即可取消配对。由于配对是在服务器端解析的，因此配对到同一音乐盒的每个玩家都会同时听到相同的电台。

---

配置电台

电台定义在 config/musicboxradio/stations.json 文件中。该文件会在模组首次运行时创建，并附带一组可用的默认设置。在多人游戏服务器上，此文件由服务器控制，并适用于所有玩家。

{
  "proximityRange": 24.0,
  "maxConcurrentStreams": 3,
  "stations": {
    "SomaFM Groove Salad": "https://ice1.somafm.com/groovesalad-128-mp3",
    "Vaporwave Radio": "https://radio.plaza.one/mp3",
    "My Favourite Station": "https://example.com/stream.mp3"
  }
}

选项	默认值	描述
proximityRange	24.0	对于未佩戴耳机的玩家，声音传播的距离（以方块为单位）。
maxConcurrentStreams	3	单个客户端同时播放的流数量。可接受 1 到 8。
stations	见文件	你的电台列表，以 "标签": "url" 键值对形式编写。条目按照你编写的顺序排列。

直接的 MP3 流效果最佳。不支持仅 AAC 格式的流。

客户端设置

个人播放设置位于 config/musicboxradio/client.json 文件中。将 streamingEnabled 设置为 false 可在你自己的客户端上静音所有网络电台，而不影响其他玩家；使用 masterVolume 可调整整体音量大小。

---

合成配方

• 音乐盒： 任意类型的 7 个木板、1 个音符盒和 1 个红石粉。
• 耳机： 1 个铁锭、2 个皮革和任意颜色的 2 个羊毛。

---

要求与注意事项

• 在 Forge 或 Fabric 上运行的 Minecraft 1.19.2。Fabric 版本需要 Fabric API。
• Curios 和 Trinkets 为可选模组。没有它们，耳机也能在头盔槽中正常工作。
• 每个客户端直接连接到电台，因此每个收听者都需要可用的互联网连接。服务器不会中继音频。
• 模组不捆绑任何音乐。所有音频均来自第三方电台，这些电台需对其自身内容和许可负责。
• 流媒体播放会消耗每个收听客户端的带宽，通常每个活动流约为 128 kbps。