DangoMusic
Introduction: 3D in-world lyrics music player for Minecraft — NetEase Cloud Music, QQ Music & Kugou.
Tags:
在 Minecraft 里听网易云音乐 / QQ 音乐 / 酷狗的 mod：液态玻璃播放器、漂浮在世界里的 3D 歌词、Song card、灵动岛，还能和朋友一起听歌。
A Minecraft mod that brings NetEase Cloud Music, QQ Music and Kugou into the game: liquid-glass player, 3D in-world lyrics, song card HUD, Dynamic Island and Listen Together.
 |
 |
 |
功能
- 播放器（默认按
M，主菜单也能打开）：推荐、排行榜、我的歌单、搜索，列表 / 封面墙两种视图 - 三个音源：网易云 / QQ 音乐 / 酷狗，都在游戏内扫码登录（会员歌曲需要对应平台的会员）
- 歌词：逐字歌词，3D 歌词漂浮在世界里，带发光、抖动、文闪等效果
- Song card / 灵动岛：屏幕上显示正在播放
- 一起听歌：分享房间码，所有人同步到同一首歌、同一秒；国内网络也能用
- 设置都在播放器侧栏的 ⚙ 里，可以绑定快捷键
更新内容见 1.6.0 更新日志。
安装
在 Releases 下载对应版本的 jar，放进 .minecraft/mods，进游戏按 M。
| Minecraft | Fabric（另需 Fabric API） | Forge / NeoForge |
|---|---|---|
| 1.8.9 | — | +1.8.9.jar（Forge 11.15.1.2318，或 Lunar 等客户端） |
| 1.20.1 | +1.20.1-fabric.jar |
+1.20.1-forge.jar（Forge 47.x） |
| 1.21.1 | +1.21.1-fabric.jar |
+1.21.1-neoforge.jar |
| 1.21.11 | +1.21.11-fabric.jar |
+1.21.11-neoforge.jar |
| 26.2 | +26.2-fabric.jar |
+26.2-neoforge.jar |
| 26.3 | +26.3-fabric.jar |
+26.3-neoforge.jar |
26.x 的歌词和播放器界面需要 OpenGL（选 Vulkan 时只能放音乐）。配置和登录信息存在 .minecraft/config/dangomusic/。
构建
需要 JDK 8、21、25，运行 build-all.bat，jar 收集到 dist/（JDK 不在默认位置时设置 DANGO_JDK21 / DANGO_JDK25）。
启用一起听歌（Firebase）
- 在 Firebase 控制台 新建项目，开启 匿名登录，创建 Realtime Database
- 把
firebase.properties.example复制成common/core/src/main/resources/firebase.properties，填上apiKey和databaseUrl - 数据库规则：
{
"rules": {
"rooms": {
"$code": {
".read": "auth != null",
".write": "auth != null && (!data.exists() || data.child('host').val() === auth.uid || data.child('members').child(data.child('host').val()).child('lastSeen').val() < now - 600000)",
".validate": "newData.child('host').val() === auth.uid || newData.child('host').val() === data.child('host').val()",
"members": {
"$uid": {
".write": "auth != null && auth.uid === $uid && root.child('rooms').child($code).exists()"
}
}
}
},
"clock": {
"$uid": {
".read": "auth != null && auth.uid == $uid",
".write": "auth != null && auth.uid == $uid"
}
}
}
}
不配置也能构建，只是一起听歌不可用；只有连同一个 Firebase 项目的人才能一起听。
说明
使用各音乐平台的非官方接口，仅供个人学习交流，歌曲版权归各平台和版权方所有。
第三方：Inter（OFL 1.1）、JLayer（LGPL）、ZXing（Apache 2.0）、Kotlin 标准库（Apache 2.0）。
许可证：GPL-3.0
