PeakMusic
PEAK 游戏内音乐播放器:搜索网易云/QQ音乐放歌、3D 悬浮歌词、联机一起听(房主放歌全队同步、队友点歌队列、谁点的歌用谁的会员取流)。支持游戏内扫码登录。进游戏按 F1 打开面板。
| Date uploaded | 2 weeks ago |
| Version | 1.0.2 |
| Download link | TFJSN-PeakMusic-1.0.2.zip |
| Downloads | 289 |
| Dependency string | TFJSN-PeakMusic-1.0.2 |
This mod requires the following mods to function
BepInEx-BepInExPack_PEAK
BepInEx pack for PEAK. Preconfigured and ready to use.
Preferred version: 5.4.75301README
PEAK Music Player(PeakMusic)
在 PEAK 游戏里听歌的 BepInEx 插件 —— 搜索网易云音乐 / QQ音乐直接放歌,3D 悬浮歌词跟着视角走,联机「一起听」全房间同步,游戏内扫码登录。
爬山再累,也要有 BGM。按一下快捷键,搜索框敲歌名,点一行就播——不切窗口、不戴第二副耳机。

功能
-
搜索播放:面板输入歌名/歌手/歌词关键词,点一行即播。网易云音乐、QQ音乐双平台可切换,搜索各查各的、结果分页浏览;免费曲不登录也能放。
-
3D 悬浮歌词:世界空间实时歌词,屏幕两侧交替浮现、逐字点亮,跟着视角走不挡准星。字号 / 高度 / 左右位置 / 离镜头距离 / 已唱·未唱·翻译三色 / 发光强度全部可调,有翻译时副行小字跟随;自动跳过「词:xxx 曲:xxx」这类制作信息行。默认开箱即用,放歌自动出现。
-
联机一起听:全房间装同版本即可用。房主放歌 → 全房间同步播放(进度 / 暂停 / 切歌);队友在自己面板点歌 → 进房主的「♪ 一起听」队列(显示歌名+谁点的),房主点「批准」即播,放完自动接播下一首。
-
谁点的歌用谁的会员:点歌人先用自己的账号取播放直链随点歌发给房主,房主批准时直接播这条直链——房主没有会员也能放客机点的 VIP 曲;免费曲谁点都能放;两边都没权限的付费曲会明确提示原因,不装死。
-
游戏内扫码登录:面板里直接扫码(QQ 音乐 App / 手机 QQ 均可,微信登录的 QQ 音乐账号也支持),手机确认即完成,不用抓包不用复制 Cookie。网易云同样支持扫码。扫不出来还可以「从剪贴板导入」Cookie 兜底。
-
收藏与记忆:♡ 收藏常听的歌随时重播;搜索框带最近搜过的词,点标签直接再搜。
-
面板随心调:标题栏拖动、Ctrl+滚轮缩放(0.7–1.5)、4 款主题配色(丝绒玫瑰 / 午夜石墨 / 极光海 / 曜石红)、折叠成迷你条、位置自动记忆。
截图展示
主面板(F1 打开)——搜索、结果列表、左侧歌词调节与平台切换:

中英文歌都能搜:

切到 QQ音乐标签,搜索只查 QQ 音乐:

扫码登录卡片——支持 QQ 音乐 App 扫码 / 手机 QQ 扫码两种方式:

联机一起听队列——队友点的歌在这里,点「批准」即播:

