协奏曲/一起听Concerto

插件

· 作者 GregTao

在 Minecraft 中聆听本地/在线/网易云/QQ 音乐的曲目。 支持服务器歌曲分享与点播!

0 本站下载 0 关注 更新于 3 个月前

最新 paper-2.1.0-mc1.21.11 · 1.21.11 · Paper

一键开服(送7天)

Concerto

✨ 功能特性

  • 多源合一,统一播放 —— 支持网易云音乐、QQ 音乐、酷狗音乐、本地音频文件(拖放导入)以及直接 HTTP 链接。
  • 流畅播放体验 – 拖动进度条即可跳转曲目,在流媒体加载时保持后台播放,若默认输出设备不兼容还可选择其他音频输出选项。支持的格式包括 MP3、OGG/Opus、FLAC、WAV、M4A/AAC 和 AIFF。
  • 音乐房间(共同聆听) — 房间成员可实时同步播放状态:相同的曲目、相同的位置、相同的暂停时刻。房间可命名并公开列表,也可通过浏览器界面或 UUID 加入。
  • 全服队列(KTV 模式) — 玩家可为整个服务器排队歌曲,投票跳过当前曲目,当队列为空时服务器将自动切换至预设电台。
  • 共享访问与预设歌单 – 服务器管理员可为服务器配置支持的音服账号,并与所有人分享精选歌单。
  • 跨平台支持 — 客户端支持 Fabric 和 NeoForge;专用的 Paper 插件让模组客户端能在插件服务器上享受所有服务器端功能。

? 安装指南

平台 需要安装的内容
Fabric 客户端 Concerto-mc<version>-fabric-<mod version>.jar + Fabric API
NeoForge 客户端 Concerto-mc<version>-neoforge-<mod version>.jar
Paper 服务端 将 Concerto-mc<version>-paper-<mod version>.jar 放入 plugins/ 目录

Concerto 将其设置、歌单、下载内容和登录数据存储在游戏或服务器目录旁的 Concerto/ 文件夹中。

你可以在单人游戏或未安装本模组的服务器上将其作为本地播放器使用。但若要使用共享房间、内容分享以及全服队列功能,则服务器上也必须安装 Concerto(Fabric、NeoForge 或 Paper)。


⌨️ 快捷键

所有快捷键均可在 选项 → 控制 中重新绑定。

默认按键 操作
I 打开 Concerto 索引(主菜单)
U 打开歌单界面
N 播放下一首
P 暂停 / 继续

?️ 界面与控制

索引界面 (I)

这是你管理歌单、连接音乐服务(网易 / QQ / 酷狗)、搜索、添加本地文件、链接、进入音乐房间以及调整设置的起点。

歌单界面 (U)

  • 拖放来自文件管理器的音频文件或整个文件夹以进行导入。
  • 双击条目即可播放;单击选中。
  • 底部栏包含:下一首 / 播放 / 删除 / 排序(正常、随机、倒序、循环)/ 暂停 / 信息 / 清空。
  • 在全服队列模式下,播放按钮变为请求加入服务器,将选中的歌曲加入队列。
  • 音量按钮会弹出一个滑块(点击其他地方可关闭)。音量更改即时生效并保存至配置文件。
  • 搜索框用于过滤当前歌单。

歌单预览

  • 选择 保存到本地 可将当前显示的歌单立即添加到 本地歌单 中;它也会以 JSON 格式写入 Concerto/local_playlists/ 目录下。

播放器界面

  • 拖动进度条以跳转;拖动时会显示目标位置的预览。
  • 显示曲目标题、艺术家、来源、封面以及流媒体曲目的缓冲状态。

音乐房间界面

  • 发现视图:列出服务器的公共(可见)房间,支持一键加入,并提供创建命名房间、通过 UUID 加入、刷新列表或进入服务器队列的入口。
  • 管理视图(当你身处房间内时):显示成员列表、重命名、切换 可见 / 可加入 状态、授予协作者权限,以及解散或退出房间。

选项界面

使用游戏内选项调整音频输出、HUD 可见性、滚动文本速度、网易云音质等。音频输出的更改将在下一首曲目开始时生效。


? 命令

客户端播放器控制 – /concerto (别名 /music)

可通过客户端配置选项 registerMusicCommand 禁用 /music 别名。

