Minecraft 音乐客户端 · 两个项目 · v1.6.1 / v2.1

两个客户端,
把音乐装进 Minecraft

MuoniumPlayer 与 Melodify 是同一拨人做的两个客户端,共用同一套「一起听」房间协议 —— 可以进同一个房间,也可以同时装进同一个游戏。它们各自解决不同的问题,没有主次之分。

你可以两个客户端可以进同一个房间、装进同一个游戏、共用十种全屏歌词,也可以两个都装上。

2个客户端
1套共用的房间协议
12个构建产物
15套共用主题预设
正在播放 · 起风了
HI-RES

起风了

买辣椒也用券 · 起风了
01:1205:26

这一路上走走停停

顺着少年漂流的痕迹

迈出车站的前一刻

无损 逐字 灵动岛
MuoniumPlayer 和 Melodify 是同一拨人做的两个客户端,彼此没有主次、也不互相从属 —— 一个把国内曲库和功能做满,一个往海外曲库和环境感知上走。 两边共用同一套「一起听」房间协议,可以进同一个房间,也能装在同一个游戏里同时用。
Two Clients

两个客户端,各自的路

两张卡片并列,没有先后。它们解决的问题不一样,谁也不是谁的升级版 —— 挑一张细看,或者两张对着看。

◆

MuoniumPlayer v1.6.1

国内曲库 · 全功能 · 多版本

把国内平台的曲库和播放器该有的功能做满,覆盖的 MC 版本最多。

  • ◎
    多平台聚合音源网易云、QQ 音乐、酷狗、YouTube Music、哔哩哔哩、汽水音乐、GD音乐台共 7 个内置音源,还能导入 lx-music-desktop 的自定义源脚本。扫码登录、多账号切换、会员状态、听歌历史同步。酷狗搜索、播放、收藏与歌单写入、动态封面都已打通,本版修掉了无损音质下部分歌曲放成另一首歌的错放问题。
  • 𝄞
    逐字歌词TTML / QRC / KRC / YRC / LRC 全格式,逐字上浮、逐字填涂、真高斯动态发光、翻译与罗马音、对唱分行。全屏 10 种样式,桌面 2 种样式。
  • ◐
    灵动岛通知层7 种样式承接 11 类事件:下载进度、切歌、音质、音量、错误、登录、一起听状态…… 还有常驻岛显示帧率、延迟与当前播放。
  • ∞
    Automix 无缝切歌 · 双引擎前一首没结束就把下一首铺进来:可选原版智能淡化,或新增的 Folia Automix(Beat This! / HTDemucs 模型分析、四类过渡、双 Deck 预滚);重叠时长、小节对齐、低频交换、去人声淡入、节奏锁定、音高跳跃全部可调。
  • ♫
    一起听房间服务器房间支持点歌排队、投票切歌、权限管理,还能和 Melodify 客户端混在同一个房间里(另有网易云官方房间一条路);1.6.0 起房间内也能无缝交接 —— 一台真分析,全房执行同一份计划。
  • ✦
    Skia 独立渲染层不套 Minecraft 那套像素 UI,自带 Skija 渲染管线与 17 款内置字体;15 套主题预设、逐项调色板覆盖、系统字体随便换。各平台品牌标识用的是真正的矢量字标,不是拿正文汉字顶替。
1.20.1 / 1.21.1 / 1.21.11 / 26.2 Fabric · Forge · NeoForge 8 个构建
♬

Melodify v2.1

海外曲库 · 环境感知 · 节拍同步

往海外曲库和「会感知环境」的方向走,多了几样 MuoniumPlayer 没有的玩法。

  • ▶
    YouTube Music 内置源无需登录即可搜索与播放,补海外曲库、或没有国内平台账号时的备用源。自实现签名时间戳,只取 audio/mp4 自适应流并优先选最高码率。
  • ✦
    Cadenza 全屏歌词词云样式:当前句的词撒到屏幕中央做螺旋避让,hero 词居中、唱到的字描光晕、唱完的词向外漂移并淡出。
  • ◌
    Ambient Mood 自动切歌按游戏环境打标签:下界 / 水底 / 夜晚 / 建造 / 战斗 / 探索…… 决策树带强制优先级,返回的标签直接做歌曲筛选。
  • 𝆑
    Beat 分析 + EmbeatMLP离线 BPM 与节拍相位估计(自相关 + 脉冲拟合),让 crossfade 落到两首的 kick 上;心灵感应里还有纯 Java 前向的 EmbeatMLP 推理。
  • ⇄
    同房间互通与 MuoniumPlayer 共用房间协议(varint 分帧 + JSON 消息),两个客户端可以进同一个房间,成员角标区分来源。
  • ⚙
    构建 / 依赖Maven group yun.shan,产物名 musicplayer-*-2.1.jar;1.20.1 与 1.21.11 各出一版(Fabric / Forge),共 4 个 jar。
