Concerto Plugin pour Minecraft 1.20.1, 26.2

Concerto

✨ Features

• Many sources, one player — NetEase Cloud Music, QQ Music, KuGou Music, local audio files (drag & drop), and direct HTTP links.
• Smooth playback – drag the progress bar to move through a track, keep listening while streams load, and choose an audio output option if the default does not suit your setup. Supported formats include MP3, OGG/Opus, FLAC, WAV, M4A/AAC, and AIFF.
• Music rooms (listen together) — members of a room share playback in real time: the same track, the same position, the same pauses. Rooms can be named, listed publicly, and joined from a browser screen or by UUID.
• Server-wide queue (KTV mode) — players queue songs for the whole server, vote to skip, and the server falls back to preset radios when the queue is empty.
• Shared access & preset playlists – server owners can configure their own supported music-service accounts for the server and share curated playlists with everyone.
• Cross-platform — Fabric and NeoForge on the client; a dedicated Paper plugin lets modded clients use every server feature on plugin servers.

📦 Installation

Platform - What to install

Fabric client - Concerto-mc-fabric-.jar + Fabric API NeoForge client - Concerto-mc-neoforge-.jar Paper server - Concerto-mc-paper-.jar into plugins/

Concerto stores its settings, playlists, downloads, and sign-in data in the Concerto/ folder next to the game or server directory.

You can use Concerto as a local player in singleplayer and on servers that do not have it installed. Shared rooms, sharing, and the server-wide queue need Concerto on the server too (Fabric, NeoForge, or Paper).

⌨️ Hotkeys

All hotkeys can be rebound in Options → Controls.

Default key - Action

I - Open the Concerto index (main menu) U - Open the playlist screen N - Play the next track P - Pause / resume

🖱️ Screens & Controls

Index screen (I)

Your starting point for playlists, music services (NetEase / QQ / KuGou), search, local files, links, music rooms, and settings.

Playlist screen (U)

• Drag & drop audio files or whole folders from your file manager to import them.
• Double-click an entry to play it; single click selects.
• Bottom row: next / play / delete / order (normal, random, reversed, loop) / pause / info / clear.
• In the server-wide queue, Play becomes Request in server and queues the selected song instead.
• The volume button pops up a slider (click anywhere else to dismiss). Volume changes apply instantly and are saved to the config.
• The search box filters the current playlist.

Playlist previews

• Select Save to Local to add the displayed playlist to Local Playlists immediately; it is also written as JSON under Concerto/local_playlists/.

Player screen

• Drag the progress bar to seek; a preview of the target position is shown while dragging.
• Shows title, artist, source, cover art, and buffering state for streamed tracks.

Music rooms screen

• Discovery view: lists the server's public (visible) rooms with one-click join, plus fields to create a named room, join by UUID, refresh, or enter the server queue.
• Management view (when you are in a room): member list, rename, toggle visible / joinable, grant co-op permission, and dissolve or leave the room.

Options screen

Use the in-game options to adjust audio output, HUD visibility, scrolling-text speed, NetEase audio quality, and more. Audio output changes take effect from the next track.

📜 Commands

Client player control – /concerto (alias /music)

The /music alias can be disabled with the registerMusicCommand client config option.

Most everyday actions are available from the screens above. Commands are optional shortcuts for players and server owners who prefer them.

Command - Description

/concerto pause - Toggle pause / resume /concerto start - Start the player if it is not running /concerto stop - Stop playback /concerto clear - Stop playback and clear the playlist /concerto restart - Restart the player core (recovers from a stuck state) /concerto reload - Reload configs, local playlists, and restart the player /concerto save - Cache the current track locally (cacheable sources only) /concerto like / dislike - Like / unlike the current track (NetEase Cloud Music only) /concerto download-current - Download the current track and its lyrics to Concerto/ /concerto download-all - Download every track in the current playlist /concerto export-as-playlist - Export the current playlist as a JSON preset playlist (Concerto/local_playlists) /concerto clean-cache - Wipe the client cache (music, images, verification files)

Music rooms & server queue — /musicroom (requires Concerto on the server)

Command - Description

