二次开发 - 授权转载 - 工具 - 娱乐 - ZMusic CE — 五平台游戏内点歌｜中文提示、Tab 补全、B站内存音频适配

版权类型: 二次开发

插件中文名称: ZMusic-CE

插件英文名称: ZMusic-CE

原帖地址: https://github.com/0XiaoMai0/ZMusic-plugin-v2-CE

支持的核心（服务端）

Spigot
Paper
Purpur

语言支持: 多语言

前置组件: 服务端：无强制额外插件前置。客户端：需要对应游戏版本的 ZMusic Mod（https://github.com/starhui-dev/zmusic-mod）。

适配版本（Java）

最新版本
26.x
1.12
1.8

ZMusic CE
基于官方 2.14.0 的社区版 · 当前版本 2.14.0-CE.6
网易云 / QQ / 酷狗 / 酷我 / 哔哩哔哩游戏内点歌

项目介绍
ZMusic CE 是 ZMusic 的社区二次开发版本，面向 Spigot / Paper / Purpur 系服务端。玩家通过游戏内命令搜索、点歌和查看歌词，服务端向安装了官方 ZMusic Mod 的客户端发送播放数据。

下载与源码
社区版发布包
完整源码与使用说明
官方客户端模组

保留官方作者真心的信息与 GPL-3.0。插件发布包附对应可构建源码，服务器账号、测试世界和构建缓存不进入源码包。

主要功能

网易云、QQ、酷狗、酷我搜索、点歌与歌词，保留个人歌单、全服歌单和原有模组播放协议。
哔哩哔哩独立音轨使用纯 Java 在服务器内存中适配为 MP3，由游戏模组播放。无需 FFmpeg、转码二进制、音频落盘或网页播放器，也不使用旧作者 VIP 转换服务。
中文播放提示、登录说明、网络失败说明和诊断摘要。
/zm、/zmusic、/music 的指令与参数 Tab 补全，按权限显示可用操作。
QQ/微信扫码及 QQ 手机短信登录流程；酷我图形验证码后的账号密码、手机短信登录流程。
自动创建缺少的账号文件，登录成功后保存凭据，初始化和失败登录不会覆盖原账号。
修复 QQ 音乐鉴权、酷我官网请求校验与酷狗账号字段兼容。
无效地址、非音频内容和明显过短的试听片段不会显示播放成功。
官版更新检查已移除，旧配置中的 check-update 自动关闭，避免官版更新提示干扰社区版。

安装与升级

正常停止服务器，备份 plugins/ZMusic 中的配置、账号和歌单。
移走旧 ZMusic Jar，将 ZMusic-CE-2.14.0.jar 放入 plugins；不要同时保留多个 ZMusic Jar。
玩家客户端安装与 Minecraft 版本、加载器匹配的官方 ZMusic Mod。
启动服务器。如需公网 B 站播放或登录二维码，设置 audio-stream.public-url 为客户端能够访问的地址。

公网配置示例：

JSON：

"audio-stream": {
  "enabled": true,
  "bind": "0.0.0.0",
  "port": 18081,
  "public-url": "https://music.example.com"
}

可通过 HTTPS 反向代理连接服务端端口。同机测试可用 http://127.0.0.1:18081，远程玩家不能访问服务器的 127.0.0.1。这是模组音频与临时登录图片的端点，不是网页播放器。

常用命令

代码：

/zm search qq 歌名
/zm play 163 歌名
/zm play qq 歌名
/zm play kugou 歌名
/zm play kuwo 歌名
/zm play bilibili BV1GJ411x7h7
/zm stop
/zm help admin

输入命令后按 Tab 查看子命令和平台。已有搜索结果进入缓存后可补全曲名和编号。密码、验证码和 Cookie 不生成候选。

QQ 登录

代码：

/zm login qq qr
/zm login qq qr wechat
/zm login qq sendcode +86 <手机号>
/zm login qq verify +86 <手机号> <短信验证码>

前两条分别取得 QQ/微信二维码，扫码确认后自动保存音乐凭据。手机号登录需要本人完成平台安全验证并接收短信。QQ 账号密码登录未接入。

酷我登录
先获取图形验证码：

代码：

/zm login kuwo captcha

再选择密码或短信流程：

代码：

/zm login kuwo password <账号> <密码> <图形验证码>
/zm login kuwo sendcode <手机号> <图形验证码>
/zm login kuwo verify <手机号> <短信验证码>

验证码会话需要同一管理员完成。酷我扫码登录未接入。登录需要 zmusic.admin 权限或服务器控制台；控制台不加 /。

其他平台账号
网易云保留官方原有登录方式，默认 direct 模式提供公开音乐接口；扫码、手机/邮箱密码和短信登录需要配置兼容 NeteaseCloudMusicApi 服务。酷狗及已有 Cookie 的导入方法见 GitHub 仓库的音乐账号登录与酷狗账号配置说明。
会员、购买和地区版权权限由音乐平台决定，登录不等于所有歌曲自动解锁。

兼容与验证范围

服务端面向 1.8 至 26.x，使用公开 Bukkit 接口和 Java 8 字节码；中间版本未逐一实测。服务器运行 Java 版本以核心要求为准，构建使用 Java 21。
CE.2 历史验证覆盖 1.8.8、1.12.2、26.2 和 26.3 BETA；旧服验证了实际音乐/歌词消息与官方模组解码核心。客户端仍需对应模组，服务器兼容 1.8 不代表每种旧客户端都有模组。
CE.6 在 Purpur 26.2 正常加载，验证旧更新开关自动关闭；70 项测试通过，1 项可选网络测试跳过。
CE.5 真实接口验证了 QQ/微信二维码及等待状态、酷我图形验证码、错误验证码与无效手机号拒绝。完整账号授权、本人短信接收、密码与会员音乐尚未完成真人验收；成功路径由模拟响应测试覆盖。
QQ“宝宝巴士”和酷我公开样例取得有效 MP3 与歌词。QQ《晴天》周杰伦原唱匿名时没有取得播放地址；酷我《晴天》实测结果为 KTV 伴奏版。
纯 Java 设计兼容 Windows、macOS、Linux；目前实际环境为 Windows。macOS/Linux、代理服和 Folia 未完成运行实测。音频字节探测、模组核心验证与完整游戏听音是不同范围。

常见问题
点歌后没有声音？
检查客户端模组版本、客户端音乐音量、服务器访问音乐平台的网络和歌曲权限；B 站还需检查 public-url 是否可从客户端访问。管理员可以用 /zm diagnose <平台> <歌名> 查看中文摘要。

QQ 有的歌能播，有的不能？
不同歌曲的会员、购买和版权要求不同。没有取得有效播放地址时会明确提示，不能用公开曲目的成功判断所有歌曲可用。

还需要手动关闭官方更新吗？
CE.6 已移除官版更新接口，并自动将旧配置 check-update 保存为 false。/zm update 只显示社区版更新说明。

为什么登录后仍不能播放会员歌曲？
检查账号是否确实有该曲的播放权限，凭据是否有效，以及是否存在额外购买或地区限制。插件不会伪造会员权限。

二次开发授权转载工具娱乐 ZMusic CE — 五平台游戏内点歌｜中文提示、Tab 补全、B站内存音频适配 1.0.1

评分

XiaoMai520 的其他资源

分享资源

最新更新

修复下载文件出现问题

我们重视您的隐私