Concerto

Concerto

一个基于 Fabric 的 Minecraft 内置音乐播放器。支持本地文件、在线资源、网易云音乐和 QQ 音乐。功能包括多人音乐室（一起听）、歌曲点播（KTV 模式）、服务器预设歌单、共享 VIP 歌曲等。

本模组仅供学习使用，请勿用于非法用途。

Wiki 参考模组版本：1.3.5

目前已知支持的版本：1.21.4、1.21.1、1.20.6、1.20.1、1.19.4、1.18.2、1.17.1、1.16.5。其他版本未经测试。

安全提醒！

请勿分享 Concerto 文件夹内的 .cookie 文件！

默认快捷键

• U：打开播放队列管理界面
• I：打开 Concerto 主菜单
• N：播放下一首歌曲
• P：暂停/继续播放

指令

1. /concerto（客户端指令，别名 /music，可在客户端设置中配置）

• pause：暂停/继续播放
• start：开始播放
• stop：停止播放
• skip：播放下一首歌曲
• skip [编号]：播放第 [编号] 首歌曲
• cut：跳过/删除当前播放的歌曲
• clear：停止播放并清空队列
• mode [normal|random|reversed|loop]：切换播放模式为正常、随机、倒序或循环
• reload：重新加载播放队列和客户端配置
• list [页码]：显示播放队列的第 [页码] 页（每页 10 首歌曲）
• save：缓存当前歌曲（见“可缓存歌曲”）
• like：喜欢当前歌曲（见“喜欢的歌曲”）
• dislike：取消喜欢当前歌曲
• download-current：将当前歌曲下载到 Concerto 文件夹
• download-all：将队列中的所有歌曲下载到 Concerto 文件夹
• export-as-playlist：将当前队列导出为服务器预设歌单的 JSON 格式（见“服务器预设歌单”）
• ~~add~~：已弃用

2. /concerto-server（服务器端指令，仅限管理员）

• audit [UUID]：审核通过分享给所有人的歌曲（见 /sharemusic）
• audit reject [UUID]：拒绝分享的歌曲
• audit reject all：拒绝所有分享的歌曲
• audit list [页码]：列出第 [页码] 页的待审核歌曲
• reload：重新加载服务器配置（见“服务器配置”）
• fetch-radios：将服务器预设歌单同步到客户端（所有用户可用）
• agent reset：重新加载服务器的歌曲点播队列
• agent cut：强制服务器队列切换到下一首歌曲

3. /sharemusic（客户端指令，服务器无需安装 Concerto 也可使用）

• to [玩家|@a]：将当前歌曲分享给 [玩家] 或所有人（若服务器未安装 Concerto 则通过 /msg 发送）
• accept [UUID]：接受 ID 为 [UUID] 的分享歌曲
• reject [UUID]：拒绝 ID 为 [UUID] 的分享歌曲
• reject all：拒绝所有分享的歌曲
• list [页码]：显示第 [页码] 页的待接受分享歌曲列表

4. /musicroom（客户端指令，需要服务器安装 Concerto）

• create：创建并加入音乐室（UUID 会自动复制）
• join [UUID]：加入 ID 为 [UUID] 的音乐室
• quit：离开当前音乐室
• members：列出当前房间的成员
• op [玩家]：授予/撤销 [玩家] 的管理员权限（仅创建者可用）
• agent join：加入服务器的歌曲点播队列
• agent quit：离开服务器的歌曲点播队列
• agent query：查看即将播放的服务器点播歌曲
• agent add：将当前播放的歌曲添加到服务器点播队列
• agent vote：发起跳过歌曲的投票
• agent vote [true/false]：对跳过当前歌曲的投票投赞成/反对票

~~5. /neteasecloud~~（用于网易云音乐登录的客户端指令，已弃用）

本地播放队列