大多数日常操作均可通过上述界面完成。命令仅为偏好使用命令的玩家和服务器管理员提供的快捷方式。

命令 描述
/concerto pause 切换暂停 / 继续
/concerto start 启动播放器(如果未运行)
/concerto stop 停止播放
/concerto clear 停止播放并清空歌单
/concerto restart 重启播放器核心(从卡死状态恢复)
/concerto reload 重载配置、本地歌单并重启播放器
/concerto save 将当前曲目缓存至本地(仅限支持缓存的来源)
/concerto like / dislike 喜欢 / 取消喜欢当前曲目(仅限网易云音乐)
/concerto download-current 下载当前曲目及其歌词到 Concerto/ 目录
/concerto download-all 下载当前歌单中的所有曲目
/concerto export-as-playlist 将当前歌单导出为 JSON 预设歌单(存入 Concerto/local_playlists)
/concerto clean-cache 清除客户端缓存(音乐、图片、验证文件)

音乐房间与服务器队列 — /musicroom(需要服务器端安装 Concerto)

命令 描述
/musicroom create [name] 创建(可选命名)并加入房间;房间 UUID 会自动复制到剪贴板。受服务器 musicRoomCommandPermission 权限限制
/musicroom join <uuid> 通过 UUID 加入房间
/musicroom quit 离开当前房间或服务器队列
/musicroom remove 解散你拥有的房间
/musicroom members 显示房主及成员列表
/musicroom op <player> 切换成员的播放控制权限(仅房主可用)
/musicroom agent join / quit 进入 / 离开全服队列(KTV 模式)
/musicroom agent add 将你当前正在播放的曲目推送到服务器队列
/musicroom agent vote 对当前队列中的曲目发起跳过投票
/musicroom agent vote <true|false> 在进行的跳过投票中投出赞成票 / 反对票

点对点分享 — /sharemusic

指令 说明
/sharemusic to <玩家 | @a> 将当前曲目分享给一名玩家或所有玩家(启用试听时,@a 会进入服务器审核队列)。暴露本地文件路径的音源会被拒绝,因为不安全。
/sharemusic accept <UUID> 接受分享邀请
/sharemusic reject <UUID> 拒绝分享邀请
/sharemusic reject all 拒绝所有待处理的邀请
/sharemusic list <page> 列出待处理的邀请(可点击接受/拒绝按钮)

服务器管理 — /concerto-server

除 fetch-radios 外,所有子命令都需要权限等级 2(OP)才能使用,而该命令任何人都可以使用。

指令 说明
/concerto-server audit <uuid> 批准待处理的 @a 广播请求
/concerto-server audit reject <uuid> 拒绝待处理的广播请求
/concerto-server audit reject all 拒绝所有待处理请求
/concerto-server audit list <page> 列出审计队列(包含可点击的接受/拒绝按钮)
/concerto-server reload 重新加载服务器配置、预设电台和平台 Cookie
/concerto-server reload-cookie 仅重新加载平台 Cookie 文件
/concerto-server clean-cache 清除服务器端缓存
/concerto-server fetch-radios 将服务器的预设电台同步到客户端
/concerto-server agent reset 完全重置服务器队列
/concerto-server agent cut 强制跳过当前队列中的曲目
/concerto-server agent stop / start 停止/重启 KTV 模式

? 使用方法

在音乐室中一起聆听

  1. /musicroom create My Room(或使用音乐室界面)—— UUID 会被复制到你的剪贴板。
  2. 将 UUID 分享给好友(使用 /musicroom join <uuid>),或将房间标记为可见且可加入,这样它就会出现在每个人的房间浏览器中。
  3. 控制成员的任何播放、跳转或暂停操作都会实时同步给所有成员。使用 /musicroom op 来指定谁可以控制播放。

运行全服队列(KTV 模式)

  1. 在服务器的 Concerto 设置中,保持全服队列启用。您还可以选择玩家在加入时是否收到邀请。
  2. 玩家使用 /musicroom agent join 进入,然后在选定的歌曲上点击 Request in server(请求播放)。/musicroom agent add 命令仍可将当前曲目加入队列;两者均受 musicAgentAddTimeLimit 速率限制。
  3. 如果服务器将某首歌曲解析为试听片段,队列中的所有玩家都会收到通知。
  4. 队列中的任何人均可发起跳过投票:执行 /musicroom agent vote,然后其他玩家通过 /musicroom agent vote true(或 false)进行确认。
  5. 当队列为空时,如果已配置,服务器将播放预设电台。

