Boombox Radio · 我的世界Mod

.detail-panel[hidden] { display: block !important; } .detail-tabs { display: none; } /* These three panels are rendered by the browser. */ [data-versions], [data-changelog-panel], [data-comments] { display: none; }

Radio Mod - 描述

概述

Radio Mod 通过添加一个功能完整的无线电方块，可将 Minecraft 世界转变为个性化的音乐体验。该方块可直接从 YouTube 流式传输音乐。无论你是在建造、探索，抑或只是在基地里放松，都能在不离开游戏的情况下欣赏你最喜欢的曲调。

主要特性

🎵 可合成的无线电方块

在你的世界中添加一个既具装饰性又实用的无线电方块。该方块可以通过简单的配方合成，并放置在世界中的任何位置，非常适合创建音乐室、娱乐区或为你的建筑增添环境背景音乐。

🎧 YouTube 音乐流式传输

直接从 YouTube 流式传输音乐，无需下载文件。只需将任意 YouTube 视频网址或 YouTube Music 播放列表网址粘贴到无线电的界面中，模组就会处理其余部分。该模组同时支持单个视频和整个播放列表，让你能即时访问数百万首歌曲。

🎮 完整的音乐播放器控制

通过直观的游戏内图形界面，对音乐体验进行完全控制：

播放/暂停：随时开始或暂停播放
停止：完全停止播放并清除当前曲目
随机播放：随机化播放列表顺序，获得全新的聆听体验
下一首/上一首：使用专门的跳过按钮在播放列表曲目间导航
实时状态：在图形界面中查看当前播放状态和曲目信息

📻 播放列表支持

完全支持 YouTube Music 播放列表，并自动切换曲目。当你加载一个播放列表时，无线电将按顺序自动播放每一首曲目。图形界面会显示你在播放列表中的当前位置（例如“曲目 3/15”），你可以随时向前或向后跳过曲目。

🎨 用户友好界面

右键单击无线电方块，打开一个干净、易于使用的音乐播放器界面。该图形界面具有以下特点：

用于输入 YouTube 链接的 URL 输入框
大型、标签清晰的控件按钮
实时播放状态指示器
播放列表信息显示
自动播放列表检测（为播放列表显示随机播放按钮）

如何使用

合成配方

使用以下配方合成你的无线电：

I R I
R C R
I I I

其中：

I = 铁锭
R = 红石粉
C = 指南针

快速上手

合成一个无线电：使用上述配方（也可在创造模式下的“工具与实用品”标签页中找到）
放置无线电：右键单击任意方块将其放置在你的世界中
打开音乐播放器：右键单击已放置的无线电方块
输入 YouTube URL：
- 单个视频：https://www.youtube.com/watch?v=VIDEO_ID
- YouTube Music：https://music.youtube.com/watch?v=VIDEO_ID
- 播放列表：https://music.youtube.com/playlist?list=PLAYLIST_ID
点击播放，等待几秒钟进行音频提取
**享受你的音乐！**音频在游戏过程中实时流式传输

控制指南

播放按钮：开始播放，或从暂停状态恢复
暂停按钮：暂停当前曲目（可通过播放按钮恢复）
停止按钮：完全停止播放
随机播放按钮：随机排序并播放播放列表（仅对播放列表 URL 可见）
下一首 (▶▶)：前进到播放列表中的下一首曲目
上一首 (◀◀)：返回到播放列表中的上一首曲目

技术要求

所需软件

无 - 全部由 CurseForge 安装程序处理

Minecraft 要求

Minecraft 版本：1.20.4
模组加载器：Minecraft Forge 49.2.0 或兼容版本（更高版本）
Java 版本：Java 17 或更高版本
网络连接：需要用于流式传输 YouTube 内容

工作原理

该模组使用一套复杂的音频流式传输系统：

URL 处理：当你输入 YouTube URL 时，模组使用 yt-dlp 提取直接的音频流 URL
音频流式传输：借助 ffmpeg，无需下载文件即可实时流式传输音频
播放：Java Sound API 在单独的线程中处理音频播放，以防止游戏卡顿
播放列表管理：对于播放列表，模组会提取所有视频 URL 并管理自动播放顺序

详细特性

单个视频播放

播放任意 YouTube 视频作为背景音乐。非常适合单首歌曲、播客或任何音频内容。模组仅提取音轨，因此不会浪费带宽在视频数据上。

播放列表管理

加载整个 YouTube Music 播放列表，让无线电自动播放。模组会跟踪你在播放列表中的位置，并允许你根据需要跳过曲目。播放列表可以按顺序播放，也可以随机播放以增加多样性。

随机播放模式

使用随机播放功能随机化你的播放列表顺序。当你点击随机播放时，模组会在开始播放前随机化播放列表队列，确保每次都能获得全新的聆听体验。

实时状态

图形界面会显示关于播放的实时信息：

当前状态（播放中、已暂停、已停止）
播放列表位置（例如“曲目 5/20”）
随着曲目变化自动更新状态

技巧与窍门

多个无线电：在你的世界不同区域放置多个无线电，以实现区域化音乐
播放列表多样性：在 YouTube Music 上创建不同心情或活动的主题播放列表
背景音乐：在建造或探索时，使用无线电播放环境音乐
服务器兼容：可在单人游戏和多人游戏服务器上使用（每位玩家需安装依赖项）

故障排除

常见问题

音频无法播放

确认 YouTube URL 有效且可访问
检查视频是否未设为私密或受区域限制
查看 Minecraft 日志以获取详细的错误信息

播放列表无法加载

确认播放列表 URL 正确
确保播放列表是公开的或你拥有访问权限
某些非常大的播放列表可能需要更长时间处理

模组无法加载

确保你使用的是 Minecraft 1.20.4 以及 Forge 49.2.0 或更高版本
检查是否安装了 Java 17 或更高版本
确认模组文件位于正确的 mods 文件夹中

法律声明

⚠️ 重要提示：本模组使用 yt-dlp 从 YouTube 提取音频。请确保你遵守：

YouTube 的服务条款
你所在司法管辖区的版权法
合理使用政策

本模组仅供个人使用。请勿重新分发受版权保护的内容。模组作者不对任何滥用本软件的行为负责。

第三方工具免责声明：模组作者与 yt-dlp 或 ffmpeg 无关联关系，也不对其表示认可或推广。这些工具仅供教育和个人使用。用户有责任确保其对这些工具的使用符合所有适用的服务条款和当地法律。

鸣谢

模组作者：MarcJC
YouTube 提取：yt-dlp (https://github.com/yt-dlp/yt-dlp)
音频处理：ffmpeg (https://ffmpeg.org/)
许可证：MIT 许可证

在 Minecraft 中享受你的音乐吧！ 🎵