• 按 U 打开队列管理界面
• 点击歌曲，然后按播放（或双击歌曲）
• 点击歌曲，然后按详情按钮查看更多信息
• 将文件/文件夹拖放到队列管理界面以添加

服务器预设歌单

• 使用 /concerto export-as-playlist 导出歌单
• 将导出的 JSON 文件移动到 Concerto/preset_radios/
• 如果文件名为 music_agent.json，它将在空闲时用作默认歌单
• 使用 /concerto-server reload 应用新歌单
• 玩家可以从主菜单访问服务器预设歌单

服务器配置

位于 Concerto/server_config.json：

• auditionRequired：分享歌曲是否需要审核（默认：true）
• serverMusicAgent：启用服务器端歌曲点播（默认：true）
• agentInviteWhenJoin：自动邀请新玩家加入歌曲点播（默认：true）
• musicRoomCommandPermission：创建音乐室所需的最低权限（默认：2）
• musicAgentAddTimeLimit：歌曲点播之间的时间限制（默认：60秒）
• musicAgentUseShared：允许服务器端解析歌曲链接（默认：true）

音乐分享（非一起听）

• 如果服务器运行 Concerto，它会发送隐藏请求；否则使用 /msg
• 管理员可以启用公开分享歌曲的审核
• 分享的歌曲需要接受后才能播放
• 只能分享安全来源（网易云音乐、QQ音乐）

音乐室

• 播放操作会影响所有成员（例如暂停、跳过）
• 避免设置太多管理员以防止冲突
• 创建房间时，房间的 UUID 会自动复制到剪贴板
• 只能分享安全来源（网易云音乐、QQ音乐）

服务器歌曲点播

• 点击歌曲并按详情按钮进行点播
• 使用 /musicroom agent vote 发起/加入投票
• 要启用 VIP 歌曲，请将 .cookie 文件复制到服务器并启用 musicAgentUseShared
• Concerto/presetradios/musicagent.json 文件用作默认空闲歌单

客户端配置文件

• 位于 Concerto/client_config.json
• confirmAfterReceived：自动接受所有收到的音乐分享（默认：关闭）
• hideWhenChat：聊天窗口打开时隐藏歌词/歌曲信息（默认：启用）
• printRequestResults：输出 HTTP 请求响应；出于安全考虑，除非必要，否则请勿启用（默认：关闭）
• maxCacheSize：最大缓存大小（默认：100MB）
• joinAgentWhenInvited：被邀请时自动加入服务器的歌曲点播队列（默认：关闭）
• registerMusicCommand：将 /music 注册为 /concerto 的别名（默认：启用）
• scrollingTextSpeed：滚动文本显示速度（默认：1.0）
• neteaseMusicQuality：网易云音乐音频质量（"STANDARD"、"HIGHER"、"EXHIGH"、"LOSSLESS"、"HIRES"，默认："HIRES"）
• displayLyrics：显示歌词（默认：启用）
• lyricsPosition：歌词显示位置（见下方“位置格式配置”，默认：0.5,1-70）
• lyricsAlignment：歌词对齐方式（"LEFT"、"CENTER"、"RIGHT"，默认：居中）
• lyricsColor：歌词颜色（见下方“颜色配置”，默认：#ff00aaaa）
• displaySubLyrics：显示翻译歌词（默认：启用）
• subLyricsPosition：翻译歌词显示位置（见下方“位置格式配置”，默认：0.5,1-60）
• subLyricsAlignment：翻译歌词对齐方式（"LEFT"、"CENTER"、"RIGHT"，默认：居中）
• subLyricsColor：翻译歌词颜色（见下方“颜色配置”，默认：#ffffaa00）
• displayMusicDetails：显示详细歌曲信息（默认：启用）
• musicDetailsPosition：歌曲信息显示位置（见下方“位置格式配置”，默认：1-5,0+5）
• musicDetailsAlignment：歌曲信息对齐方式（"LEFT"、"CENTER"、"RIGHT"，默认：右对齐）
• musicDetailsColor：歌曲信息颜色（见下方“颜色配置”，默认：#ffffffff）
• displayTimeProgress：显示歌曲进度条（默认：启用）
• timeProgressPosition：歌曲进度条显示位置（见下方“位置格式配置”，默认：1-5,0+15）
• timeProgressAlignment：歌曲进度对齐方式（"LEFT"、"CENTER"、"RIGHT"，默认：右对齐）
• timeProgressTextColor：歌曲进度文字颜色（见下方“颜色配置”，默认：#ffffffff）
• timeProgressColor：歌曲进度条颜色（见下方“颜色配置”，默认：#ff0155bc）
• timeProgressBgColor：歌曲进度条背景颜色（见下方“颜色配置”，默认：#ffa1c7f6）

