Mineify - Minecraft 全服音乐播放器
一个 Minecraft Fabric 模组,支持全服音乐播放。玩家可以搜索 YouTube,将歌曲添加到共享播放列表,并在 Minecraft 内实时一起收听。
使用方法
- 加入运行了 Mineify 的服务器
- 按下 N+M 打开图形用户界面 (GUI)
- 在搜索栏中输入歌名并按回车键
- 点击结果将其添加到播放列表
- 歌曲会自动下载并为所有已连接的玩家播放
工作原理
所有内容均在 Minecraft 服务器进程中运行——无需辅助服务或额外开放端口。
┌─────────────────────────────────────────────────────────────────────┐
│ MINECRAFT SERVER │
│ ┌─────────────────┐ ┌──────────────────┐ │
│ │ Mineify Mod │◄──►│ Playlist Manager │ │
│ │ (Server-side) │ │ (Track Queue) │ │
│ └────────┬────────┘ └──────────────────┘ │
│ │ │
│ │ ┌─────────────────┐ ┌──────────────────────────────┐ │
│ ├─►│ YouTubeService │ │ AudioDownloadService │ │
│ │ │ (InnerTube API) │ │ yt-dlp subprocess │ │
│ │ └─────────────────┘ └──────────────────────────────┘ │
│ │ │
│ │ Minecraft packets (chunked audio data) │
│ ▼ │
│ ┌─────────────────┐ ┌──────────────────┐ │
│ │ Mineify Mod │───►│ AudioPlayer │ │
│ │ (Client-side) │ │ (javax.sound) │ │
│ └─────────────────┘ └──────────────────┘ │
└─────────────────────────────────────────────────────────────────────┘
- YouTubeService 直接从 Java 调用 YouTube 的内部 InnerTube API —— 无需 API 密钥。
- AudioDownloadService 调用
yt-dlp作为子进程来下载并将音频转换为 WAV 格式。 - 服务器将 WAV 文件分割成块,并通过现有的 Minecraft 连接分发给每个客户端 —— 无需额外开放端口。
- 客户端在内存中重新组装这些块,并使用
javax.sound.sampled在本地播放音频。
功能
- N+M 快捷键 — 在游戏内的任何位置打开 Mineify GUI
- YouTube 搜索 — 直接在 Minecraft 内搜索歌曲
- 共享播放列表 — 所有玩家都能看到并贡献于同一个队列
- 自动播放 — 添加歌曲后自动播放,并按顺序推进队列
- 延迟加入同步 — 中途加入的玩家会自动跳转到正确的位置
- 移除即停 — 移除当前歌曲会立即停止所有人的播放
- 会话缓存 — 下载的文件会在服务器会话期间重复使用
- 无需额外端口 — 音频通过 Minecraft 连接传输;无需更改防火墙设置
- 自包含 — 所有内容都在单个模组 JAR 中,无需辅助服务
要求
| 要求 | |
|---|---|
| Minecraft | 1.21.11 |
| Fabric Loader | 0.18.x+ |
| Fabric API | 1.21.11 的最新版本 |
| Java | 21+ |
| 仅限服务器 | yt-dlp 需在系统 PATH 上 |
| 仅限服务器 | ffmpeg 需在系统 PATH 上 |
客户端仅需模组 JAR —— 无需额外工具。
安装
服务器端
- 为 Minecraft 1.21.11 安装 Fabric Loader。
- 在服务器上安装
yt-dlp和ffmpeg(参见下方指南)。 - 将 Fabric API 和
mineify-1.3.0.jar放入服务器的mods/文件夹中。 - 启动服务器。Mineify 会自动初始化。
可选 — 创建 config/mineify.json 以自定义行为:
{
"downloadDir": "./mineify-downloads",
"maxPlaylistSize": 50
}
客户端
- 为 Minecraft 1.21.11 安装 Fabric Loader。
- 将 Fabric API 和
mineify-1.3.0.jar放入.minecraft/mods/中。 - 使用 Fabric 配置文件启动 Minecraft。无需进一步设置。
安装 yt-dlp 和 ffmpeg
这两个工具仅在服务器端需要。
Linux (Debian/Ubuntu)
sudo apt update && sudo apt install ffmpeg
sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp
sudo chmod a+rx /usr/local/bin/yt-dlp
Linux (Fedora/RHEL)
sudo dnf install ffmpeg
sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp
sudo chmod a+rx /usr/local/bin/yt-dlp
macOS
brew install ffmpeg yt-dlp
Windows (选择一种包管理器)
scoop install yt-dlp ffmpeg
choco install yt-dlp ffmpeg
winget install yt-dlp ffmpeg
Windows — 手动安装
yt-dlp:
- 从发布页面下载
yt-dlp.exe - 将其放置在如
C:\yt-dlp的文件夹中 - 将该文件夹添加到系统 PATH
ffmpeg:
- 从 gyan.dev 下载
- 解压到如
C:\ffmpeg的文件夹中 - 将
C:\ffmpeg\bin添加到系统 PATH
添加到 PATH (Windows):
- 按
Win + R,输入sysdm.cpl,按回车 - 进入高级 → 环境变量
- 在系统变量下,选择
Path→ 编辑 → 新建 - 添加文件夹路径并点击所有对话框中的确定
- 重启终端/服务器
验证安装
yt-dlp --version
ffmpeg -version
两个命令都应打印版本信息且无错误。
项目结构
mine-ify/
├── fabric-mod/
│ └── src/
│ ├── main/java/com/mineify/
│ │ ├── Mineify.java # 服务端入口点与生命周期
│ │ ├── MineifyConfig.java # 配置加载器 (mineify.json)
│ │ ├── server/
│ │ │ ├── PlaylistManager.java # 播放列表状态与音频分发
│ │ │ ├── YouTubeService.java # 通过 InnerTube API 进行 YouTube 搜索
│ │ │ └── AudioDownloadService.java # yt-dlp 下载封装
│ │ └── network/
│ │ ├── MineifyPackets.java # 数据包注册
│ │ └── packets/
│ │ ├── SearchRequestPacket.java
│ │ ├── AddToPlaylistPacket.java
│ │ ├── SearchResultsPacket.java
│ │ ├── PlaylistSyncPacket.java
│ │ ├── AudioChunkPacket.java # 分块音频传输
│ │ └── NowPlayingPacket.java
│ └── client/java/com/mineify/
│ ├── MineifyClient.java # 客户端入口点与数据包处理器
│ └── client/
│ ├── MineifyScreen.java # 游戏内 GUI
│ ├── MineifyKeybinds.java # N 键绑定注册
│ └── audio/
│ └── AudioPlayer.java # 分块缓冲与播放
└── README.md
开发
需要 Java 21。
cd fabric-mod
./gradlew build # 构建模组 JAR
./gradlew runClient # 启动测试 Minecraft 客户端
./gradlew runServer # 启动无头测试服务器
法律声明
本模组旨在用于个人和教育用途。用户需自行负责遵守 YouTube 的服务条款及适用的版权法。
许可证
MIT 许可证 — 详情请参阅 LICENSE。
你是这个资源的作者?登录后可认领此资源。
相似资源
让你能够在世界中的任何位置定位结构。
TerraFirmaCraft (TFC) 是一个全面转换模组,对生存模式进行了彻底的改造与重新设计。
一堆修复
一款适用于你选择的加载器的 Minecraft VR 模组!
为盔甲架添加图形用户界面,允许你配置其姿势和其他属性
所有本应存在的事物
评论 0
登录后参与评分
还没有评论,来抢沙发吧