/musicroom create [name] - Create (optionally named) and join a room; the room UUID is copied to your clipboard. Gated by the server's musicRoomCommandPermission /musicroom join - Join a room by UUID /musicroom quit - Leave the current room or the server queue /musicroom remove - Dissolve the room you own /musicroom members - Show the room owner and member list /musicroom op - Toggle a member's playback-control permission (owner only) /musicroom agent join / quit - Enter / leave the server-wide queue (KTV mode) /musicroom agent add - Push your currently playing track onto the server queue /musicroom agent vote - Start a skip vote for the current queued track /musicroom agent vote - Cast your vote in the running skip vote

Player-to-player sharing — /sharemusic

Command - Description

/sharemusic to - Share the current track with one player, or with everyone (@a goes through the server audit queue when audition is enabled). Sources that expose local file paths are refused as unsafe /sharemusic accept - Accept a share invitation /sharemusic reject - Reject a share invitation /sharemusic reject all - Reject all pending invitations /sharemusic list - List pending invitations (clickable accept / reject buttons)

Server administration — /concerto-server

All subcommands require permission level 2 (OP) except fetch-radios, which everyone may use.

Command - Description

/concerto-server audit - Approve a pending @a broadcast request /concerto-server audit reject - Reject a pending broadcast request /concerto-server audit reject all - Reject every pending request /concerto-server audit list - List the audit queue (clickable accept / reject buttons) /concerto-server reload - Reload the server config, preset radios, and platform cookies /concerto-server reload-cookie - Reload only the platform cookie files /concerto-server clean-cache - Wipe the server-side cache /concerto-server fetch-radios - Send the server's preset radios to your client /concerto-server agent reset - Reset the server queue completely /concerto-server agent cut - Force-skip the current queued track /concerto-server agent stop / start - Stop / restart KTV mode

📖 How-to

Listen together in a music room

• /musicroom create My Room (or use the music rooms screen) — the UUID lands in your clipboard.
• Hand the UUID to friends (/musicroom join ), or mark the room visible + joinable so it appears in everyone's room browser.
• Whatever the controlling members play, seek, or pause is mirrored to every member in real time. Use /musicroom op to decide who may control playback.

Run a server-wide queue (KTV mode)

• In the server's Concerto settings, leave the server-wide queue enabled. You can also choose whether players receive an invitation when they join.
• Players enter with /musicroom agent join, then use Request in server on a selected song. The /musicroom agent add command can still queue the current track; both are rate-limited by musicAgentAddTimeLimit.
• If the server resolves a song as a trial clip, everyone in the queue is notified.
• Anyone in the queue can start a skip vote: /musicroom agent vote, then others confirm with /musicroom agent vote true (or false).
• When the queue is empty the server plays its preset radios, if configured.

Share a music-service account with the server

• Sign in to the music service on your own client.
• Copy the .cookie files created in your client's Concerto/ folder to the server's Concerto/ folder. Treat these files like passwords.
• In the server's Concerto settings, enable shared account access for the queue, then run /concerto-server reload-cookie.

Ship preset playlists

Put exported playlist JSON files (see /concerto export-as-playlist) on the server under Concerto/preset_radios/; the special file music_agent.json is what KTV mode falls back to. Clients receive the radios automatically, or on demand via /concerto-server fetch-radios.

Cache & downloads

Concerto only saves music when you ask it to: use /concerto save for the current track, or download-current / download-all for permanent copies with lyrics. The cache size can be adjusted in the settings.

⚙️ Configuration

You do not need to edit files for normal use: the in-game options screen covers the common choices. The reference below is for players and server owners who want more control. Settings files are in Concerto/; edit them only while the game is closed.

client_config.json

Playback & networking

Key - Default - Meaning