位置格式配置

基本格式：[水平比例](+/-)[水平偏移],[垂直比例](+/-)[垂直偏移]。如果偏移为 0，可以省略（包括 + 或 - 符号）。

例如，0.5,1-70 表示屏幕水平中心，距离底部向上 70 像素。1-5,0+5 表示右上角，向下和向左各偏移 5 像素。

颜色配置

基本格式：(0x|#)[8 位十六进制代码]。每两位代表 ARGB。建议使用在线取色器（如果复制的是 6 位代码，请手动在前面添加 ff）。确保代码前缀为 0x 或 #。

例如，#ffffffff 表示完全不透明的白色，#ff00aaaa 表示完全不透明的青色。

可缓存歌曲

包括网易云音乐、QQ 音乐和其他在线资源。

喜欢的音乐

仅支持网易云音乐。

安全音乐来源

只有网易云音乐和 QQ 音乐被视为安全来源。不包括本地文件或其他在线资源。

常见问题

暂无。

基于 Fabric 的 Minecraft 内置音乐播放器。支持本地文件、网络资源、网易云音乐、QQ音乐。支持多人游戏音乐室（一起听）、歌曲点播（KTV模式）、服务端预设歌单、共享 VIP 歌曲等功能。

本模组仅供学习使用，不得非法利用本模组。

Wiki 基准模组版本：1.3.5

目前已知支持版本：1.21.4, 1.21.1, 1.20.6, 1.20.1, 1.19.4, 1.18.2, 1.17.1, 1.16.5，其余版本未经测试

安全提醒！

请不要泄露 Concerto 文件夹中的 .cookie 文件！

默认热键

• U：打开播放队列管理界面
• I：打开 Concerto 主菜单
• N：播放下一首
• P：暂停/继续播放

指令

• /concerto（客户端指令，可选别名 /music，详见 客户端配置文件）

pause：暂停/继续播放

start：开始播放

stop：停止播放

skip：播放下一首音乐

skip [编号]：播放第 [编号] 首音乐

cut：切歌/删除当前播放歌曲

clear：停止播放并清除播放队列

mode [normal|random|reversed|loop]：切换播放模式为 正序/随机/倒序/循环

reload：重新加载播放队列和客户端配置文件

list [页码]：显示第 [页码] 页播放队列（10条歌曲一页）

save：缓存当前歌曲（详见 可缓存歌曲）

like：喜欢当前歌曲（详见 喜欢歌曲）

dislike：取消喜欢当前歌曲

download-current：下载当前歌曲到 Concerto 文件夹

download-all：下载播放队列中的所有歌曲到 Concerto 文件夹

export-as-playlist：导出当前播放队列为服务端预设歌单格式 JSON（详见 服务端预设歌单）

~~add：添加歌曲/歌单等~~，已废弃

• /concerto-server（服务端指令，仅限管理员）

audit [UUID]：审核通过分享给所有人的音乐（详见 /sharemusic 指令）

audit reject [UUID]：拒绝分享给所有人的音乐

audit reject all：拒绝所有分享给所有人的音乐

audit list [页码]：列出第 [页码] 页的待审歌曲清单

reload：重新加载服务端配置文件（详见 服务端配置文件）

fetch-radios：技术性指令，同步服务端预设歌单到本地（允许普通用户使用）

agent reset：重新加载服务端歌曲点播队列

agent cut：强制让服务端点播队列播放下一首/切歌

• /sharemusic（客户端指令，服务端不安装 Concerto 也可使用，非音乐室功能）

to [玩家|@a]：分享当前播放的歌曲给 [玩家] 或所有人（若服务端未安装 Concerto 则通过 /msg 指令发送），只能分享被认为安全的音乐（详见 安全的音乐来源）

accept [UUID]：接受编号为 [UUID] 的音乐分享

reject [UUID]：拒绝编号为 [UUID] 的音乐分享

reject all：拒绝所有音乐分享

list [页码]：显示第 [页码] 页的待接受音乐分享列表

• /musicroom（客户端指令，服务端必须安装 Concerto 才能正常使用）

create：新建并加入音乐室，并自动复制音乐室的 UUID（详见 音乐室）

join [UUID]：加入编号为 [UUID] 的音乐室

quit：退出当前音乐室

members：显示当前所在音乐室的成员

op [玩家]：仅限音乐室创建者可用，给予/剥夺 [玩家] 的音乐室管理员权限

agent join：参与服务器音乐点播（详见 服务器音乐点播）

agent quit：退出服务器音乐点播

agent query：查询服务器音乐点播待播队列

agent add：向服务器音乐点播队列添加客户端当前播放的音乐

agent vote：发起切歌投票

agent vote [true/false]：给当前进行的切歌投票投 赞成/反对

• ~~/neteasecloud~~（客户端指令，用于登录网易云音乐，已废弃）

本地播放队列

• 按 U 打开播放队列管理界面；
• 单击选中音乐，再点击播放按钮（或直接双击某条音乐）开始播放
• 单击选中音乐，再点击详情按钮查看音乐具体信息（内有服务器点歌按钮）
• 可将多个文件/文件夹拖入 播放队列管理界面/添加音乐界面 进行添加

服务端预设歌单

• 使用 /concerto export-as-playlist 或歌单详情页面按钮导出歌单
• 将导出的 JSON 文件放置于 Concerto/preset_radios 文件夹下
• 若文件名为 music_agent.json 将作为音乐点播室空闲时候的歌单
• 可用 /concerto-server reload 重新加载最新添加的预设歌单
• 玩家可在 Concerto 主菜单里看到服务端预设歌单的入口

服务端配置文件

• 文件位于 Concerto/server_config.json
• auditionRequired：通过 /sharemusic 分享给所有人的音乐是否需要审核（默认需要）
• serverMusicAgent：启用服务端歌曲点播功能（默认启用）
• agentInviteWhenJoin：主动邀请进入服务器的玩家加入歌曲点播（默认启用）
• musicRoomCommandPermission：音乐室创建的最低权限要求（默认为2）
• musicAgentAddTimeLimit：同一玩家两次歌曲点播时间间隔（默认为60秒）
• musicAgentUseShared：歌曲点播使用服务端解析播放链接（详见 服务器音乐点播，默认启用）

音乐分享（非一起听功能）

• 若服务器安装了 Concerto，则会隐藏地向服务器发送请求，否则将直接调用 /msg 指令（发送给个人）或直接发送在公屏（发送给所有人）。
• 服主可在服务端配置中配置审核分享给所有人的音乐。
• 分享的音乐需要对方确认才会在对方的客户端播放。
• 只允许分享被认为是安全的音乐（详见 安全的音乐来源）

音乐室

• 音乐室内所有人的音乐播放行为都会受到任意音乐室管理员的影响，例如：切换歌曲/暂停播放。
• 建议不要设置太多管理员以避免争抢问题。
• 创建音乐室时会自动复制 UUID 到剪贴板。
• 只允许分享被认为是