与服务器共享音乐服务账户

  1. 在您自己的客户端上登录音乐服务。
  2. 将客户端 Concerto/ 文件夹中生成的 .cookie 文件复制到服务器的 Concerto/ 文件夹中。请将这些文件视为密码妥善保管。
  3. 在服务器的 Concerto 设置中,启用队列的共享账户访问功能,然后运行 /concerto-server reload-cookie。

部署预设歌单

将导出的歌单 JSON 文件(参见 /concerto export-as-playlist)放置于服务器的 Concerto/preset_radios/ 目录下;特殊文件 music_agent.json 是 KTV 模式的回退选项。客户端会自动接收这些电台,或通过 /concerto-server fetch-radios 按需获取。

缓存与下载

Concerto 仅在您要求时才保存音乐:使用 /concerto save 保存当前曲目,或使用 download-current / download-all 永久保存带有歌词的版本。缓存大小可在设置中调整。


⚙️ 配置

正常使用无需编辑文件:游戏内选项界面涵盖了常见设置。以下参考文档适用于希望获得更高控制权的玩家和服务器管理员。设置文件位于 Concerto/ 目录中;请仅在关闭游戏时编辑这些文件。

client_config.json

播放与网络

键 默认值 含义
playerVolume 1.0 玩家音量,范围 0.0 – 1.0
playerVolumeFollowsMaster true 与 Minecraft 的主音量相乘
playbackBackend "JAVASOUND" 音频后端:"JAVASOUND" 或 "OPENAL"。更改后从下一首曲目开始生效
displayPlayerScreenCoverAndSpectrum true 在玩家屏幕上显示封面和频谱;设为 false 则使用全宽歌词视图
neteaseMusicQuality "HIRES" 网易云音质:"STANDARD"、"HIGHER"、"EXHIGH"、"LOSSLESS"、"HIRES"
maxCacheSize 100000000 缓存预算(字节),音乐和图片各占一份
handshakeRequired true 在使用服务器功能前验证 Concerto 握手协议
confirmAfterReceived true 在接受传入分享前进行询问(设为 false 则自动接受)
joinAgentWhenInvited false 加入时自动接受服务器的 KTV 邀请
registerMusicCommand true 注册 /music 别名命令
printRequestResults false 记录平台 API 响应(用于调试)
kuGouMusicLite false 使用酷狗“概念/轻量”端点
autoGetKuGouDailyVIP false 自动领取酷狗每日 VIP

HUD

每个 HUD 元素均包含一个 display* 开关、位置、对齐方式(LEFT / CENTER / RIGHT)以及 ARGB 颜色值:

元素 键值
歌词 displayLyrics、lyricsPosition(默认 0.5,1-100)、lyricsAlignment、lyricsColor
副歌词(翻译) displaySubLyrics、subLyricsPosition(默认 0.5,1-89)、subLyricsAlignment、subLyricsColor
曲目详情 displayMusicDetails、musicDetailsPosition(默认 1-30,0+5)、musicDetailsAlignment、musicDetailsColor

| 时间与进度条 | displayTimeProgress、timeProgressPosition(默认 1-30,0+15)、timeProgressAlignment、timeProgressTextColor、timeProgressColor、timeProgressBgColor | | 封面艺术 | displayCoverImg、coverImgPosition(默认 1-25,0)、coverImgSize、coverImgInCircle、coverImgRotate | | 其他 | textShadow、hideWhenChat、scrollingTextSpeed |

  • 位置格式:<x 分数>±<像素>,<y 分数>±<像素>。例如 0.5,1-100 表示水平居中,位于底部边缘上方 100 像素处;1-30,0+15 表示距离右侧 30 像素,距离顶部 15 像素。
  • 颜色格式:#AARRGGBB,例如 #ffffffff 为不透明的白色,#ff00aaaa 为不透明的青色。

server_config.json