1.20.1 / 1.21.11 Fabric · Forge 4 个构建
两张卡片是对等的。 两个客户端由同一拨人开发、共用同一套「一起听」房间协议:可以分别装给不同的人,也可以装在同一个游戏里同时用。 逐项差异见 Melodify 文档里的对比表 →
Ecosystem

一个房间,三个项目一起跑

同一个服务器房间协议,两个客户端 + 一个服务端并列成三件,按需各装各的。

◆

MuoniumPlayer 客户端

v1.6.1 · 8 个构建(1.20.1 / 1.21.1 / 1.21.11 / 26.2 × Fabric / Forge·NeoForge)。 7 内置音源、逐字歌词、灵动岛、Folia Automix、15 主题,覆盖的 MC 版本最多。

♬

Melodify 客户端

mod_id melodify · v2.1(Fabric / Forge)。 与 MuoniumPlayer 共用同一套房间协议,两个客户端能进同一个房间混用。

⇄

MusicParty 服务端

mod_id mpsync · v1.2.0 · 16 个构建(4 版本 × Fabric / Forge / NeoForge / Paper)。 托管房间与全房时钟,从不访问任何音乐平台,只校验并转发成员解析出的链接。

房间是跨版本、跨客户端的。 成员列表用两字角标区分来源(MP = Melodify、Mu = MuoniumPlayer), 服务器核心 1.21.1 时 1.20.1 客户端照进;老客户端仍能听、能点歌,只是看不到新界面。详见 一起听使用指导 →
Listen Together

和服务器里的人听同一首歌

服务器房间那条路两个客户端都能进,也可以混着用;网易云官方房间那条是 MuoniumPlayer 独有的。

服务器一起听房间 两个客户端通用

需要服务器装 mpsync 组件 —— 主 Mod 仍是纯客户端
  • 自动跟随播放进度,点歌排队、投票切歌(>50%)、投票踢人(>80%)
  • 创建 / 公开房间、服务器频道、直接邀请在线玩家
  • 成员管理:授予管理员、转让房主、移出成员
  • 个人暂停:只静音你自己,房间照放,别人不受影响
  • 缺会员曲可由服主配 Token,或由开启「贡献会员解析」的玩家在本机解析后上传临时直链 —— Cookie 不上传

网易云官方一起听 MuoniumPlayer 独有

需要登录网易云账号,且当前是网易云源
  • 任何网易云用户都能进,包括没装 Mod 的人
  • 分享链接 / 邀请码 / 房间号#邀请人ID 三种加入方式
  • 房间页显示成员、曲目与进度
  • 不能自动跟随主机暂停与切歌,要在房间页点「同步一次」
完整说明与命令表 →
Both Clients · Lyrics

十种全屏歌词,两个客户端共用

左边点一样,右边这个舞台就按那套动效实时演给你看 —— 逐字填涂、光带扫过、阶梯递进、上下镜像、摆弧、气泡都在动,也会自己轮播。 取词按 AMLL TTML → QRC → KRC → YRC → LRC 的优先级,两个客户端跑的是同一套渲染。

Minecraft · 全屏歌词 起风了 · 买辣椒也用券
起风了

这一路上走走停停

顺着少年漂流的痕迹

顺着少年漂流的痕迹

迈出车站的前一刻

悬停或点开就停住轮播

真录屏 · Automix 无缝切歌 + 全屏歌词

上面那个舞台是照样式还原的 CSS,这一段是真机录屏:前半段 Automix 无缝切歌的音频过渡,歌与歌之间自然衔接;后半段是全屏歌词的逐字滚动与流体背景。1280×720 · 30fps · 约 61 秒 —— 按播放才开始加载,不占首屏。

逐字歌词动态发光:重写前后对比
动态发光 · 真高斯前后
律动词云心象的参数面板
心象 · 6 槽调色板
逐行滚动的参数面板
逐行滚动 · 柔和度
群唱样式的参数面板
群唱 · 和声分行

每种样式都有自己的一套专属参数 —— 心象的 6 槽调色板与每色节拍数、倾诉的气泡宽度 / 头像来源 / emoji 概率、时计的摆弧半径与角度、群唱的对唱展开度。逐字歌词的动态发光是真高斯实现,不是叠加模糊的近似。

桌面歌词 Blossom 样式

桌面歌词 OSD

经典 与 Blossom 两种。Blossom 是毛玻璃卡片:可见行数、模糊强度、面板底色、踩点描边与强度,卡拉 OK 过渡的填涂宽度 / 脉冲 / 平滑 / 对唱展开度都可调。

游戏内 HUD 设置界面

HUD 歌曲信息栏