playerVolume - 1.0 - Player volume, 0.0 – 1.0 playerVolumeFollowsMaster - true - Multiply by Minecraft's master volume playbackBackend - "JAVASOUND" - Audio backend: "JAVASOUND" or "OPENAL". Changing it takes effect from the next track displayPlayerScreenCoverAndSpectrum - true - Show cover art and the spectrum on the player screen; false uses the full-width lyrics view neteaseMusicQuality - "HIRES" - NetEase quality: "STANDARD", "HIGHER", "EXHIGH", "LOSSLESS", "HIRES" maxCacheSize - 100000000 - Cache budget in bytes (music and images each) handshakeRequired - true - Verify the Concerto handshake before using server features confirmAfterReceived - true - Ask before accepting an incoming share (false auto-accepts) joinAgentWhenInvited - false - Auto-accept the server's KTV invitation on join registerMusicCommand - true - Register the /music alias printRequestResults - false - Log platform API responses (debugging) kuGouMusicLite - false - Use the KuGou "concept/lite" endpoints autoGetKuGouDailyVIP - false - Claim KuGou's daily VIP automatically

HUD

Each HUD element has a display* switch, a position, an alignment (LEFT / CENTER / RIGHT), and ARGB colors:

Element - Keys

Lyrics - displayLyrics, lyricsPosition (default 0.5,1-100), lyricsAlignment, lyricsColor Sub-lyrics (translation) - displaySubLyrics, subLyricsPosition (default 0.5,1-89), subLyricsAlignment, subLyricsColor Track details - displayMusicDetails, musicDetailsPosition (default 1-30,0+5), musicDetailsAlignment, musicDetailsColor Time & progress bar - displayTimeProgress, timeProgressPosition (default 1-30,0+15), timeProgressAlignment, timeProgressTextColor, timeProgressColor, timeProgressBgColor Cover art - displayCoverImg, coverImgPosition (default 1-25,0), coverImgSize, coverImgInCircle, coverImgRotate Misc - textShadow, hideWhenChat, scrollingTextSpeed

• Position format: ±,±. 0.5,1-100 = horizontally centered, 100 px above the bottom edge; 1-30,0+15 = 30 px from the right, 15 px from the top.
• Color format: #AARRGGBB, e.g. #ffffffff opaque white, #ff00aaaa opaque teal.

server_config.json

Key - Default - Meaning

auditionRequired - true - @a broadcasts need OP approval via /concerto-server audit serverMusicAgent - true - Enable the server-wide queue (KTV mode) agentInviteWhenJoin - true - Invite players to the queue when they join musicRoomCommandPermission - 2 - Minimum permission level to create a music room musicAgentAddTimeLimit - 60 - Seconds a player must wait between queue submissions musicAgentUseShared - true - Resolve queued tracks through the server's own cookies kuGouMusicLite - false - Use the KuGou lite endpoints server-side (also pushed to clients)

❓ FAQ

How do I set up a music-service account on a server? Sign in on your own client first, then copy the .cookie files from the client's Concerto/ folder to the server's. Run /concerto-server reload-cookie afterwards. Keep these files private: they grant access to your account.

NetEase keeps erroring after a QR-code login. NetEase's risk control flags logins from new devices/locations aggressively. Skip QR/password login and paste the complete cookie of an existing, working browser session instead.

QQ Music stops resolving after a few days. QQ Music cookies expire quickly by design. Refresh the cookie files on the server and run /concerto-server reload-cookie.

Which audio output option should I pick? JAVASOUND is the recommended default. Try OPENAL if playback stutters or uses the wrong device. The change applies from the next track.

Moving through a track is slow sometimes. Some streamed files and radio sources cannot jump directly to every position, so Concerto may need a moment to catch up. Moving within recently played audio is usually faster.

Which local audio files can I play? Concerto supports MP3, OGG/Opus, FLAC, WAV, M4A/AAC, and AIFF. Support for unusual encodings inside those containers can vary, so converting a problematic file to MP3 or WAV is still a useful fallback.

The player is stuck / silent after an error. /concerto restart resets the player core without touching your playlist. If screens render wrongly or covers are black, /concerto clean-cache, and as a last resort delete Concerto/cache while the game is closed.

Room / sharing commands say the feature is unavailable. Those features need Concerto on the server (Fabric, NeoForge, or the Paper plugin). On vanilla servers the mod still works as a purely local player.

My volume resets or ignores the slider. If playerVolumeFollowsMaster is on, the effective volume is playerVolume × master volume — check Minecraft's own Music & Sounds settings too.

✨ 功能亮点

• 多来源，一个播放器 —— 网易云音乐、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 显隐、滚动文字速度、网易云音质等。切换音频输出会从下一首开始生效。