基于 Fabric 的 Minecraft 内置音乐播放器。支持本地文件、网络资源、网易云音乐、QQ音乐。支持多人游戏音乐室（一起听）、歌曲点播（KTV模式）、服务端预设歌单、共享 VIP 歌曲等功能。
本模组仅供学习使用，不得非法利用本模组。请在使用前阅读 协议。如有侵权，请联系删除。
酷狗音乐相关代码由 ming-sc 贡献。
Wiki 基准模组版本：1.4.1
目前已知支持版本：1.21.7, 1.21.6, 1.21.5, 1.21.4, 1.21.1, 1.21, 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: 重新加载播放队列和客户端配置文件restart: 重新启动播放器（可修复卡死）list [页码]: 显示第[页码]页播放队列（10条歌曲一页）save: 缓存当前歌曲（详见 可缓存歌曲）like: 喜欢当前歌曲（详见 喜欢歌曲）dislike: 取消喜欢当前歌曲download-current: 下载当前歌曲到Concerto文件夹（包括歌词文件）download-all: 下载播放队列中的所有歌曲到Concerto文件夹（包括歌词文件）export-as-playlist: 导出当前播放队列为服务端预设歌单格式JSON（详见 服务端预设歌单）clean-cache: 删除客户端Concerto/cache文件夹下所有文件（包括cookie） -
/concerto-server（服务端指令，仅限管理员）audit [UUID]: 审核通过分享给所有人的音乐（详见/sharemusic指令）audit reject [UUID]: 拒绝分享给所有人的音乐audit reject all: 拒绝所有分享给所有人的音乐audit list [页码]: 列出第[页码]页的待审歌曲清单reload: 重新加载服务端配置文件（详见 服务端配置文件）reload-cookie: 重新加载所有cookie文件clean-cache: 删除服务端Concerto/cache文件夹下所有文件（包括cookie）fetch-radios: 技术性指令，同步服务端预设歌单到本地（允许普通用户使用）agent reset: 重新加载服务端歌曲点播队列agent cut: 强制让服务端点播队列播放下一首/切歌agent stop: 停止点播歌曲的播放（注意：当前歌曲会被直接切掉）agent start: 继续点播歌曲的播放（注意：从下一首开始） -
/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]: 给当前进行的切歌投票投 赞成/反对
- 按
U打开播放队列管理界面； - 单击选中音乐，再点击播放按钮（或直接双击某条音乐）开始播放
- 单击选中音乐，再点击详情按钮查看音乐具体信息（内有服务器点歌按钮）
- 可将多个文件/文件夹拖入 播放队列管理界面/添加音乐界面 进行添加
- 使用
/concerto export-as-playlist或歌单详情页面按钮导出歌单 - 导出的
JSON文件已经被放置于Concerto/local_playlists文件夹下 - 可用
/concerto reload重新加载最新添加的预设歌单 - 可在 Concerto 主菜单里看到本地预设歌单的入口
- 使用
/concerto export-as-playlist或歌单详情页面按钮导出歌单 - 将导出的
JSON文件复制并放置于Concerto/preset_radios文件夹下（默认是导出到本地的文件夹，Concerto/local_playlists） - 若文件名为
music_agent.json将作为音乐点播室空闲时候的歌单 - 可用
/concerto-server reload重新加载最新添加的预设歌单 - 服务器玩家可在 Concerto 主菜单里看到服务端预设歌单的入口
- 文件位于
Concerto/server_config.json auditionRequired: 通过/sharemusic分享给所有人的音乐是否需要审核（默认需要）serverMusicAgent：启用服务端歌曲点播功能（默认启用）agentInviteWhenJoin：主动邀请进入服务器的玩家加入歌曲点播（默认启用）musicRoomCommandPermission：音乐室创建的最低权限要求（默认为2）musicAgentAddTimeLimit: 同一玩家两次歌曲点播时间间隔（默认为60秒）musicAgentUseShared: 歌曲点播使用服务端解析播放链接（详见 服务器音乐点播，默认启用）
- 若服务器安装了 Concerto，则会隐藏地向服务器发送请求，否则将直接调用
/msg指令（发送给个人）或直接发送在公屏（发送给所有人）。 - 服主可在服务端配置中配置审核分享给所有人的音乐。
- 分享的音乐需要对方确认才会在对方的客户端播放。
- 只允许分享被认为是安全的音乐（详见 安全的音乐来源）
- 音乐室内所有人的音乐播放行为都会受到任意音乐室管理员的影响，例如：切换歌曲/暂停播放。
- 建议不要设置太多管理员以避免争抢问题。
- 创建音乐室时会自动复制 UUID 到剪贴板。
- 只允许分享被认为是安全的音乐（详见 安全的音乐来源）
- 选中音乐条目，点击详情按钮，歌曲详情页面内有服务器点歌按钮。若服务可用，则按钮可用。
- 可用
/musicroom agent vote指令发起投票/参与投票 - 服主可在本地登录VIP账号后将
Concerto文件夹下cookie文件复制到服务端，并开启服务端配置选项中的musicAgentUseShared，即可实现VIP歌曲点播。（若服务端运行过程中复制进去，需要重启服务端） - 若存在文件
Concerto/preset_radios/music_agent.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）textShadow: 歌词/音乐信息显示文字阴影（默认开启）
基本格式：[横向比例](+/-)[横向偏移],[纵向比例](+/-)[纵向偏移]，若偏移量为0可省略（包括加减号）
例如，0.5,1-70 表示屏幕横向中心点底部向上70像素的位置，1-5,0+5 表示屏幕右上角分别向下向左5像素的位置
基本格式：(0x|#)[8位16进制数]，每两位分别表示ARGB，建议使用在线拾色器（若复制的只有6位，请手动在前面加上两位 ff），请注意最前面需要加 0x 或 #
例如，#ffffffff 表示完全不透明的纯白色，#ff00aaaa 表示完全不透明的青色
即网易云音乐，QQ音乐以及其他网络资源
仅支持网易云音乐
即网易云音乐和QQ音乐，不含本地资源、其他网络资源
- 方法1: 打开对应网站登录后，电脑浏览器点按 F12 打开开发者面板的网络面板 (Network)，刷新页面，点击第一个条目，往下滑动找到并复制所有Cookie
- 方法2（推荐）: 使用 Cookie-Editor 浏览器插件
-
Q: 网易云音乐用密码或验证码登录时出现“当前登录存在安全风险”
-
A: 网易云风控导致，请优先考虑使用二维码登录或直接复制Cookie
-
Q: QQ音乐无法查看个人歌单/无法播放
-
A: 尝试重新登录
-
Q: QQ音乐服务端cookie隔一段时间就失效
-
A: 只能重新复制，目前无解决方法。可用
/concerto-server reload-cookie重新加载cookie -
Q: neoforge+互联环境下二维码无法加载
-
A: 使用
/concerto clean-cache清除缓存后重试，如果还是不行，删除.minecraft/Concerto/cache文件夹