二次开发 开源 工具 MineKUmusic - 更好的全服音乐 - 完美适配跨服情境 1.7.0

生存挖矿时分享一首喜欢的歌，建造时听大家轮流点播，或者在大厅里边聊天边听音乐。

MineKUmusic 将个人音乐播放器与全服音乐频道放在一起。玩家既可以自己听歌，也可以加入服务器的公共频道，和其他人听同一首歌。

想一起听，就加入；想自己听，退出后接着播放自己的音乐。

功能一览

• 自愿加入的全服音乐频道，支持个人播放状态保存与恢复。
• 个人音乐支持网易云、QQ 音乐、酷狗。
• 全服频道支持网易云与 QQ 音乐，搜索时切换音源。
• 管理员在游戏内调出二维码，扫码登录全服音源账号。
• 歌曲封面、逐字歌词、3D 歌词和灵动岛显示。
• 全服队列、点歌人、收听人数、撤回待播歌曲与投票切歌。
• 聊天点击点歌、搜索翻页、点击加入频道与点击投票。
• Paper 独立服与 Velocity 群组服两种部署方式。
• 可选 Vault 点歌收费，金额、币名与点歌规则可配置。
• 中文配置注释、自定义聊天文案与配色、配置热重载。

自己听，或者大家一起听

按 M 打开播放器，进入“全服音乐”，即可查看当前歌曲和待播队列。

首次进入服务器默认不加入频道，加入选择会按服务器或群组记住。有人点歌成功时，聊天框会出现歌曲公告，点击其中的“加入全服音乐”就能参与。

加入前正在听个人音乐？播放器会保存你的个人队列、曲目、进度和播放状态，退出频道时恢复。

频道中的暂停只影响本人收听，恢复时跟上频道进度；音量也由每位玩家自己控制。

搜歌、点歌，都在游戏里完成

全服搜索页可以在 网易云音乐 和 QQ 音乐 之间切换，搜索结果直接点播。个人搜索结果和歌单中的全服点歌按钮，也可以把喜欢的歌加入公共队列。

喜欢用聊天指令？同样支持：


结果支持点击点歌、悬停查看歌曲信息，以及上一页、下一页。点歌后还能在队列里看到歌曲与点歌人，撤回自己尚未播放的歌曲。

个人音乐另有 网易云 / QQ / 酷狗 三种音源可选，个人账号与全服频道账号分开使用。

一首歌，大家投票决定是否切换

切歌按 已加入频道人数的 15% 计算，向上取整，至少需要 1 票。

例如频道内有 10 人，需要 2 票；有 20 人，需要 3 票。仅在线、没有加入频道的玩家不计入人数。

聊天中会显示投票进度，并提供可点击的投票按钮。达到门槛后切歌并公告，换歌后重新计票。

默认每人最多保留 3 首待播歌曲，成功点歌间隔 30 秒，队列限额和冷却可由服主调整。

群组服共享一个音乐频道

大厅、生存服、资源服的玩家，可以加入同一个频道，查看同一份队列、轮流点歌。

在 同一个 Velocity 代理连接内切换后端，保留频道选择并继续收听。

免费模式只需在 Velocity 安装代理插件；启用点歌收费后，在 Folia 后端增加经济桥接插件，由代理统一管理队列与点歌流程。

可选点歌收费，接入现有经济

可以免费开放点歌，也可以通过 Vault 经济接口对接服务器现有经济插件。

只对成功提交的全服点歌收费，搜索、查看队列、加入收听和投票免费。

点歌前弹出费用确认，显示需要扣除的金额和币名，玩家确认后继续处理。收费默认关闭；启用后默认每首 10 KU币，金额和货币显示名称都能修改。

费用与入队结果由服务端核对，客户端负责展示和确认。群组服收费支持后端经济桥接，各后端经济插件需共用余额数据。

管理员扫码配置全服账号

管理员在游戏内执行：


关闭聊天栏后，客户端显示对应音源二维码，用手机应用扫码并确认即可配置全服账号。

也支持浏览器导出的 Cookie JSON 数组，网易云和 QQ 分别保存在独立文件中。歌曲可播放范围由对应音源账号权限决定，玩家个人登录用于个人音乐。

歌词和播放器，也融入游戏画面

保留 DangoMusic 的播放器界面基础，提供歌曲封面、逐字歌词、3D 歌词、灵动岛和页面过渡动画。

歌词大小、距离、发光、动态效果、播放器音量和快捷键等，均可在设置中调整。频道页面提供“减少频道动画”选项。

中文配置，消息与配色自己定

配置文件附带逐项中文注释，可以调整频道名称、队列上限、点歌冷却、收费金额及币名。

帮助、搜索结果、点歌公告、加入按钮、投票和提示文字，都可以在独立语言文件中修改。主题色支持颜色名及十六进制颜色值。


指令支持 Tab 补全；管理员可热重载常用配置、聊天语言与配色，保留当前播放和队列。

安装与版本

• 客户端：Minecraft 26.2 / 26.3，Fabric 或 NeoForge。
• 独立服：Paper系 26.2 / 26.3。
• 群组服：Velocity 4.3.0。
• Java：25。

玩家安装对应版本与加载器的客户端 Mod，服务端安装 Folia 或 Velocity 插件。Fabric 客户端同时安装对应版本的 Fabric API，播放器界面与歌词使用 OpenGL。

收听全服音乐需要配套客户端 Mod。没有安装的玩家仍可正常进入服务器。



下载、文档与反馈

• 下载发行版本
• GitHub 开源仓库
• 部署与配置说明
• 玩家使用说明
• 问题反馈

项目来源与致谢

本版本由小乐开发，基于 Sorihiko 的 DangoMusic 修改。

客户端播放器、音乐播放、歌词、界面及加载器适配继承自 DangoMusic；服务端队列、点歌和 Velocity 接入参考 Coloryr 的 AllMusic。保留上游 MuoniumPlayer 界面设计来源说明。

项目按 GPL-3.0 开源，保留原作者署名和第三方许可证，完整来源见仓库内的 CREDITS.md。