Concerto

Concerto

✨ Возможности

• Много источников, один плеер — NetEase Cloud Music, QQ Music, KuGou Music, локальные аудиофайлы (перетаскиванием) и прямые HTTP-ссылки.
• Плавное воспроизведение — перетаскивай полосу прогресса, чтобы перемещаться по треку, слушай дальше, пока загружается поток, и выбирай вариант аудиовыхода, если стандартный тебе не подходит. Поддерживаются форматы MP3, OGG/Opus, FLAC, WAV, M4A/AAC и AIFF.
• Музыкальные комнаты (слушаем вместе) — участники комнаты синхронно воспроизводят музыку в реальном времени: один и тот же трек, одна и та же позиция, одни и те же паузы. Комнатам можно давать названия, они могут отображаться в общем списке, а присоединиться можно через экран в браузере или по UUID.
• Очередь на весь сервер (режим KTV) — игроки заказывают песни для всего сервера, голосуют за пропуск, а когда очередь пуста, сервер переключается на предустановленные радиостанции.
• Общий доступ и готовые плейлисты — владельцы серверов могут настроить собственные аккаунты поддерживаемых музыкальных сервисов для сервера и делиться подборками плейлистов со всеми.
• Кроссплатформенность — Fabric и NeoForge на клиенте; отдельный плагин для Paper позволяет клиентам с модами использовать все серверные функции на плагин-серверах.

📦 Установка

Concerto хранит свои настройки, плейлисты, загрузки и данные входа в папке Concerto/ рядом с папкой игры или сервера.

Concerto можно использовать как локальный плеер в одиночной игре и на серверах, где он не установлен. Общие комнаты, общий доступ и очередь на весь сервер требуют Concerto и на сервере (Fabric, NeoForge или Paper).

⌨️ Горячие клавиши

Все горячие клавиши можно переназначить в Настройки → Управление.

🖱️ Экраны и управление

Главный экран (I)

Твоя отправная точка для плейлистов, музыкальных сервисов (NetEase / QQ / KuGou), поиска, локальных файлов, ссылок, музыкальных комнат и настроек.

Экран плейлиста (U)

• Перетаскивай аудиофайлы или целые папки из файлового менеджера, чтобы импортировать их.
• Двойной клик по записи запускает её; одиночный клик выделяет.
• Нижний ряд: следующий / воспроизведение / удалить / порядок (обычный, случайный, обратный, повтор) / пауза / информация / очистить.
• В очереди на весь сервер кнопка Воспроизведение превращается в Заказать на сервере и ставит выбранную песню в очередь.
• Кнопка громкости открывает ползунок (клик в любом другом месте закрывает его). Изменения громкости применяются сразу и сохраняются в конфиг.
• Поле поиска фильтрует текущий плейлист.

Предпросмотр плейлистов

• Выбери Сохранить локально, чтобы сразу добавить отображаемый плейлист в Локальные плейлисты; он также записывается в формате JSON в Concerto/local_playlists/.

Экран плеера

• Перетаскивай полосу прогресса, чтобы перемотать; во время перетаскивания показывается предпросмотр целевой позиции.
• Отображает название, исполнителя, источник, обложку и состояние буферизации для потоковых треков.

Экран музыкальных комнат

• Режим обзора: список публичных (видимых) комнат сервера с присоединением в один клик, а также поля для создания именованной комнаты, присоединения по UUID, обновления списка или входа в серверную очередь.
• Режим управления (когда ты в комнате): список участников, переименование, переключение видимости / возможности присоединиться, выдача прав со-ведущего, а также роспуск или выход из комнаты.

Экран настроек

Через игровые настройки можно менять аудиовыход, видимость HUD, скорость прокрутки текста, качество звука NetEase и многое другое. Изменения аудиовыхода вступают в силу со следующего трека.

📜 Команды

Управление клиентским плеером – /concerto (алиас /music)

Алиас /music можно отключить опцией клиентского конфига registerMusicCommand.

