Mine-ify

模组

· 作者 msedroid

一款适用于 Minecraft Fabric 的模组,支持全服务器范围内的音乐播放。玩家可以搜索 YouTube、将歌曲添加到共享播放列表,并一起收听。

0 本站下载 0 关注 更新于 8 个月前

最新 1.3.1 · 1.21.11 · Fabric

一键开服(送7天)

Mineify - Minecraft 全服音乐播放器

一个 Minecraft Fabric 模组,支持全服音乐播放。玩家可以搜索 YouTube,将歌曲添加到共享播放列表,并在 Minecraft 内实时一起收听。

使用方法

  1. 加入运行了 Mineify 的服务器
  2. 按下 N+M 打开图形用户界面 (GUI)
  3. 在搜索栏中输入歌名并按回车键
  4. 点击结果将其添加到播放列表
  5. 歌曲会自动下载并为所有已连接的玩家播放

工作原理

所有内容均在 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)   │                        │
│  └─────────────────┘    └──────────────────┘                        │
└─────────────────────────────────────────────────────────────────────┘
  1. YouTubeService 直接从 Java 调用 YouTube 的内部 InnerTube API —— 无需 API 密钥。
  2. AudioDownloadService 调用 yt-dlp 作为子进程来下载并将音频转换为 WAV 格式。
  3. 服务器将 WAV 文件分割成块,并通过现有的 Minecraft 连接分发给每个客户端 —— 无需额外开放端口。
  4. 客户端在内存中重新组装这些块,并使用 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 —— 无需额外工具。

安装

服务器端

  1. 为 Minecraft 1.21.11 安装 Fabric Loader。
  2. 在服务器上安装 yt-dlp 和 ffmpeg(参见下方指南)。
  3. 将 Fabric API 和 mineify-1.3.0.jar 放入服务器的 mods/ 文件夹中。
  4. 启动服务器。Mineify 会自动初始化。

可选 — 创建 config/mineify.json 以自定义行为:

{
  "downloadDir": "./mineify-downloads",
  "maxPlaylistSize": 50
}

客户端

  1. 为 Minecraft 1.21.11 安装 Fabric Loader。
  2. 将 Fabric API 和 mineify-1.3.0.jar 放入 .minecraft/mods/ 中。
  3. 使用 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:

  1. 从发布页面下载 yt-dlp.exe
  2. 将其放置在如 C:\yt-dlp 的文件夹中
  3. 将该文件夹添加到系统 PATH

ffmpeg:

  1. 从 gyan.dev 下载
  2. 解压到如 C:\ffmpeg 的文件夹中
  3. 将 C:\ffmpeg\bin 添加到系统 PATH

添加到 PATH (Windows):

  1. 按 Win + R,输入 sysdm.cpl,按回车
  2. 进入高级 → 环境变量
  3. 在系统变量下,选择 Path → 编辑 → 新建
  4. 添加文件夹路径并点击所有对话框中的确定
  5. 重启终端/服务器

验证安装

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。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源