安装
mod 管理器(推荐):搜 PeakMusic 安装即可,前置 BepInExPack_PEAK 会自动带上。
手动安装:
- 先装 BepInExPack_PEAK(5.4.75301)
- 把压缩包里的
plugins/PeakMusic文件夹复制到PEAK/BepInEx/plugins/下 - 重启游戏,进游戏后按
F1打开面板
使用方法
| 按键 | 功能 |
|---|---|
F1 |
打开/关闭面板(可在配置文件中改键,支持写多个备用键) |
F4 |
3D 歌词开/关(可在配置文件中改键) |
鼠标点击搜索框(或按 T) |
进入输入态打字,回车搜索 |
| 点结果列表某一行 | 播放这首歌 |
Esc |
退出输入态(面板不关) |
| 标题栏拖动 / Ctrl+滚轮 | 移动面板 / 缩放面板 |
面板里可以:
- 切「网易云 / QQ音乐」标签换平台;「未登录」行点开扫码登录
- 左侧实时调节歌词:颜色(含薄荷绿等预设)、高度、左右位置、距离、字号
- 「♡ 收藏」查看收藏列表一键重播;搜索框下点最近搜索标签快速重搜
- 「♪ 一起听」查看队友点歌队列,批准 / 移出
- 右上角切换 4 款主题配色;面板可折叠成一条迷你标题栏
数据文件
%APPDATA%\PeakMusic\cookie.txt 网易云登录态(MUSIC_U 等 3 项)
%APPDATA%\PeakMusic\qq_cookie.txt QQ音乐登录态(musickey 等)
%APPDATA%\PeakMusic\favorites.txt 收藏列表
%APPDATA%\PeakMusic\history.txt 最近搜索词
BepInEx\config\com.peakmusic.probe.cfg 全部配置
- 登录态只存在你自己电脑上,不上传任何服务器;删除文件即退出登录,随时可以自己检查内容
- 收藏 / 搜索历史 / 面板位置都是纯本地文本,重启游戏自动保留
配置项(BepInEx/config/com.peakmusic.probe.cfg)
| 配置 | 默认值 | 说明 |
|---|---|---|
| 界面 / PanelKey | F1 |
面板开关热键,可写多个(如 F1,F8) |
| 界面 / Theme | 0 | 面板配色:0=丝绒玫瑰 1=午夜石墨 2=极光海 3=曜石红 |
| 界面 / PanelScale | 1 | 面板缩放 0.7–1.5(Ctrl+滚轮也能调) |
| 界面 / PanelCollapsed | false | 打开时是否折叠成迷你条 |
| 歌词 / Enabled | true | 3D 歌词总开关(放歌自动出现) |
| 歌词 / Hotkey | F4 |
歌词开关键(别和 PanelKey 撞键) |
| 歌词 / Size | 84 | 歌词字号(屏幕像素高度,2K/4K 自动放大) |
| 歌词 / Y | 0.62 | 句子中心高度,0=屏幕顶 1=屏幕底 |
| 歌词 / Edge | 0.4 | 句子离屏幕边缘的远近 |
| 歌词 / Distance | 12 | 文字平面离镜头多远 |
| 歌词 / ColorLit | A6F07A |
已唱部分字色(十六进制,面板可切换预设) |
| 歌词 / Translation | true | 有翻译时显示副行 |
| 歌词 / FilterMeta | true | 跳过「词:xxx」等制作信息行 |
| 音源 / Platform | 0 | 当前音源:0=网易云 1=QQ音乐 |
改配置文件后需重启游戏;面板上直接点的都是立即生效。
工作原理(给在意安全性的玩家)
- 开源透明:登录、取流、播放的每一行代码都可以在 GitHub 仓库审查,没有混淆、没有闭源组件
- 登录态只存本地:扫码走的是网易云 / QQ音乐官方登录授权;拿到的 Cookie 只写进你本机的
%APPDATA%\PeakMusic\文本文件,不经过任何第三方服务器 - 播放直连官方音源:音频从网易云 / QQ音乐的官方 CDN 直接拉取,mod 不代理、不抓取、不存储音频文件
- 一起听只在房间内通信:队列和播放同步走游戏联机通道(Photon),只同步歌名/曲号/进度这类必要信息;点歌人取的播放直链只发给同房间的房主
- 不改动游戏文件:仅作为 BepInEx 插件加载,不修改任何游戏 DLL,删掉文件夹即彻底卸载
前置
- BepInExPack_PEAK 5.4.75301(mod 管理器会自动安装)
常见问题
- 提示 -110 / 无权限:看提示区分——「还没登录」→ 扫码登录再试;「已登录但没有这首歌的权限」→ 那首是会员/付费曲,换一首或用有权限的账号点
- 一起听对面没声音:确认两边装的是同版本 PeakMusic(启动日志第一行版本号一致)、且在同一房间
- 歌词撞键失效:
[歌词] Hotkey和面板键写成同一个键会自动失效,改开一个就行 - 改了设置没反应:改 cfg 文件要重启游戏
致谢
- BepInEx —— 插件框架
- 感谢所有帮忙测试的朋友们
CHANGELOG
Changelog
1.4.7 (2026-11-15) — 本地一起听 · 系统字体 · 立体感
新增(1.4.6 没有的)
- 本地模式也能一起听:房主开着本地模式在网易云/QQ 放歌时,把「歌名 + 直链 + 进度」发给房间, 队友各自取流播放(同一个文件、时间轴对齐);房主账号取不到直链就只发歌名,队友自己搜同版本。 每 3 秒校准一次,队友整曲下完会按最新进度补跳。晚进房的人会立刻收到当前正在放的歌,不用等房主切歌。 全程后台完成,房主的声音仍然从网易云/QQ 出,游戏里不会重复发声。
- 歌词字体可选:自动读取系统里已安装的字体(注册表 + 字体目录),侧栏新增「字体」按钮,
在 自动 / 雅黑 / 正黑 / 黑体 / 宋体 / 等线 / 楷体 / 仿宋 / Malgun 之间循环;
自己装的字体也能在
[歌词] Font里填名字。非中文 Windows 没有雅黑时会自动换一款能写中文的,不再整块失效。 - 立体感:侧栏新增「立体」按钮(关 / 轻 / 强)。字形加倒角与投影,文字平面再轻微斜置, 转视角时出现透视与视差,不再像「正对相机的纸片」。纯材质参数,不增加网格与绘制调用。
- 长句自动拆行:超过 14 个字时在中点附近找标点或空格断成两行(
[歌词] Wrap);找不到断点就保持原样,不硬切。 - 可选穿透地形:
[歌词] ThroughWall打开后歌词永远不会被山体挡住(会失去远近遮挡感,默认关)。 - 退出自动清理:退出游戏时自动结束 MusicListsGUI / MusicProgressReader / QmLyricsServer, 不再出现 Steam 一直「正在停止」。
修复(1.4.6 存在的问题)
- 晚进房收不到当前歌曲:以前房主只在换歌时广播,队友后进房要等房主切歌才有声音和歌词。 现在房主发现有人进房会补发一次当前歌与进度;同一首歌重复下发时,已经在听的人只校准、不重载。
- 侧栏歌词按钮重叠:新增的「字体」「立体」没有并进界面的两列网格,落回旧坐标压在别的按钮上。 现在 9 个按钮统一排成两列四行 + 末行整宽,歌单区同步下移。
- 主页按钮太小看不懂:标题栏那个裸
⌂换成 88×22 的「⌂ 主页」,窗口按钮也加宽一档。 - 本机歌词偶发误报/错位:探针在更新顶点之前比较,换行那一下会误报「本地歌词不同步」; 已把比较挪到更新之后,并补了 10 个署名行前缀(演唱 / 原唱 / 人声 / 后期 / 封面 等)。
- 管理器装不上(r2modman 报 ENOTEMPTY):她的运行时原先以 974 个松散文件随包,
管理器清缓存时删不掉
_internal\_tcl_data就中断安装。现在压成一个MusicListsGUI.runtime.zip, 首次启动由模组自己解压到BepInEx\PeakMusic\Local\,包内文件数 990 → 17; 解压位置在 plugins 之外,日志也不再刷一堆 Python DLL 加载失败。
优化
- 帧数:去掉每帧的字符串拼接(渲染 key / 歌名歌手 / 灵动岛文字)、每帧反射 (Current、HasClip、EnsureStyles、SetUiPage)与重复解析(颜色同步每帧 9 次 → 只在改色时解析); 「散聚」样式的逐字伪随机改为生成时预算;发光层每帧只换算一次颜色;淡出句不再写逐字进度。 实测歌词层均值 0.05–0.10 ms。
- 歌词样式页底部的「歌词特效」一排已移除(10 种粒子效果观感不佳、也占面板空间); 代码与配置保留,需要时可恢复。
说明
- 本地模式运行时以压缩包随附,第一次启动游戏会自动解压(约 5 秒)并拉起她的面板;
不想自启就把
[本地] AutoStart改成false。 - 「一起听」(含本地模式)要求双方版本一致:旧版收不到新增的进度校准与进房补发。
- 本地模式仍然只读采集:不注入游戏、不接管音频、不修改播放列表。
1.4.6 (2026-11-14) — 本地模式 · 逐字光效 · 灵动岛
新增(1.4.5 没有的)
- 本地模式(与 linlin 合作):面板首页第三张卡。跟着本机网易云 / QQ 音乐正在播放的歌走,
游戏里的 3D 歌词同步显示 —— 不改播放器、不接管音频、也不会广播给联机队友。
数据来自 linlin 的 MusicListsGUI(已随包附带在
plugins/MusicListsGUI/,启动游戏时由她的启动器自动拉起)。 时间轴每 500ms 同步一次,两次轮询之间按本地时钟外推,所以不会一顿一顿。 - 逐字发光:光晕不再整句糊一层,改成唱到哪个字,哪个字才发光;没唱到的是普通白字, 上一句淡出期间也是纯白无光。同一时刻只有当前这一句是亮的。
- 顶部灵动岛:常驻胶囊,显示歌名 · 歌手 / 当前歌词 / 帧率 / 延迟 / 时间。 新增「首页 → 界面设置 → 灵动岛」总开关(嫌它挡游戏 HUD 可以关掉,关掉整条不渲染也不吃点击)。 本地模式下它会显示本机播放的歌名与歌词,并标注「本机跟随」。
- 性能日志:面板开着时每 10 秒往日志写一行
[性能] 近 10s 平均 FPS … · 最低 … · 歌词层均值 …ms,方便对比优化效果。
修复(1.4.5 存在的问题)
- 字号调到最大就回不去、或者点了完全没反应:配置允许的范围上限是 140,而按钮最后一档是 150, 写入被夹回 140 → 永远在 140/150 之间打转。现在范围扩到 16–200、档位补到 180, 并且字号一改就立刻重建当前这一句(以前要等下一句才生效)。
- 样式按钮第一次点击闪一下就关:内核置
StylePickerOpen与 UI 画页面在同一帧, 同一次点击又被卡片接走 → 立刻套用样式并关页。现在「打开样式页的那一帧」不接收任何点击,一次就能打开。 - 本地模式的 3D 歌词和灵动岛/她的面板对不上:以前只在换歌时载入歌词, 而她的歌词是异步补全的(实测同一首歌从 34 行补到 70 行),行号整体错位,屏幕上就会显示别的句子。 现在歌词内容一变就重建,另有「漂移 2 秒自动重建」的兜底。
- 本地模式下灵动岛永远不出现:绘制条件原本只认「我们自己的播放器有歌有 clip」, 本地模式走的是外部播放器,所以开关开着也画不出来。现在内容判定在内核里做,三种来源统一处理。
- 帧率:内核不再重复绘制被新界面完全盖住的老面板(每帧省掉 40+ 次 GUI 调用); 贴墙探测从每帧 60Hz 降到 10Hz;淡出到看不见的句子跳过顶点更新。
说明
- 本包已附带 linlin 的 MusicListsGUI,装完即用,不需要再单独下载。
它只读采集播放状态(不注入游戏、不碰音频);不想让它随游戏自启,
把
BepInEx/config/com.peak.musiclistsgui.launcher.cfg里的Startup/Enabled改成false。 - 本地模式依赖她的辅助进程锁定播放器。如果面板没起来,首页会提示「未检测到」,其余功能完全不受影响。
- 因为附带了她的运行时,包体积从约 0.4MB 涨到约 20MB —— 只影响下载,不影响加载速度。
- 首次启动时日志里会出现一批
Failed to load … _internal\xxx.dll … Skipping, 那是 BepInEx 递归扫描 Python 运行时的正常噪音,不是错误。
1.4.5 (2026-11-12) — 韩文歌词修复 · 自动续播 · 最高音质
修复(1.4.4 存在的问题)
- 点「下一首」跳到不相干的歌,反复点还是同一首:正在播放页的「下一首」按钮正好压在后台列表的命中区上, 点按钮等于点了列表里对应位置的那一行(实测点一次播了第 6 首,再点还是那首)。 现在首页/播放页会把列表、搜索框、侧栏这些看不见的点击区整体关掉;列表页不受影响。
- 切歌顺序不严格:现在「下一首 / 上一首」都按点歌时那份列表的原顺序走 (发如雪 → 晴天 → 兰亭序 → 搁浅 …),不会再被「一起听」队列或上一次的旧下标带偏。
- 播完自动接下一首更稳:如果那一刻还在取播放地址,会记下来、空下来立刻补切,不会把这次续播丢掉; 流式播放拿不到总长时也能按“本来在播、突然停了”判定播完。
- 韩语歌的歌词显示成一排方块:歌词字体原先只加载微软雅黑,它没有韩文字形,
TextMeshPro 找不到字形就画空心框。现在按
malgun → tahoma → 日文字体挂了一条回退链, 用哪个字补哪个;面板里的韩文歌名也一起修好了。顺带解决了泰文、越南文的方块问题。 - 一首播完就停,不会自动接下一首:播放器在结尾会把进度归零,旧判断把「播完」误认成「手动停止」。 现在按播放位置兜底识别结尾,并记住点歌时的列表,播完自动按那份列表往下走;到末尾会明确停下并提示。
- 换歌词样式要等下一句才生效:以前只重建当前句,屏幕上已有的句子仍是旧材质。现在整屏重建,点一下立刻全变。
- 底部控制栏只有中间一小段能点进播放页:改成整条都可点,同时避开停止 / 暂停 / 音量 / 单曲循环四个按钮。
- 左上角 FPS 显示约为真实值的两倍:
OnGUI一帧会跑多次事件导致重复计数,已按帧去重。 - 部分机器上热键完全没反应 / 多个热键写了同一个键会误触发:补上了旧输入系统的兜底, 撞键判断改成按“按键集合”比较。
- 歌词特效点了没有任何反应:粒子坐标是按「屏幕高 = 1 个单位」写的,但那个距离上实际可见高度约 16 个单位, 等于所有粒子只有应有大小的 1/16,肉眼几乎看不见。现在按相机视野实时换算缩放,点一下就能看到效果。
- 亮度调高后颜色全变成纯白:原来是直接把 RGB 乘上亮度再截断,饱和色(粉、紫、青)三个通道一起顶到 255, 色相直接丢失 —— 所以「换什么样式看起来都是白的」。现在提亮时保留色相,只往白里混一点点。
- QQ 音乐收藏同步一直失败(返回 10004):新版接口不再返回加密 uin,导致详情请求少了
enc_host_uin, 服务端认不出账号。现在直接取登录 cookie 里的euin,收藏列表能正常读取。
新增(1.4.4 没有的)
- 只有「正在唱的那一句」发光:3D 歌词每句都是独立材质,现在只有当前句开着光晕, 上一句在淡出期间不带任何发光、统一显示为普通白字;换句时光晕自动移交,同一时刻只有一句是亮的。
- 歌词被地形挡住 / 爬墙时陷进山体:以前文字固定挂在镜头前 12–14 米,前面只要有岩壁就会整句埋进去。
现在每帧从镜头往歌词方向做一次球体探测,命中地形就把歌词压到「镜头与岩壁之间」,
并按
实际距离 / 设定距离等比缩小整体尺寸 —— 屏幕上的字号不变,只是离眼睛更近了。 相机被地形顶进墙里的极端情况也会压到贴脸距离;粒子特效跟着同一距离走。 不想要这个行为可以关[歌词] Occlusion。 - 最高音质自动选择:登录会员后自动按可用权限取最高一档 —— 网易云依次尝试
超清母带 → Hi-Res → 无损,QQ 音乐尝试F000无损;本地解码 FLAC,保留 24bit 位深。 任何一档拿不到都会自动回退 320k,不会出现“开了无损反而没声音”。不需要手动选档。 - 歌词特效层(10 种):星尘 / 花火 / 绘光 / 时计 / 回环 / 心象 / 脉冲 / 波纹 / 极光 / 流星, 纯本地粒子、不依赖任何外部渲染器,在歌词样式页底部点一下立刻切换。
- 「上一首」按钮:播放页新增,和「下一首」左右对称;按当前列表往回退,第一首再退回到最后一首。
- 单曲循环:底部控制栏「↻ 单曲」按钮,开着时一首播完从头再放,不切下一首;手动点「下一首」仍然会换歌。对应
[播放] RepeatOne。 - 歌词样式从 8 套扩到 19 套:新增白描·流光、衬线·书页、等宽·字幕、霓彩·涌光(共 14 套),又补了时计·弧光、云阶·错落、心象·散聚、倾诉·斜行、潮涌·波浪五套「排布型」。
- 新增居中滚动排版:
[歌词] Layout = 1时歌词在屏幕中央逐句上滚(默认仍是两侧交替)。 - 配色与动效分离:样式页新增一排「配色」。点颜色只换颜色(
[歌词] ColorFromStyle = false), 之后点样式卡只换动效(运动方式 / 入场退场 / 字距 / 抖动 / 光晕),颜色保持不变; 点「跟随样式」交还控制权,样式卡重新连配色一起换。 - 排布型(弧排 / 阶梯 / 散聚 / 斜行 / 波浪):改的是每个字的位置和角度(
[歌词] Warp0–5),和配色、动效互不干扰,可以叠着用。
说明
- 无损需要先整曲下载再解码,起播会比 320k 慢 5–20 秒(一首 4 分钟约 30–50MB);
超过 15 分钟的长音轨会自动跳过无损。想恢复秒开把
[音质] QualityLevel设成3即可。 - 极少数 QQ 曲目的无损直链落在只认单一协议的节点上,下载失败会自动换协议重试一次,仍失败则回退 320k(不会没声音)。
- 阿拉伯语 / 希伯来语即使有字形,TextMeshPro 也不做从右到左连写,仍会显示成孤立字母。
- emoji 可能显示成方块(中文字体不含彩色字形)。
1.4.4 (2026-11-10) — UI 三处修正
修复
- 侧栏「我的歌单」与亮度按钮重叠:亮度按钮加高了一行(1.4.0),但歌单列表的起点没跟着下移, 两块直接叠在一起。现在歌单列表起点下移 32px,亮度按钮也改成占满整行(原来只占左半格,右边空着像没画完)。
- 播放栏的按钮是"隐形"的:停止、音量 +/- 三个按钮被硬编码画成"禁用态"(近黑色文字), 在深色底上完全看不见,玩家以为按钮坏了。实际它们随时可以点。 现在按真实状态画:停止在放歌时可点、音量任何时候都能调。
- 面板文字全面改发光样式:所有按钮与时间/音量数字加了 1px 四向光晕(IMGUI 没有真正的发光, 用四层半透明副本近似),6 套主题下的小字都读得出来;禁用态从近黑提到中灰。
1.4.3 (2026-11-10) — 措辞修正
说明
- 文档里把界面缩放写成「自动放大」,容易误解成「固定放大某一档」。实际实现是按玩家分辨率适配:
实际尺寸 = 832 × 屏幕高 ÷ 1080,1080p 下是 1 倍(不变),2K 是 1.33 倍,4K 是 2 倍, 各分辨率下面板占屏比例一致(约 43% 宽、64% 高)。文档、配置说明、manifest 一并改成「适配」说法。 - 顺带修掉 README 里几处过期内容:主题还写着已下架的旧 4 套、缩放范围写成 0.7–1.8(现为 0.85–1.8)。
功能
- 与 1.4.2 完全一致,无需为了这个版本特地升级。
1.4.2 (2026-11-10) — 歌单列表可以滚了
修复
- 侧栏「我的歌单」超过 8 个就点不到:以前只画前 8 行,剩下的提示「+N 个歌单」,没有任何办法翻下去。
现在:
- 滚轮在列表上滚动(一格约 22px,平滑到行边界)
- 列表右侧出现细滚动条,可以拖动(命中区做宽到 9px,好点)
- 点滚动条的空白轨道 = 翻一屏
- 底部改成「滚轮或拖右侧细条 · 共 N 个」,不再有看不到的歌单
说明
- 滚动条只在装不下时出现,歌单少于 8 个时界面和以前完全一样。
1.4.1 (2026-11-10) — 歌词加光晕 + 进退场轨迹
改进(对着 Dango/Folia 的观感做的)
- 白色光晕真正生效:以前只有字面颜色,亮不亮全看配色。现在给歌词材质开启 TMP 的
GLOW_ON, 用[歌词] Glow+GlowStrength(默认 0.6)控制光晕强弱——这是参考模组里"字会发光"的关键一层。 另参考它的默认值,光晕颜色跟随字色、外扩 0.35、衰减 0.55。 - 入场:0.26 秒从锚点下方 0.22 处向上浮入,透明度 ease-out,尺寸 0.94 → 1.0。
- 退场:0.55 秒(原来 0.4)向上飘 0.75、同时远离镜头 0.55,边飘边淡出并放大到 1.07, 像被风带走,而不是原地消失。
- 新增「暖白 #F7E1D7」配色:这是参考模组的默认字色,比饱和色在任何背景上都显亮。
说明
- 光晕/轨迹都不吃 CPU:只是在既有网格上改颜色与位移,没有额外渲染层。
- 字色仍是 9 套预设循环,新增的「暖白」排在最后。
1.3.0 (2026-11-10) — 歌词修复 + QQ 音乐支持
修复
- 3D 歌词突然消失:内置播放器能出声但一句词都没有。原因是跟随模式复用了内置播放器同一个渲染器实例,并在播放时把它清空了。现在两边各用各的渲染器,互不干扰。
- 换歌后歌词错位 / 没词:采集程序会沿用上一首的时长,导致进度被截断、歌词直接跳到结尾;同时读文件失败时会丢掉这次更新,卡在上一首。两处都修了。
- QQ 音乐取不到歌词:取词原来是「开线程死等 8 秒,超时判失败」,网络一慢整首歌都没词。改成后台拉取、拉到就接上;并且新增 QQ 音乐自己的歌词源(谁在放就用谁的词,时间轴才对得上)。
- 歌播完了歌词还挂在屏幕上:采集程序在暂停时仍会持续写文件,界面以为数据"还新鲜"。现在状态不是播放超过 5 秒就自动收掉。
- 歌词抓取偶发失败:原来失败要等 60 秒才重试,现在 8 秒就重试。
改进
- 顶部歌词卡默认贴屏幕最顶端,不再压在画面中间挡视野。
- 切换热键可自定义:
Follow.Hotkey,默认F8。 - 配置文件支持热重载——改完保存即生效,不用重启游戏。
- 手动歌词偏移
Follow.LyricOffsetMs(默认 0,一般不用动)。
说明
- 跟随本机播放器现在是实验功能,默认关闭(
Follow.AutoStart = false)。原因:QQ 音乐有系统媒体时间轴最准;酷狗的时间轴是空的,进度只能靠推算;新版网易云不上报系统媒体控制,暂时无法支持。想要的话把AutoStart改成true。 - 核心功能(搜索播放 / 会员歌曲 / 歌单同步 / 3D 歌词 / 一起听)完全不受影响。
1.2.1 (2026-11-09) — 稳定性修复
修复
- 进游戏没有歌词卡 / 采集进程秒退:游戏自动拉起
PeakMusic.NowPlaying.exe时没有控制台窗口,日志写入会抛IOException(句柄无效)把整个进程带走。现在无控制台时自动静音,输出失败也不再影响采集。 - 采集进程挂掉后不会恢复:新增看门狗,进程意外退出自动重启,最多 5 次,间隔 10 秒;连续失败后停止并写日志,避免无限重试。
- 看门狗不拖帧:进程枚举限制为 5 秒一次(
GetProcessesByName要遍历全部进程,每帧调用会掉帧)。 - 你自己手动启动的采集进程不会被自动重启抢走,两者可共存。
说明
- 功能与 1.2.0 完全一致,只补了上面这几处边界。可直接覆盖安装。
1.2.0 (2026-11-09) — 跟随本机播放器(游戏内悬浮歌词)
新增
- 跟随本机播放:
PeakMusic.NowPlaying.exe常驻读取网易云 / QQ音乐 / 酷狗 / 酷我的播放状态,每 0.5 秒写一份music_progress.json;游戏里屏幕顶部浮出一条歌词卡——歌名·歌手、当前一句、下一句、播放进度线。F8 随时开关,按住可拖到任意位置,位置自动记住。 - 进游戏自动启动:
PeakMusic.UI.dll启动时自动拉起同目录的PeakMusic.NowPlaying.exe,退出游戏时一起关掉,不用手动开黑窗口。不想自动启动:BepInEx/config/peak.music.ui.cfg里Follow.AutoStart = false,之后手动双击2-开始跟随.bat。 - 网易云专用 elog 通道:网易云的系统媒体控制(SMTC)进度会反复归零、播放状态只推一次,不能用来计时。改读
%LOCALAPPDATA%\NetEase\CloudMusic\cloudmusic.elog(字节置换解码,无密钥),进度和播放/暂停以播放器内部日志为准。 - 预测计时 + 跳变校准:所有平台都用本地计时器累加,只有检测到 elog / SMTC 的位置跳变超过 1.2~1.5 秒才校准;避免 500ms 采样抖动让歌词来回跳。
- 格式完全兼容 PeakFloatingLyrics:
music_progress.json的字段(status / title / artist / positionMs / endMs / lyrics / lyricsSource)与她那套逐字段一致,可以直接把我们的 exe 换掉MusicProgressReader.exe,她的 mod 不用改。 --diag一条命令诊断:窗口有没有找到、elog 在不在、进度/状态/时长/歌名各读到什么,一眼看清哪一环断了。
说明
- 歌词仍走严格匹配:歌名归一化后必须完全相等,歌手必须匹配,时长差超过 6 秒直接放弃。宁可没歌词,不给错歌词。
- 多播放器同时开:锁定第一个找到的窗口,不自动切换,避免两个播放器互相抢。
- 浮层与主面板完全解耦:不碰 PeakMusic 的任何字段,纯 IMGUI 叠加;
NewPanel = false用经典界面时浮层照样显示。 - 采集进程的 JSON 超过 8 秒没更新会自动隐藏浮层,不会停在最后一帧。
1.1.0 (2026-11-09) — 全新界面(深色侧栏 + 浮动播放条)
新增
- 新面板 PeakMusic.UI.dll:接管原面板绘制,改成深色玻璃风格 —— 左侧 200px 侧栏(平台切换 / 我的收藏 / 一起听 / 歌词设置 / 账号卡),主区页头 + 搜索 + 8 行歌曲列表 + 底部浮动播放条。
- 行内信息重排:每行「序号 · 封面 · 歌名(上)+ 歌手(下)· 时长 · 会员标 · ♡」,播放中的行左侧有强调色竖条 + ▶ 标记。
- 平台配色:切到网易云整体强调色变红,切到 QQ 音乐变绿,侧栏和列表标记同步。
- 一键回退:
BepInEx/config/peak.music.ui.cfg里NewPanel = false回到 1.0.4 的经典界面,或直接删掉PeakMusic.UI.dll。
说明
- 交互逻辑完全没有重写:点击、滚动、翻页、输入、拖拽、缩放、扫码登录仍然走原面板,新 DLL 只负责「画」和「重排坐标」,所以搜索/播放/一起听的行为和 1.0.4 完全一致。
- 新界面固定深色(不跟随经典界面的主题切换);经典界面仍保留原主题系统。
- 面板逻辑尺寸仍是 832×722,缩放沿用标题栏
+/−或 Ctrl+滚轮。
1.0.4 (2026-11-09) — QQ 音乐「有会员还是播不了」根因修复
修复
- QQ 会员曲空直链(主因):取流请求的
comm里只有uin,没有authst(=qqmusic_key)、g_tk(= hash33(key))和tmeLoginType,服务器只认成"某个 uin 在请求",认不出绿钻身份 —— 会员曲一律返回空purl(面板 -110 /result=104003)。现在登录后优先走桌面客户端通道music.vkey.GetVkey / UrlGetVkey(ct=19 / cv=2201+ 三件套鉴权字段),filename一次请求M500/M800两档,能拿到哪档用哪档;桌面通道失败再回到原有 Web 降级链,不影响免费曲。 - 登录态判定用错接口:
GetUserInfo只看 uin,key 过期了也显示"已登录"。改用GetLoginUserInfo(会校验authst),过期能准确提示重新扫码。 - 失败提示补充桌面通道原因:区分「登录态失效」「无版权 104003」「需单独付费 104004」「CDN 拒绝下载」。
media_mid缺省兜底:桌面通道和 Web 通道都必须用media_mid拼文件名,搜索/联机数据缺失时仍会自动查单曲详情补齐。
验证
- 未登录免费曲链路回归通过(游客搜索/取流行为不变)。
- 桌面通道请求结构已验证:服务器返回业务错误码(104003),不是协议错误,说明
authst/g_tk/tmeLoginType字段格式正确。 - 会员曲整曲取流需要真实绿钻账号实测(沙箱没有)。
1.0.3 (2026-11-09) — 网易云「有会员却提示没会员」修复
修复
- 网易云会员曲取不到直链 / 只放 30 秒(主因):插件保存 cookie 时只留了
MUSIC_U/__csrf等 5 个字段,把os=pc、appver、deviceId、channel全丢了。网易云靠这几个字段判断"这是不是 PC 客户端",缺了就把请求当普通网页游客 —— 会员账号也不认:会员曲要么直接返回-110(面板提示没有权限),要么只给 30 秒试听片段。现在会保留全部 cookie,并自动补齐官方 PC 客户端的那套设备字段。 - 登录后看不到会员状态:新增账号查询(
/api/nuser/account/get的vipType)。面板登录行会直接显示「网易云已登录 · 黑胶VIP」/「非会员」/「登录态已失效」,一眼就能看出服务器到底认没认这个会员。 - 30 秒试听被当成整首播放:
freeTrialInfo非空时以前也返回成功,播放器放 30 秒就断。现在会把试听判为失败并明确提示,不再假装在放整首。 - 设备号每次随机:扫码登录和取流每次用不同的
deviceId,登录态和会员权益对不上。现在设备号落盘复用(%APPDATA%\PeakMusic\netease_device.txt),登录、搜索、取流共用同一个。 - 触发安全验证(-462):以前会静默变成"搜索 0 首"或"data 为空"。现在搜索/取流都会自动换官方 PC 客户端的 eapi 通道再试(这条路通常不受网页风控影响),仍失败才明确提示"搜索太频繁"。
- 直链可用性校验:拿到地址后先 GET 前 2KB,CDN 404/403 就换下一档音质,不把死链交给播放器。
- 音质降级链:极高 → 较高 → 标准,逐档尝试。
- 换账号残留:切换网易云/QQ 账号时会先清空旧 cookie,避免上一个账号的登录态混进来。
- cookie 导入更宽容:从浏览器复制时带
Cookie:前缀、换行、多余空格都能自动清洗。 - 错误提示更准:区分「登录态失效」「不是黑胶 VIP」「会员是 VIP 但服务器拒绝(无版权/地区限制)」「只有试听」「风控 -462」。
数据文件
- 新增
%APPDATA%\PeakMusic\netease_device.txt(网易云设备号,删掉会重新生成)
1.0.2 (2026-11-09) — QQ 音乐「有会员也放不了」修复
修复
- QQ 音乐 -110 / 播不了(r45):一次修掉三个根因 ——
- 文件名用错了 mid(主因):QQ 音乐 CDN 的文件名格式是
M800/M500 + media_mid + 后缀,media_mid和songmid在版权曲上经常不同(例如《好久不见》陈奕迅songmid=004M3yRr3kOfnS,media_mid=003F61X945THrw)。用 songmid 拼文件名时,会员曲要么 vkey 给空直链(面板显示 -110),要么给了直链但 CDN 直接 404。现在搜索时记下media_mid并用于取流,联机/老数据缺这个字段时自动查单曲详情补全。 - 扫码登录少写
qm_keyst:web 端 vkey 只认qm_keyst,之前 App 扫码只存了qqmusic_key/musickey,服务器就当没登录 —— 会员曲一律空直链。现在自动补齐qm_keyst,并把uin/p_uin/pt2gguin统一成o0xxxx形式(旧登录态不用重扫,取流前会自动补全本地 cookie)。 - 取流请求缺
comm:补上comm(uin / format / ct / cv),并把 guid 落盘(%APPDATA%\PeakMusic\qq_guid.txt),登录和取流共用同一个 guid。
- 文件名用错了 mid(主因):QQ 音乐 CDN 的文件名格式是
- 直链可用性校验:拿到 purl 后先 GET 前 2KB,CDN 404 就换下一档音质,不把死链丢给播放器(以前会出现"看着开始播放但没声音")。
- 登录态失效不再整片灰:cookie 被判无效时自动脱掉 cookie 以游客身份重试,免费曲照常能放,并提示重新扫码。
- 音质降级链:320k mp3 → 128k mp3 → 96k aac → 48k aac,逐档尝试,不再因为申请了高音质整首不放。
- 失败提示更准:区分「未登录」「cookie 没被识别 / 已过期」「确认无版权」「需要单独付费」,不再一律说"当前账号没有这首歌的权限"。
数据文件
- 新增
%APPDATA%\PeakMusic\qq_guid.txt(取流设备号,删掉会重新生成)
1.0.1 (2026-11-09) — 首个公开版本
新功能
- QQ音乐 App 直接扫码登录(r43):面板内新增「改用 QQ 音乐 App 扫码」方式,手机 QQ 音乐扫一扫即可登录;同时保留「手机 QQ 扫码」方式,微信登录的 QQ 音乐账号也支持
- 面板扫码方式一键切换,扫不出来仍可「从剪贴板导入」Cookie 兜底
修复
- 取流「拿不到地址」(r44):部分环境下 Unity Mono 的 Cookie 容器会把登录态发坏,导致已登录却取不到播放直链(网易 404 / QQ -110)——取流请求改为手动拼 Cookie 头,绕开容器;失败提示附带服务器原始响应片段便于排查
1.0.0 (2026-11-08) — 首次上架
修复
- 启动崩溃(r42):超长日志行会打爆 BepInEx 5 控制台编码(UnityInjector.ConsoleEncoding 越界),导致无法进入游戏 —— 日志行已限长
- 一起听·房主点歌不播(r41):扫码登录的登录 cookie(MUSIC_U)此前会丢失,导致点歌人会员权限用不上、免费歌被误报「没有会员」—— 现已真正保存登录态
- 免费歌误报会员(r41):取流加音质降级(网易 exhigh→standard、QQ M800→M500),高音质被会员卡住的免费/低音质免费歌自动降档播放
- 一起听·批准不播(r40):改为点歌人先取播放直链、房主批准时直接播该直链(谁点的 VIP 歌用谁的会员)
- 一起听·全员无声(r39):撤掉下载中途提前起播(Unity 6000.3 流式解码会被打成 Data Processing Error)
- 搜索记忆标签错乱、点歌队列去重、-110 提示按登录态区分(r38–r39)
功能
- 搜索播放(网易云 / QQ音乐)、3D 悬浮歌词(字号/位置/配色可调)、收藏、游戏内扫码登录
- 联机一起听:同步播放/暂停/切歌、队友点歌队列、自动接播