Большинство повседневных действий доступно через экраны выше. Команды — это необязательные сокращения для игроков и владельцев серверов, которым так удобнее.

Музыкальные комнаты и серверная очередь — /musicroom (требуется Concerto на сервере)

Обмен музыкой между игроками — /sharemusic

Администрирование сервера — /concerto-server

Все подкоманды требуют уровень прав 2 (OP), кроме fetch-radios, которую может использовать любой игрок.

📖 Как пользоваться

Слушайте вместе в музыкальной комнате

1. /musicroom create My Room (или через экран музыкальных комнат) — UUID попадёт в буфер обмена.
2. Передайте UUID друзьям (`/musicroom join `) или отметьте комнату как видимую и доступную для входа, чтобы она появилась в браузере комнат у всех.
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. Скопируйте файлы .cookie, созданные в папке Concerto/ вашего клиента, в папку 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

Воспроизведение и сеть

HUD

У каждого элемента HUD есть переключатель display*, позиция, выравнивание (LEFT / CENTER / RIGHT) и цвета в формате ARGB:

• Формат позиции: <доля по x>±<пиксели>,<доля по y>±<пиксели>. 0.5,1-100 = по центру по горизонтали, 100 px от нижнего края; 1-30,0+15 = 30 px от правого края, 15 px от верхнего.
• Формат цвета: #AARRGGBB, например #ffffffff — непрозрачный белый, #ff00aaaa — непрозрачный бирюзовый.

server_config.json

❓ FAQ

Как настроить аккаунт музыкального сервиса на сервере? Сначала войдите в него на своём клиенте, затем скопируйте файлы .cookie из папки Concerto/ клиента в такую же папку на сервере. После этого выполните /concerto-server reload-cookie. Держите эти файлы в секрете: они дают доступ к вашему аккаунту.

NetEase постоянно выдаёт ошибку после входа по QR-коду. Система контроля рисков NetEase агрессивно помечает входы с новых устройств и из новых мест. Не входите по QR-коду или паролю, а вставьте полный cookie уже работающей сессии из браузера.

QQ Music перестаёт работать через несколько дней. Cookie QQ Music быстро истекают — так задумано. Обновите файлы 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 — проверьте также настройки Music & Sounds в самом Minecraft.

✨ Особенности

• Много источников, один плеер — NetEase Cloud Music, QQ Music, Kugou Music, локальные аудиофайлы (с поддержкой drag-and-drop), прямые HTTP-ссылки — всё в одной очереди воспроизведения.
• Плавное воспроизведение — перетащите ползунок, чтобы перемотать, потоковая загрузка не прерывает прослушивание; если вывод по умолчанию не подходит, можно переключить способ вывода звука. Поддерживаются MP3, OGG/Opus, FLAC, WAV, M4A/AAC и AIFF.
• Музыкальная комната (слушаем вместе) — участники одной комнаты в реальном времени делят состояние воспроизведения: одна песня, один прогресс, синхронная пауза. Комнату можно назвать, сделать публичной, присоединиться в один клик из списка комнат или по UUID.
• Общий заказ музыки (режим KTV) — игроки ставят песни в очередь на весь сервер, можно запустить голосование за смену трека; когда никто не заказывает, автоматически играет серверный плейлист.
• Общие аккаунты и готовые плейлисты — владелец сервера может настроить свой авторизованный аккаунт музыкального сервиса и поделиться подготовленным плейлистом со всеми игроками.
• Кроссплатформенность — клиент поддерживает Fabric и NeoForge; для плагин-серверов есть отдельный плагин Paper, а модовый клиент на плагин-сервере тоже получает доступ ко всем серверным функциям.

📦 Установка

Concerto хранит настройки, плейлисты, загруженный контент и данные входа в папке Concerto/ рядом с директорией игры или сервера.

В одиночной игре и на серверах без Concerto его можно использовать как локальный плеер; для музыкальных комнат, обмена музыкой и общего заказа музыки Concerto должен быть установлен и на сервере (Fabric, NeoForge или Paper — любой).

