
PeakMusic
PEAK 游戏内音乐播放器:搜索网易云/QQ 放歌,会员曲自动用你账号的最高音质(最高无损 FLAC),歌单/收藏同步,3D 世界空间歌词(19 套样式、逐字发光、可选系统字体与立体感、贴墙避让),自动续播与单曲循环,联机一起听(本地模式也能一起听),顶部灵动岛,本地模式(内附 linlin 的 MusicListsGUI)。按 F1 打开面板。PEAK Music Player(PeakMusic)
在 PEAK 游戏里听歌的 BepInEx 插件 —— 搜索网易云音乐 / QQ音乐直接放歌,会员账号能放会员曲,歌单与收藏同步,3D 悬浮歌词跟着视角走,联机「一起听」全房间同步,游戏内扫码登录。
爬山再累,也要有 BGM。按一下快捷键,搜索框敲歌名,点一行就播——不切窗口、不戴第二副耳机。

界面
默认是新版深色面板:左侧栏放平台切换、我的收藏、一起听和歌词设置,底部一张账号卡;主区是页头 + 搜索 + 歌曲列表 + 浮动播放条。
不喜欢或遇到问题,两种方式回到经典界面:
- 打开
BepInEx/config/peak.music.ui.cfg,把NewPanel = false,重进游戏; - 或者直接删掉
BepInEx/plugins/PeakMusic/PeakMusic.UI.dll。
两种方式都不影响搜索、播放、歌词和一起听 —— 新界面只换「画法」,不换「逻辑」。
功能
-
搜索播放:面板输入歌名/歌手/歌词关键词,点一行即播。网易云音乐、QQ音乐双平台可切换,搜索各查各的、结果分页浏览;免费曲不登录也能放。
-
会员账号直接放会员曲:用你自己账号的权限取流。面板底部实时显示登录态(已登录 · 黑胶VIP / 非会员 / 登录态已失效),会员曲能不能放一眼看清,不会「点了没反应」。
-
歌单与收藏同步:登录后同步你在客户端里的「我喜欢的音乐」和自建/收藏歌单,面板里直接翻歌单点播,不用每次重新搜。同步失败会在状态行说明原因,不静默失败。
-
3D 悬浮歌词:世界空间实时歌词,屏幕两侧交替浮现、逐字点亮,跟着视角走不挡准星。字号 / 高度 / 左右位置 / 离镜头距离 / 已唱·未唱·翻译三色 / 发光强度全部可调,有翻译时副行小字跟随;自动跳过「词:xxx 曲:xxx」这类制作信息行。默认开箱即用,放歌自动出现。
-
联机一起听:装了同版本的人之间同步(谁装谁听得到,没装的人本来就没有音频通道)。房主装模组时:房主放歌 → 全员同步播放(进度 / 暂停 / 切歌);队友在自己面板点歌 → 进房主的「♪ 一起听」队列(显示歌名+谁点的),房主点「批准」即播,放完自动接播下一首。房主没装模组时:不再把你卡在「等房主批准」,点歌直接在你本机播放(只有你听得到),面板页脚会写明当前状态。
-
谁点的歌用谁的会员:点歌人先用自己的账号取播放直链随点歌发给房主,房主批准时直接播这条直链——房主没有会员也能放客机点的 VIP 曲;免费曲谁点都能放;两边都没权限的付费曲会明确提示原因,不装死。
-
游戏内扫码登录:面板里直接扫码(QQ 音乐 App / 手机 QQ 均可,微信登录的 QQ 音乐账号也支持),手机确认即完成,不用抓包不用复制 Cookie。网易云同样支持扫码。扫不出来还可以「从剪贴板导入」Cookie 兜底。
-
面板随心调:界面按你的分辨率自动适配 —— 面板按 1080p 设计,实际尺寸 = 832 × 屏幕高 ÷ 1080,所以 2K 会自动变成 1.33 倍、4K 变成 2 倍,各分辨率下占屏比例一致(约 43% 宽、64% 高),大屏上不会缩成一小块。字号与次要文字的对比度都调过(深色底上不费眼);标题栏拖动、Ctrl+滚轮再乘一档(0.85–1.8)、6 套主题配色(钛银灰 / 冰川蓝 / 翡翠夜 / 霓虹紫 / 琥珀金 / 赤霞橙)、折叠成迷你条、位置自动记忆。
-
最高音质自动选择:登录会员后自动取账号能拿到的最高一档 —— 网易云依次尝试超清母带 / Hi-Res / 无损,QQ 音乐尝试无损 FLAC;本地解码并保留 24bit 位深。任何一档拿不到都会自动回退 320k,不会出现「开了无损反而没声音」。想强制 320k 就把
[音质] QualityLevel设成3。 -
歌词字体与立体感:侧栏「字体」按钮在系统已安装字体之间循环(自动 / 雅黑 / 正黑 / 黑体 / 宋体 / 等线 / 楷体 / 仿宋 …),自己装的字体也能在配置里填名字;「立体」按钮给字形加倒角、投影与轻微斜置,转视角时有透视 —— 不再像贴在屏幕上的纸片。两项都只改材质参数,不增加绘制调用。
-
自动续播 + 单曲循环:从搜索结果 / 收藏 / 歌单任一入口点歌,播完自动按那份列表往下走,面板关着也照常切;到列表末尾会明确停下并提示,不会莫名绕回第一首。底部控制栏「↻ 单曲」按钮切换单曲循环(开着高亮)。
截图展示
主面板(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音乐」标签换平台;「未登录」行点开扫码登录
- 左侧实时调节歌词:颜色(含薄荷绿等预设)、高度、左右位置、距离、字号
- 「♡ 收藏」查看收藏列表一键重播;搜索框下点最近搜索标签快速重搜
- 「♪ 一起听」查看队友点歌队列,批准 / 移出
- 右上角切换 6 套主题配色(按钮上直接显示当前主题名);面板可折叠成一条迷你标题栏
数据文件
%APPDATA%\PeakMusic\cookie.txt 网易云登录态(MUSIC_U / __csrf 等,完整保留)
%APPDATA%\PeakMusic\netease_device.txt 网易云设备号(os=pc / appver / deviceId,删掉会重新生成)
%APPDATA%\PeakMusic\qq_cookie.txt QQ音乐登录态(qm_keyst / musickey 等)
%APPDATA%\PeakMusic\qq_guid.txt QQ音乐取流设备号(删掉会重新生成)
%APPDATA%\PeakMusic\favorites.txt 收藏列表
%APPDATA%\PeakMusic\history.txt 最近搜索词
BepInEx\config\com.peakmusic.probe.cfg 全部配置
- 登录态只存在你自己电脑上,不上传任何服务器;删除文件即退出登录,随时可以自己检查内容
- 收藏 / 搜索历史 / 面板位置都是纯本地文本,重启游戏自动保留
本地模式(与 linlin 合作)
面板首页第三张卡「本地模式」:跟着你电脑上网易云 / QQ 音乐正在播放的歌走, 游戏里的 3D 歌词同步显示,不改播放器、不接管音频。
数据来自 linlin 的 MusicListsGUI(作者主页):
它只读地采集播放进度与歌词,通过 127.0.0.1:8765 的本地 HTTP 接口提供。
本包已附带(压缩为 plugins/PeakMusic/MusicListsGUI.runtime.zip)。第一次启动游戏时
自动解压到 BepInEx\PeakMusic\Local\MusicListsGUI\ 并拉起她的面板(约 5 秒),退出游戏时一起关闭。
不想自启就把 [本地] AutoStart 改成 false,之后手动运行该目录下的 MusicListsGUI.exe。
没启动时该模式会提示「未检测到」,其余功能不受影响。
本地模式也能参与「一起听」:房主广播歌名 + 直链 + 进度,队友各自取流播放(同一个文件、时间轴对齐);房主的声音仍从网易云 / QQ 出,游戏里不重复发声。
灵动岛
屏幕顶部居中那条常驻胶囊:歌名 · 歌手、当前歌词、帧率、延迟、时间。
- 放歌时出现,不播时不占屏(刚打开开关会给 4 秒预览,确认它真的开了)
- 本地模式下显示本机播放的歌名与歌词,歌手后面标「· 本机跟随」
- 嫌它挡住游戏自己的 HUD(时间 / 距离那行),在「首页 → 界面设置 → 灵动岛」点一下关掉, 关掉后整条不渲染、也不接收点击;设置会写进 cfg,重启后保持
配置项(BepInEx/config/com.peakmusic.probe.cfg)
| 配置 | 默认值 | 说明 |
|---|---|---|
| 界面 / PanelKey | F1 |
面板开关热键,可写多个(如 F1,F8) |
| 界面 / Theme | 0 | 面板配色:0=钛银灰 1=冰川蓝 2=翡翠夜 3=霓虹紫 4=琥珀金 5=赤霞橙 |
| 界面 / PanelScale | 1 | 再乘一档缩放 0.85–1.8(在自动适配的基础上,Ctrl+滚轮也能调) |
| 界面 / PanelCollapsed | false | 打开时是否折叠成迷你条 |
| 歌词 / Enabled | true | 3D 歌词总开关(放歌自动出现) |
| 歌词 / Hotkey | F4 |
歌词开关键(别和 PanelKey 撞键) |
| 歌词 / Size | 84 | 歌词字号,16–200(1080p 下的屏幕像素高度,高分辨率自动换算;面板上点一次即时生效) |
| 歌词 / Y | 0.62 | 句子中心高度,0=屏幕顶 1=屏幕底 |
| 歌词 / Edge | 0.4 | 句子离屏幕边缘的远近 |
| 歌词 / Distance | 12 | 文字平面离镜头多远 |
| 歌词 / Occlusion | true | 贴墙自动拉近:被地形挡住时把歌词压到镜头与岩壁之间,屏幕字号不变 |
| 歌词 / Wrap | true | 长句超过 14 字自动拆两行(找不到断点保持原样,不硬切) |
| 歌词 / StripPunct | false | 去掉歌词里的标点(默认关,保持原样) |
| 歌词 / ThroughWall | false | 穿透地形:开了永不被山体挡住(会失去远近遮挡感,需重启) |
| 歌词 / Font | 空 | 歌词字体名(留空 = 自动);侧栏「字体」按钮也能切 |
| 歌词 / Depth | 1 | 立体感:0=关 1=轻 2=强;侧栏「立体」按钮也能切 |
| 界面 / KillHelpersOnExit | true | 退出时结束本地模式后台进程,避免 Steam 卡「正在停止」 |
| 本地 / AutoStart | true | 启动时自动解压并拉起 MusicListsGUI(本地模式用) |
| 一起听 / LocalFollow | true | 本地模式也参与一起听:房主广播歌名 + 直链 + 进度 |
| 界面 / Island | true | 顶部灵动岛(歌名/歌词/帧率/延迟);挡 HUD 时可在面板首页关掉 |
| 歌词 / ColorLit | A6F07A |
已唱部分字色(十六进制,面板可切换预设) |
| 歌词 / Translation | true | 有翻译时显示副行 |
| 歌词 / FilterMeta | true | 跳过「词:xxx」等制作信息行 |
| 音源 / Platform | 0 | 当前音源:0=网易云 1=QQ音乐 |
改配置文件后需重启游戏;面板上直接点的都是立即生效。
实验功能:跟随本机播放器(默认关闭)
游戏外已经在客户端里放着歌,不想再在面板里搜一遍 —— 这个功能可以把「本机正在放什么」搬进游戏,屏幕顶部浮出一条歌词卡。
默认关闭(peak.music.ui.cfg 里 Follow.AutoStart = false)。原因是各家客户端的进度上报差异很大:
| 平台 | 情况 |
|---|---|
| QQ 音乐 | 有系统媒体时间轴,最准,推荐 |
| 酷狗 | 系统媒体只给歌名和状态、不给进度,进度靠推算(别拖进度条) |
| 网易云 | 新版客户端不上报系统媒体控制,暂不支持 |
想试就把 Follow.AutoStart 改成 true,进游戏后在客户端放歌即可;Follow.Hotkey(默认 F8)切换 3D 歌词 / 顶部卡片,Follow.LyricOffsetMs 可手动微调偏移(一般不用动)。
工作原理(给在意安全性的玩家)
- 开源透明:登录、取流、播放的每一行代码都可以在 GitHub 仓库审查,没有混淆、没有闭源组件
- 登录态只存本地:扫码走的是网易云 / QQ音乐官方登录授权;拿到的 Cookie 只写进你本机的
%APPDATA%\PeakMusic\文本文件,不经过任何第三方服务器 - 播放直连官方音源:音频从网易云 / QQ音乐的官方 CDN 直接拉取,mod 不代理、不抓取、不存储音频文件
- 一起听只在房间内通信:队列和播放同步走游戏联机通道(Photon),只同步歌名/曲号/进度这类必要信息;点歌人取的播放直链只发给同房间的房主
- 不改动游戏文件:仅作为 BepInEx 插件加载,不修改任何游戏 DLL,删掉文件夹即彻底卸载
前置
- BepInExPack_PEAK 5.4.75301(mod 管理器会自动安装)
常见问题
- 网易云有会员,却提示没会员 / 只放 30 秒:先看面板底部账号行的状态——
- 「网易云已登录 · 黑胶VIP」→ 服务器已认出会员,会员曲能正常取 320k;若个别歌仍失败,是那首无版权 / 有地区限制
- 「网易云已登录 · 非会员」→ 这个账号确实没会员(或会员已过期),会员曲只能试听
- 「网易云登录态已失效」→ cookie 过期,面板里退出后重新扫码
- 「网易云未登录」→ 扫码登录
- QQ 音乐提示取不到直链 / -110:提示会直接说清是哪一类:
- 「QQ音乐未登录」→ 面板里扫码登录再点
- 「没认出登录态」→ 面板里退出登录,重新扫一次(App 扫码不行就换「手机 QQ 扫码」)
- 「该账号下没有这首歌的播放权限」→ 服务器明确拒绝:这首要么无版权,要么需要更高等级会员
- 歌单同步失败:面板状态行会显示接口返回码。常见是登录态过期(重新扫码)或该账号没有对应歌单权限。
- 一起听对面没声音:确认两边装的是同版本 PeakMusic(启动日志第一行版本号一致)、且在同一房间
- 房间里只有我装了模组,点歌一直显示「等房主批准」:1.3.2 已修。现在会自动识别房主有没有装模组——没装就直接本机播放(面板页脚写「房主未装模组 · 本机播放」)。想让队友也听到,只能各自装同一个模组,因为音频是在每台机器本地播放的,游戏本身没有共享音频通道
- 歌词撞键失效:
[歌词] Hotkey和面板键写成同一个键会自动失效,改开一个就行 - 改了设置没反应:改 cfg 文件要重启游戏
资产信用与许可
- 本地模式(技术点):由 linlin 提供 —— MusicListsGUI。
只读采集本机网易云 / QQ 音乐的播放进度与歌词,通过
127.0.0.1:8765提供服务; 需单独安装并启动,本模组只读消费,不控制外部播放器。
详见 CREDITS.md。
致谢
- BepInEx —— 插件框架
- 感谢所有帮忙测试的朋友们
- 感谢 linlin 提供本地模式的数据通道(MusicListsGUI)