键 默认值 含义
auditionRequired true @a 广播需要 OP 通过 /concerto-server audit 审批
serverMusicAgent true 启用全服队列(KTV 模式)
agentInviteWhenJoin true 玩家加入时邀请其进入队列
musicRoomCommandPermission 2 创建音乐房所需的最低权限等级
musicAgentAddTimeLimit 60 玩家在提交曲目到队列时必须等待的秒数
musicAgentUseShared true 通过服务器自身的 cookies 解析队列中的曲目
kuGouMusicLite false 在服务端使用酷狗轻量级端点(同时推送给客户端)

❓ 常见问题

如何在服务器上设置 music-service 账户? 先在您的客户端上登录,然后将客户端 Concerto/ 文件夹中的 .cookie 文件复制到服务器的相应位置。之后运行 /concerto-server reload-cookie。请妥善保管这些文件:它们授予对您账户的访问权限。

网易云在扫码登录后一直报错。 网易云的风控会严格标记来自新设备或新位置的登录行为。跳过扫码/密码登录,改为粘贴现有且正常工作的浏览器会话的完整 cookie。

QQ Music 在几天后停止解析。 QQ Music 的 Cookie 出于设计原因会快速过期。请在服务器上刷新 Cookie 文件,并运行 /concerto-server reload-cookie。

我应该选择哪种音频输出选项? 推荐使用 JAVASOUND 作为默认值。如果出现播放卡顿或使用了错误的设备,请尝试 OPENAL。更改将在下一首曲目生效。

在音轨中移动有时会比较慢。 某些流式文件和电台源无法直接跳转到任意位置,因此 Concerto 可能需要一点时间来追赶进度。在近期播放过的音频中移动通常速度更快。

我可以播放哪些本地音频文件? Concerto 支持 MP3、OGG/Opus、FLAC、WAV、M4A/AAC 和 AIFF。这些容器内对非常规编码的支持可能因情况而异,因此将问题文件转换为 MP3 或 WAV 仍然是一个有用的备用方案。

播放器出错后卡住 / 无声。 /concerto restart 会重置播放器核心,而不会影响你的播放列表。如果屏幕渲染错误或封面变黑,请使用 /concerto clean-cache;作为最后的手段,在游戏关闭时删除 Concerto/cache 文件夹。

房间 / 共享命令提示该功能不可用。 这些功能需要服务器端也安装 Concerto(Fabric、NeoForge 或 Paper 插件)。在未安装模组的服务端上,该模组仍可用作纯本地播放器。

我的音量被重置或忽略滑块调整。 如果开启了 playerVolumeFollowsMaster,实际音量等于 playerVolume × master volume —— 同时也请检查 Minecraft 自带的“音乐与音效”设置。


✨ 功能亮点

  • 多来源,一个播放器 —— 网易云音乐、QQ 音乐、酷狗音乐、本地音频文件(支持拖放导入)、HTTP 直链,都在同一条播放队列里。
  • 顺畅播放 —— 拖动进度条即可跳转,流媒体加载时也能继续收听;如果默认输出不合适,还可切换音频输出方式。支持 MP3、OGG/Opus、FLAC、WAV、M4A/AAC 和 AIFF。
  • 音乐室(一起听) —— 同一房间的成员实时共享播放状态:同一首歌、同一进度、同步暂停。房间可以命名、公开展示,在房间列表界面一键加入,也可以凭 UUID 加入。
  • 全服点播(KTV 模式) —— 玩家给全服排队点歌,可以发起投票切歌;没人点歌时自动播放服务器预设歌单。
  • 共享账号与预设歌单 —— 服主可以为服务器配置自己已登录的音乐服务账号,并把整理好的歌单分享给所有玩家。
  • 跨平台 —— 客户端支持 Fabric 和 NeoForge;插件服可用专属 Paper 插件,模组客户端在插件服上同样能用全部服务端功能。

? 安装

平台 需要安装
Fabric 客户端 Concerto-mc<版本>-fabric-<模组版本>.jar + Fabric API
NeoForge 客户端 Concerto-mc<版本>-neoforge-<模组版本>.jar
Paper 服务端 Concerto-mc<版本>-paper-<模组版本>.jar 放进 plugins/

Concerto 会把设置、歌单、下载内容和登录信息保存在游戏或服务端目录旁的 Concerto/ 文件夹中。