按 H 打开编辑器:拖动定位、滚轮缩放、一键恢复默认,歌词颜色、发光、缩放、间距、透明度与动画参数实时调。显示封面、歌名、歌手、进度与播放状态。

Both Clients · Dynamic Island

所有事情都从岛上告诉你

右边这块是演示台:点样式、点事件,岛就当场展开给你看,也会自己轮播。 想看清「播放器收起合进岛」那一下,点下面那个按钮。

7 种样式
11 类事件
  • 常驻岛帧率、服务器延迟、系统时间、正在播放信息,状态页与播放页轮换,停留时长可调。
  • 收起合并播放器收起时动画连续合并进灵动岛,带 Apple 式撞击反馈;低帧率下自动进 Balanced / Low / Minimal 档位。
  • 共享一套参数封面圆角、内边距与展开宽度这套体系 7 种样式共用,逐项可调。
灵动岛封面与间距设置

真机设置页 · 封面与间距

演示台是照样式还原的,这一张是真机里的灵动岛设置。

↓ 正在下载起风了 · FLAC 62% · 3.4 MB/s
起风了买辣椒也用券
FPS 240 · 延迟 38ms · 21:04
Both Clients · Appearance

15 套主题,字体随便换

两个客户端共用同款预设。每套都能单独覆盖背景、文字、强调色、输入框、导航栏、边框,实时预览,随时恢复原色。

曜石红 极光海 丝绒玫瑰 瓷白墨 液态玻璃 极光霜蓝 午夜石墨 暮色琥珀 鼠尾草雾 珍珠晨曦 缃云晴川 沧溟玉釉 霜纨岫烟 玫瑰月白 青岚云脂

界面字体

内置字体(随 jar 附带 17 TTF + 2 OTF)、系统已安装字体、外部 TTF / OTF 文件、 或丢进 config/muonium/fonts/。点一行立刻生效,不用重启;行高锁住不会乱排版, 缺字由内置字体接住,不出豆腐块。

界面行为

缩放 70%~100%(5% 步进)+ 窗口自适应;开关栏目的淡入淡出与切换动画速度可调; 左侧导航 + 内容页滚动、全屏播放页、Coverflow 封面墙浏览。

Downloads

两个客户端,各支持哪些版本

覆盖的版本数量不同,是两边目标不同,不是谁高谁低。点任意一行跳到对应的下载入口。

MuoniumPlayer v1.6.1

4 个 MC 版本 × 2 个加载器 = 8 个构建

Melodify v2.1

2 个 MC 版本 × 2 个加载器 = 4 个构建

MuoniumPlayer 目前只发布 Windows x64。 发布包只内置了 Windows x64 的图形原生库 —— 这不是配置问题,macOS 与 Linux 下渲染层会整体停用, 表现为「游戏能进、界面出不来」。
Privacy

你的账号凭据只留在你自己的电脑上

凭据不上云

账号凭据存在 .minecraft/config/muonium/,界面不显示 Cookie 明文, 不会上传到任何第三方。

贡献会员解析只传直链

默认关闭。开启后客户端在本机解析出播放链接, 只上传带签名、有时效的临时地址,Cookie 永不离开本机。

不会自动替换 jar

更新检查最多每 30 分钟一次、只在主菜单提示一次;1.6.1 起的公告中心读的是同一份清单、同一次匿名 GET,本机只记「哪些条目看过」,可以「先不更新」跳过版本,但检查本身不可关闭。 客户端永远不会自动下载或替换 jar,下载页还有域名白名单。

自定义脚本仍在 JVM 里执行。 1.6.0 起脚本跑在 Rhino 沙箱里并有宿主侧预算封顶,但仍能发任意网络请求 —— 只导入你信得过的来源。
Community

两个客户端,共用同一间小屋

Melodify 和 MuoniumPlayer 是同一拨人做的,所以据点也只开了一间。报问题、提建议、随口说点想法,都从这里进。

QQ 交流群 · 27635246

「Melodify & MuoniumPlayer 的联动小屋喵」

房间一直开着。有问题进来说问题,没问题进来聊音乐也行 —— 你的每条反馈我们都会看到。

  • 01
    报问题崩溃、卡顿、歌词不动、音源解析失败 —— 带上版本号与日志发上来,我们直接看日志定位。
  • 02
    提建议想要什么功能、哪一步交互别扭、哪个默认值不合理,说了就会记下来排期。
  • 03
    说想法界面、主题、音源脚本、联机玩法…… 半成品的念头也欢迎,不少功能就是这么来的。
  • 04
    抢先看新版本、测试构建和正在做的东西,通常先在群里露面。
一键加群 →

两条路,挑一条就行

选好版本 → 装前置 → 把 jar 丢进 mods → 按右 Shift。两个客户端也可以一起装,房间里照样能混。

下载 MuoniumPlayer → 下载 Melodify →

安装与上手 →