⌨️ Горячие клавиши

Все эти клавиши можно переназначить в Настройки → Управление.

🖱️ Интерфейс и управление

Главное меню (I)

Единая точка входа для плейлистов, каталогов NetEase / QQ / Kugou, поиска, локальных файлов, ссылок, музыкальных комнат и настроек.

Интерфейс плейлиста (U)

• Перетаскивайте аудиофайлы или целые папки прямо из файлового менеджера для импорта.
• Двойной клик по элементу — воспроизвести, одиночный — выбрать.
• Нижний ряд кнопок: следующий трек / воспроизвести / удалить / порядок воспроизведения (по порядку, случайно, в обратном порядке, повтор одного трека) / пауза / подробности / очистить.
• После подключения к общему заказу музыки кнопка воспроизвести превращается в заказать на сервере и добавляет выбранную песню в серверную очередь.
• Кнопка громкости открывает ползунок, который автоматически скрывается при клике в любом другом месте интерфейса; громкость применяется сразу и сохраняется в конфиг.
• Поле поиска сверху фильтрует текущий список.

Предпросмотр плейлиста

• Нажмите сохранить локально, чтобы сразу добавить текущий плейлист в локальные плейлисты; одновременно он записывается в JSON-файл в Concerto/local_playlists/.

Интерфейс плеера

• Перетаскивайте ползунок, чтобы перейти к позиции воспроизведения; во время перетаскивания показывается предпросмотр целевой позиции.
• Отображаются название, исполнитель, источник, обложка; для потоковых треков показывается состояние буферизации.

Интерфейс музыкальной комнаты

• Режим обзора: список публичных (видимых) комнат на сервере, присоединение в один клик; здесь же можно создать комнату с названием, присоединиться по UUID, обновить список или перейти к общему заказу музыки.
• Режим управления (когда вы уже в комнате): список участников, переименование, переключение видимая / доступная для входа, выдача прав участникам, роспуск или выход из комнаты.

Интерфейс настроек

В игровых настройках можно изменить вывод звука, отображение HUD, скорость прокрутки текста, качество звука NetEase и другое. Смена вывода звука вступает в силу со следующего трека.

📜 Список команд

Управление воспроизведением на клиенте — /concerto (алиас /music)

Алиас /music можно отключить через клиентскую настройку registerMusicCommand.

Все повседневные действия выполняются через интерфейс выше; команды ниже — лишь дополнение для любителей горячих клавиш и владельцев серверов.

Музыкальные комнаты и общий заказ музыки — /musicroom (требуется Concerto на сервере)

Обмен музыкой между игроками — /sharemusic

Управление сервером —— /concerto-server

Кроме fetch-radios, доступной всем, остальные подкоманды требуют 2-й уровень прав (OP).

📖 Руководство по использованию

«Слушать вместе» с друзьями

1. /musicroom create 我的房间 (или через интерфейс музыкальной комнаты), UUID автоматически попадёт в буфер обмена.
2. Отправьте UUID другу (`/musicroom join `); или сделайте комнату видимой + доступной для присоединения, чтобы она появилась в списке комнат у всех.
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

Воспроизведение и сеть

Отображение HUD

У каждого элемента HUD есть переключатель display*, позиция, выравнивание (LEFT / CENTER / RIGHT) и цвет ARGB:

• Формат позиции: <доля по горизонтали>±<пиксели>,<доля по вертикали>±<пиксели>. Например, 0.5,1-100 означает выравнивание по центру по горизонтали и 100 пикселей от нижнего края; 1-30,0+15 означает 30 пикселей от правого края и 15 пикселей от верхнего края.
• Формат цвета: #AARRGGBB, например #ffffffff — непрозрачный чисто белый, #ff00aaaa — непрозрачный голубой.

server_config.json

❓ 常见问题

怎样在服务端配置音乐服务账号？ 先在自己的客户端登录，再把客户端 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 自己的音乐音量设置。