单人游戏和未安装 Concerto 的服务器中,都可以把它当作本地播放器使用;音乐室、音乐分享和全服点播等联机功能则需要服务端也安装 Concerto(Fabric、NeoForge 或 Paper 均可)。


⌨️ 快捷键

以下按键都可以在 选项 → 按键控制 里改绑。

默认按键 功能
I 打开 Concerto 主菜单
U 打开播放列表界面
N 播放下一首
P 暂停 / 继续

?️ 界面与操作

主菜单(I)

这是播放列表、网易云 / QQ / 酷狗曲库、搜索、本地文件、链接、音乐室和设置的统一入口。

播放列表界面(U)

  • 直接从文件管理器拖放音频文件或整个文件夹即可导入。
  • 双击条目播放,单击选中。
  • 底部一排按钮:下一首 / 播放 / 删除 / 播放顺序(顺序、随机、倒序、单曲循环)/ 暂停 / 详情 / 清空。
  • 加入全服点播后,播放会变为服务器点歌,并将选中的歌曲加入服务器队列。
  • 音量按钮会弹出滑条,点击界面其他位置自动收起;音量即调即生效,并写入配置。
  • 顶部搜索框用于筛选当前列表。

歌单预览

  • 点击保存到本地,即可将当前歌单立即加入本地歌单;同时会写入 Concerto/local_playlists/ 下的 JSON 文件。

播放器界面

  • 拖动进度条跳转播放位置,拖动过程中会显示目标位置预览。
  • 显示标题、歌手、来源、封面,流媒体曲目会显示缓冲状态。

音乐室界面

  • 发现视图:列出服务器上公开(可见)的房间,一键加入;也可以在这里输入房名创建房间、凭 UUID 加入、刷新列表或进入全服点播。
  • 管理视图(已在房间内时):成员列表、改名、切换可见 / 可加入、给成员授权、解散或退出房间。

选项界面

可在游戏内选项中调整音频输出、HUD 显隐、滚动文字速度、网易云音质等。切换音频输出会从下一首开始生效。


? 指令一览

客户端播放控制 —— /concerto(别名 /music)

/music 别名可通过客户端配置项 registerMusicCommand 关闭。

日常操作都可以在上面的界面中完成;以下指令只是为喜欢快捷操作的玩家和服主准备的补充。

指令 说明
/concerto pause 暂停 / 继续
/concerto start 启动播放器(未运行时)
/concerto stop 停止播放
/concerto clear 停止播放并清空播放列表
/concerto restart 重启播放器核心(用于从卡死状态恢复)
/concerto reload 重载配置和本地歌单,并重启播放器
/concerto save 把当前曲目存入本地缓存(仅限可缓存来源)
/concerto like / dislike 收藏 / 取消收藏当前曲目(仅网易云音乐)
/concerto download-current 下载当前曲目及歌词到 Concerto/
/concerto download-all 下载当前播放列表中的全部曲目
/concerto export-as-playlist 把当前播放列表导出为 JSON 预设歌单(Concerto/local_playlists)
/concerto clean-cache 清空客户端缓存(音乐、图片、校验文件)

音乐室与全服点播 —— /musicroom(需要服务端装有 Concerto)

指令 说明
/musicroom create [房名] 创建(可命名)并加入房间,房间 UUID 自动复制到剪贴板;受服务端 musicRoomCommandPermission 权限限制
/musicroom join <uuid> 凭 UUID 加入房间
/musicroom quit 退出当前房间或全服点播队列
/musicroom remove 解散自己创建的房间
/musicroom members 查看房主和成员列表
/musicroom op <玩家> 给成员授予 / 收回播放控制权(仅房主可用)
/musicroom agent join / quit 加入 / 退出全服点播(KTV 模式)
/musicroom agent add 把自己正在播放的曲目推送到全服点播队列
/musicroom agent vote 对当前点播曲目发起切歌投票
/musicroom agent vote <true|false> 在进行中的投票里投赞成 / 反对票

玩家间音乐分享 —— /sharemusic

指令 说明
/sharemusic to <玩家 | @a> 把当前曲目分享给指定玩家;@a 为全服广播(开启审核时会先进入管理员审核队列)。会暴露本地文件路径的来源出于安全考虑无法分享
/sharemusic accept <uuid> 接受一条分享邀请
/sharemusic reject <uuid> 拒绝一条分享邀请
/sharemusic reject all 拒绝全部待处理邀请
/sharemusic list <页码> 分页查看待处理邀请(带可点击的接受 / 拒绝按钮)

