PEAK
You are viewing a potentially older version of this package. View Latest Version
Install with App

Details

Date Uploaded
Downloads
2.3K
Size
20MB

PEAK Music Player(PeakMusic)

在 PEAK 游戏里听歌的 BepInEx 插件 —— 搜索网易云音乐 / QQ音乐直接放歌,会员账号能放会员曲,歌单与收藏同步,3D 悬浮歌词跟着视角走,联机「一起听」全房间同步,游戏内扫码登录。

爬山再累,也要有 BGM。按一下快捷键,搜索框敲歌名,点一行就播——不切窗口、不戴第二副耳机。

PEAK Music Player


界面

默认是新版深色面板:左侧栏放平台切换、我的收藏、一起听和歌词设置,底部一张账号卡;主区是页头 + 搜索 + 歌曲列表 + 浮动播放条。

不喜欢或遇到问题,两种方式回到经典界面:

  1. 打开 BepInEx/config/peak.music.ui.cfg,把 NewPanel = false,重进游戏;
  2. 或者直接删掉 BepInEx/plugins/PeakMusic/PeakMusic.UI.dll。

两种方式都不影响搜索、播放、歌词和一起听 —— 新界面只换「画法」,不换「逻辑」。


功能

  1. 搜索播放:面板输入歌名/歌手/歌词关键词,点一行即播。网易云音乐、QQ音乐双平台可切换,搜索各查各的、结果分页浏览;免费曲不登录也能放。

  2. 会员账号直接放会员曲:用你自己账号的权限取流。面板底部实时显示登录态(已登录 · 黑胶VIP / 非会员 / 登录态已失效),会员曲能不能放一眼看清,不会「点了没反应」。

  3. 歌单与收藏同步:登录后同步你在客户端里的「我喜欢的音乐」和自建/收藏歌单,面板里直接翻歌单点播,不用每次重新搜。同步失败会在状态行说明原因,不静默失败。

  4. 3D 悬浮歌词:世界空间实时歌词,屏幕两侧交替浮现、逐字点亮,跟着视角走不挡准星。字号 / 高度 / 左右位置 / 离镜头距离 / 已唱·未唱·翻译三色 / 发光强度全部可调,有翻译时副行小字跟随;自动跳过「词:xxx 曲:xxx」这类制作信息行。默认开箱即用,放歌自动出现。

  5. 联机一起听:装了同版本的人之间同步(谁装谁听得到,没装的人本来就没有音频通道)。房主装模组时:房主放歌 → 全员同步播放(进度 / 暂停 / 切歌);队友在自己面板点歌 → 进房主的「♪ 一起听」队列(显示歌名+谁点的),房主点「批准」即播,放完自动接播下一首。房主没装模组时:不再把你卡在「等房主批准」,点歌直接在你本机播放(只有你听得到),面板页脚会写明当前状态。

  6. 谁点的歌用谁的会员:点歌人先用自己的账号取播放直链随点歌发给房主,房主批准时直接播这条直链——房主没有会员也能放客机点的 VIP 曲;免费曲谁点都能放;两边都没权限的付费曲会明确提示原因,不装死。

  7. 游戏内扫码登录:面板里直接扫码(QQ 音乐 App / 手机 QQ 均可,微信登录的 QQ 音乐账号也支持),手机确认即完成,不用抓包不用复制 Cookie。网易云同样支持扫码。扫不出来还可以「从剪贴板导入」Cookie 兜底。

  8. 面板随心调:界面按你的分辨率自动适配 —— 面板按 1080p 设计,实际尺寸 = 832 × 屏幕高 ÷ 1080,所以 2K 会自动变成 1.33 倍、4K 变成 2 倍,各分辨率下占屏比例一致(约 43% 宽、64% 高),大屏上不会缩成一小块。字号与次要文字的对比度都调过(深色底上不费眼);标题栏拖动、Ctrl+滚轮再乘一档(0.85–1.8)、6 套主题配色(钛银灰 / 冰川蓝 / 翡翠夜 / 霓虹紫 / 琥珀金 / 赤霞橙)、折叠成迷你条、位置自动记忆。

  9. 最高音质自动选择:登录会员后自动取账号能拿到的最高一档 —— 网易云依次尝试超清母带 / Hi-Res / 无损,QQ 音乐尝试无损 FLAC;本地解码并保留 24bit 位深。任何一档拿不到都会自动回退 320k,不会出现「开了无损反而没声音」。想强制 320k 就把 [音质] QualityLevel 设成 3。

  10. 歌词字体与立体感:侧栏「字体」按钮在系统已安装字体之间循环(自动 / 雅黑 / 正黑 / 黑体 / 宋体 / 等线 / 楷体 / 仿宋 …),自己装的字体也能在配置里填名字;「立体」按钮给字形加倒角、投影与轻微斜置,转视角时有透视 —— 不再像贴在屏幕上的纸片。两项都只改材质参数,不增加绘制调用。

  11. 自动续播 + 单曲循环:从搜索结果 / 收藏 / 歌单任一入口点歌,播完自动按那份列表往下走,面板关着也照常切;到列表末尾会明确停下并提示,不会莫名绕回第一首。底部控制栏「↻ 单曲」按钮切换单曲循环(开着高亮)。


截图展示

主面板(F1 打开)——搜索、结果列表、左侧歌词调节与平台切换:

主面板

中英文歌都能搜:

英文搜索

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

QQ音乐搜索

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

扫码登录

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

一起听队列


安装

mod 管理器(推荐):搜 PeakMusic 安装即可,前置 BepInExPack_PEAK 会自动带上。

手动安装:

  1. 先装 BepInExPack_PEAK(5.4.75301)
  2. 把压缩包里的 plugins/PeakMusic 文件夹复制到 PEAK/BepInEx/plugins/ 下
  3. 重启游戏,进游戏后按 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,删掉文件夹即彻底卸载

前置


常见问题

  • 网易云有会员,却提示没会员 / 只放 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)
Thunderstore development is made possible with ads. Please consider making an exception to your adblock.