二次开发 授权转载 工具 娱乐 ZMusic-CE——一个支持网易云、酷狗音乐、QQ音乐点歌的版本 1.0.0

## ZMusic CE

ZMusic CE 是基于 ZMusic V2 分支修复和整理的音乐点歌插件版本，主要用于 Minecraft Java 服务端，让玩家可以在游戏内搜索、点歌、播放音乐，并通过 ZMusic 客户端 Mod 接收播放。

本版本主要面向 Purpur / Paper / Spigot 系服务端使用，适合需要在服务器内提供点歌、歌词显示、音乐播放功能的服主。

---

## 源码地址

本资源的修复版源码已公开：


构建方式和修复说明见仓库内 `README_FIXES.md`。

## 主要功能

- 支持游戏内点歌与播放音乐
- 支持网易云音乐相关登录与播放修复
- 支持歌词显示
- 支持玩家自助点歌
- 支持服务端向安装 ZMusic Mod 的客户端发送播放数据
- 修复部分情况下播放失败、登录状态异常、Cookie 处理异常等问题

---

## 安装方法

1. 将插件 jar 放入服务端的 `plugins` 文件夹
2. 启动服务器生成配置文件
3. 停止服务器
4. 修改 `plugins/ZMusic/config.json`
5. 重新启动服务器
6. 客户端需要安装对应版本的 ZMusic Mod，否则无法正常听歌

---

## 重要注意事项

### 使用前请务必关闭自动更新

请打开 `plugins/ZMusic/config.json`，将自动更新检查关闭：

```json
"check-update": false

如果不关闭，服务器可能会在启动时访问作者原接口检查更新。部分服务器网络无法连接该接口时，会在控制台出现类似 Connect timed out 的报错。
该报错一般不影响插件主体功能，但会影响观感，因此建议关闭。

客户端必须安装 ZMusic Mod​

本插件不是单独靠服务端播放声音的插件。
玩家如果想听到音乐，需要安装对应版本的 ZMusic 客户端 Mod。

音乐平台登录说明​

部分音乐平台的会员歌曲、受限歌曲需要对应平台账号本身拥有权限。
插件不会破解官方音乐平台会员权限，只会在账号已具备权限的情况下尝试播放。

B站点歌说明​

当前 CE 版本没有内置本地 B 站转码器，也不包含 ffmpeg 转换资源。
ZMusic-fix-BZ-CE版本包含B站内置转码器，但仅支持Windows和Linux64位使用
CE版的B站相关功能保持原作者的 VIP 转换逻辑，未授权情况下无法使用该部分功能。

常见问题​

1. 控制台出现 Connect timed out 是什么原因？​

通常是插件检查更新时无法连接作者接口导致。
解决方法：关闭配置文件中的自动更新检查：

"checkUpdate": false

2. 玩家点歌后没有声音怎么办？​

请检查：

• 玩家客户端是否安装 ZMusic Mod
• Mod 版本是否与服务端插件兼容
• 客户端音乐/唱片机音量是否开启
• 歌曲链接是否有效
• 服务器是否能正常访问对应音乐平台

3. 登录后仍然无法播放会员歌曲？​

请确认：

• 账号本身是否拥有该平台会员权限
• Cookie / 登录状态是否有效
• 该歌曲是否存在额外版权、地区、试听限制

4. 能不能直接播放所有 VIP 歌曲？​

不能。
本插件不会破解官方音乐平台的会员或版权限制，只会在账号自身有权限的情况下尝试获取可播放链接。

适用环境​

• Java 服务端：Paper / Purpur / Spigot 系
• 推荐 Java：以你的服务端核心要求为准
• 客户端：需要安装 ZMusic Mod

---

免责声明​

本资源仅用于 Minecraft 服务器内的音乐播放体验优化。
请遵守各音乐平台服务条款与版权规则，不要将本插件用于侵犯版权或绕过官方授权的用途。