服务端管理 —— /concerto-server

除 fetch-radios 所有人可用外,其余子指令都需要 2 级权限(OP)。

指令 说明
/concerto-server audit <uuid> 通过一条待审核的全服广播请求
/concerto-server audit reject <uuid> 拒绝一条广播请求
/concerto-server audit reject all 拒绝全部待审核请求
/concerto-server audit list <页码> 分页查看审核队列(带可点击的接受 / 拒绝按钮)
/concerto-server reload 重载服务端配置、预设电台和平台 Cookie
/concerto-server reload-cookie 只重载平台 Cookie 文件
/concerto-server clean-cache 清空服务端缓存
/concerto-server fetch-radios 把服务器预设电台同步到自己的客户端
/concerto-server agent reset 彻底重置全服点播队列
/concerto-server agent cut 强制切掉当前点播曲目
/concerto-server agent stop / start 停止 / 重新开启 KTV 模式

? 使用指南

和朋友"一起听"

  1. /musicroom create 我的房间(或在音乐室界面操作),UUID 会自动进剪贴板。
  2. 把 UUID 发给朋友(/musicroom join <uuid>);或者把房间设为可见 + 可加入,让它出现在所有人的房间列表里。
  3. 有控制权的成员切歌、拖进度、暂停,其他成员都会实时跟随。用 /musicroom op 决定谁有控制权。

开一场全服 KTV

  1. 在服务端 Concerto 设置中保持全服点播开启;也可以选择是否在玩家进服时发送邀请。
  2. 玩家用 /musicroom agent join 进入队列,再从歌曲页面点击服务器点歌;/musicroom agent add 仍可把正在播放的歌曲加入队列,两种方式都受 musicAgentAddTimeLimit 限制。
  3. 服务器解析到试听片段时,会通知队列中的所有成员。
  4. 歌不合口味?任何队列内玩家都能 /musicroom agent vote 发起切歌投票,其他人用 /musicroom agent vote true(或 false)表态。
  5. 没人点歌时,服务器自动播放预设电台(如已配置)。

与全服共享音乐服务账号

  1. 先在自己的客户端登录音乐服务。
  2. 把客户端 Concerto/ 中生成的 .cookie 文件复制到服务端的 Concerto/ 目录。请像保管密码一样保管这些文件。
  3. 在服务端 Concerto 设置中开启点播队列的共享账号访问,然后执行 /concerto-server reload-cookie。

下发预设歌单

把导出的歌单 JSON(见 /concerto export-as-playlist)放到服务端 Concerto/preset_radios/ 下;其中 music_agent.json 是 KTV 模式空闲时的兜底歌单。客户端会自动收到电台列表,也可以用 /concerto-server fetch-radios 手动拉取。

缓存与下载

Concerto 只会在你主动操作时保存音乐:/concerto save 保存当前曲目,download-current / download-all 会连同歌词下载为长期保存的副本。缓存大小可在设置中调整。


⚙️ 配置说明

日常使用无需编辑文件,游戏内选项已覆盖常用设置。下面的内容仅供希望进一步调整的玩家和服主参考。设置文件位于 Concerto/ 目录;如需编辑,请先关闭游戏。

client_config.json

播放与联机

配置项 默认值 说明
playerVolume 1.0 播放器音量,0.0 – 1.0
playerVolumeFollowsMaster true 音量再乘以 Minecraft 主音量
playbackBackend "JAVASOUND" 音频后端:"JAVASOUND" 或 "OPENAL",切换后下一首生效
displayPlayerScreenCoverAndSpectrum true 在播放页面显示封面和频谱;false 时使用全宽歌词视图
neteaseMusicQuality "HIRES" 网易云音质:"STANDARD"、"HIGHER"、"EXHIGH"、"LOSSLESS"、"HIRES"
maxCacheSize 100000000 缓存上限(字节,音乐与图片各自计算)
handshakeRequired true 使用服务端功能前要求完成 Concerto 握手校验
confirmAfterReceived true 收到分享先询问(改为 false 则自动接受)
joinAgentWhenInvited false 进服时自动接受全服点播邀请
registerMusicCommand true 注册 /music 别名
printRequestResults false 打印平台 API 响应(调试用)
kuGouMusicLite false 使用酷狗概念版接口
autoGetKuGouDailyVIP false 自动领取酷狗每日 VIP

HUD 显示

每个 HUD 元素都有 display* 开关、位置、对齐方式(LEFT / CENTER / RIGHT)和 ARGB 颜色:

元素 相关配置项
歌词 displayLyrics、lyricsPosition(默认 0.5,1-100)、lyricsAlignment、lyricsColor
副歌词(翻译) displaySubLyrics、subLyricsPosition(默认 0.5,1-89)、subLyricsAlignment、subLyricsColor
曲目信息 displayMusicDetails、musicDetailsPosition(默认 1-30,0+5)、musicDetailsAlignment、musicDetailsColor
时间与进度条 displayTimeProgress、timeProgressPosition(默认 1-30,0+15)、timeProgressAlignment、timeProgressTextColor、timeProgressColor、timeProgressBgColor
封面 displayCoverImg、coverImgPosition(默认 1-25,0)、coverImgSize、coverImgInCircle、coverImgRotate
其他 textShadow、hideWhenChat、scrollingTextSpeed
  • 位置格式:<横向比例>±<像素>,<纵向比例>±<像素>。如 0.5,1-100 表示水平居中、距底边 100 像素;1-30,0+15 表示距右边 30 像素、距顶边 15 像素。
  • 颜色格式:#AARRGGBB,如 #ffffffff 为不透明纯白,#ff00aaaa 为不透明青色。

server_config.json

配置项 默认值 说明
auditionRequired true @a 全服广播需要 OP 通过 /concerto-server audit 审核
serverMusicAgent true 开启全服点播(KTV 模式)
agentInviteWhenJoin true 玩家进服时发送点播邀请
musicRoomCommandPermission 2 创建音乐室所需的最低权限等级
musicAgentAddTimeLimit 60 单个玩家两次点歌的最小间隔(秒)
musicAgentUseShared true 点播曲目统一通过服务端自己的 Cookie 解析
kuGouMusicLite false 服务端使用酷狗概念版接口(会同步给客户端)

❓ 常见问题

怎样在服务端配置音乐服务账号? 先在自己的客户端登录,再把客户端 Concerto/ 中的 .cookie 文件复制到服务端同名目录,然后执行 /concerto-server reload-cookie。这些文件可以访问你的账号,务必妥善保管。

网易云扫码登录后一直报错? 网易云的风控对新设备、异地登录非常敏感。建议放弃扫码 / 密码登录,直接把浏览器里已正常登录的完整 Cookie 粘贴进来。

QQ 音乐过几天就解析失败? QQ 音乐的授权有效期本来就短,过期是正常现象。在服务端更新 Cookie 文件后执行 /concerto-server reload-cookie 即可。

音频输出选哪个? 推荐先使用默认的 JAVASOUND。如果遇到卡顿或输出设备不对,再试试 OPENAL。切换后从下一首开始生效。

有些歌拖动进度条很慢? 部分流媒体文件和电台无法直接跳到任意位置,因此 Concerto 可能需要一点时间追上进度;在刚刚播放过的片段之间移动通常会更快。

本地音频文件支持哪些格式? Concerto 支持 MP3、OGG/Opus、FLAC、WAV、M4A/AAC 和 AIFF。同一种格式中较少见的编码方式可能仍有差异;遇到无法播放的文件时,可尝试转换为 MP3 或 WAV。

播放器卡死 / 出错后没声音? /concerto restart 会重启播放器核心且不动播放列表。如果界面渲染异常、封面黑块,先 /concerto clean-cache;仍不行就在游戏关闭状态下删除 Concerto/cache 目录。

音乐室 / 分享指令提示功能不可用? 这些功能需要服务端装有 Concerto(Fabric、NeoForge 或 Paper 插件)。在纯净服务器上,模组仍可作为本地播放器正常使用。

音量调了没反应或自己变小? 如果开着 playerVolumeFollowsMaster,实际音量是 playerVolume × 主音量——记得检查 Minecraft 自己的音乐音量设置。

Hud screen

Index screen

General playlist

Search screen

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源