Concerto

Concerto для Minecraft - это когда игра становится твоим музыкальным хабом. Вместо того чтобы сворачивать окно ради смены трека или держать открытым браузер с плейлистом, ты управляешь всем прямо из интерфейса Майнкрафт: ставишь локальные MP3, стримишь с Нетиза или QQ Music, кидаешь ссылку на любой HTTP-поток и получаешь нормальный плеер с прогресс-баром, обложками и синхронными текстами песен.

Зачем это нужно

Во время долгих копательных сессий, стройки или фарма музыка задаёт атмосферу. Concerto убирает необходимость переключаться между окнами: ты можешь собрать плейлист из разных источников - от локальных FLAC до китайских стриминговых сервисов - и слушать всё в едином интерфейсе, не вылетая из игры. А если играешь с друзьями, мод позволяет синхронизировать воспроизведение: все слышат один трек в одно время, как в настоящей совместной комнате прослушивания.

На сервере можно запустить общую очередь в стиле караоке-бара: каждый игрок добавляет свою песню, остальные голосуют за пропуск, если не зашло. Когда никто не ставит треки, сервер сам включает заготовленные плейлисты. Это особенно удобно на творческих серверах, в лобби или во время ивентов - музыка превращается в часть общего опыта, а не личный фон каждого.

Основные возможности

Один плеер для всех источников

Concerto поддерживает несколько типов контента одновременно:

• Музыкальные сервисы - NetEase Cloud Music (НетИз), QQ Music, KuGou Music. Логинишься один раз, получаешь доступ к миллионам треков.
• Локальные файлы - MP3, OGG/Opus, FLAC, WAV, M4A/AAC, AIFF. Просто перетаскиваешь файлы или целые папки в окно плейлиста.
• Прямые ссылки - вставил HTTP-адрес потока, и мод начинает воспроизведение.

Всё это оказывается в одной очереди. Можно чередовать локальный альбом с онлайн-плейлистом Нетиза и прямым потоком интернет-радио - Концерто переключается между источниками без пауз и не требует перезапуска плеера.

Комнаты для совместного прослушивания

Создаёшь комнату (/musicroom create Моя Комната), получаешь UUID в буфер обмена и кидаешь друзьям. Все, кто зашёл, слышат одну и ту же песню на одной и той же секунде. Если хост перемотал трек или поставил на паузу - остальные видят это мгновенно. Можно давать контроль над плейлистом любому участнику через /musicroom op, делать комнату публичной (она появится в общем списке на сервере) или приватной (только по UUID).

Это удобно для стройки в команде: вместо того чтобы каждый слушал своё, весь отряд движется под один саундтрек. Или во время PvP-турнира можно настроить боевой плейлист для всех зрителей.

Общесерверная очередь (KTV-режим)

Аналог караоке-системы: каждый игрок может предложить трек (кнопка Сервер-заявка в плейлисте или команда /musicroom agent add), и песня встаёт в общую очередь. Все участники очереди слышат один поток. Если трек не понравился, любой может инициировать голосование за пропуск (/musicroom agent vote), остальные голосуют true или false. Набралось большинство - песня улетает, включается следующая.

Когда очередь пустеет, сервер автоматически запускает заранее подготовленные плейлисты (preset radios). Админы могут положить готовые JSON-файлы с треками в Concerto/preset_radios/ - игроки получат эти списки автоматически или по команде /concerto-server fetch-radios.

Шаринг аккаунтов и плейлистов

Если у тебя есть подписка на Нетиз или QQ Music, можно залогиниться на клиенте, скопировать .cookie-файлы в папку сервера и запустить /concerto-server reload-cookie. Теперь все игроки на сервере смогут слушать треки через твой аккаунт - не нужно, чтобы у каждого была своя подписка. Удобно для приватных серверов с друзьями.

Аналогично работают серверные плейлисты: экспортируешь свою подборку командой /concerto export-as-playlist, кидаешь JSON на сервер, и она становится доступна всем.

Делиться треками между игроками

Услышал крутую песню и хочешь показать другу? Команда /sharemusic to <ник> отправляет ему приглашение. Он принимает (/sharemusic accept <uuid>), и у него начинается воспроизведение того же трека. Есть режим broadcast - /sharemusic to @a рассылает песню всему серверу, но если включена модерация (auditionRequired), запрос сначала уходит в очередь к админам для проверки.

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

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

Открывает центральный хаб: отсюда доступны локальные плейлисты, поиск по музыкальным сервисам, комнаты, настройки и ссылки на прямые потоки. Всё в одном месте.

Плейлист (U)

Двойной клик по треку - воспроизведение, одинарный - выбор. Внизу кнопки: следующий трек, пауза, удалить, режим повтора (обычный, случайный, реверс, зацикленный), информация о песне, очистка списка. Если ты в общесерверной очереди, кноп��а Играть превращается в Добавить в очередь сервера.

Drag & drop работает из проводника: хватаешь папку с музыкой и кидаешь в окно - мод сам импортирует всё, что внутри. Поддерживаются MP3, OGG, FLAC, WAV, M4A и AIFF.

Громкость регулируется отдельной кнопкой со слайдером; изменения сохраняются мгновенно. Поиск по плейлисту работает через текстовое поле вверху.

Экран воспроизведения

Показывает название, исполнителя, обложку, прогресс-бар. Можно перетащить ползунок в любое место трека - во время перетаскивания появляется превью целевой позиции. Для стриминговых источников отображается статус буферизации.

Комнаты

Два режима:

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

Настройки

В игровых опциях можно выбрать аудио-бэкенд (JAVASOUND или OPENAL), качество Нетиза (STANDARD до HIRES), размер кэша, видимость HUD-элементов, скорость прокрутки текстов. Смена бэкенда применяется со следующего трека.

Установка и требования

Платформа	Файлы
Fabric-клиент	Concerto-mc<версия>-fabric-<версия мода>.jar + Fabric API
NeoForge-клиент	Concerto-mc<версия>-neoforge-<версия мода>.jar
Paper-сервер	Concerto-mc<версия>-paper-<версия мода>.jar в папку plugins/

Мод работает на Minecraft Java от 1.16 до последних версий (26.2 по данным Modrinth). Все настройки, плейлисты, скачанные треки и cookie-файлы сохраняются в папке Concerto/ рядом с основной директорией игры или сервера.

Если сервер не имеет Concerto, мод всё равно функционирует как локальный плеер. Комнаты, шаринг и общесерверная очередь требуют установки мода на сервере (Fabric, NeoForge или Paper-плагин).

Команды

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

Команда	Действие
/concerto pause	Пауза / продолжить
/concerto start	Запустить плеер
/concerto stop	Остановить воспроизведение
/concerto clear	Остановить и очистить плейлист
/concerto restart	Перезапустить ядро плеера (если завис)
/concerto reload	Перезагрузить конфиги и локальные плейлисты
/concerto save	Закешировать текущий трек локально
/concerto like / dislike	Лайк / дизлайк (только NetEase)
/concerto download-current	Скачать текущий трек с текстами в Concerto/
/concerto download-all	Скачать весь плейлист
/concerto export-as-playlist	Экспортировать плейлист в JSON
/concerto clean-cache	Очистить кэш клиента

Комнаты и очередь - /musicroom

Команда	Действие
/musicroom create [название]	Создать комнату (UUID копируется в буфер)
/musicroom join <uuid>	Войти в комнату по UUID
/musicroom quit	Выйти из комнаты или очереди
/musicroom remove	Удалить свою комнату
/musicroom members	Список участников
/musicroom op <игрок>	Дать / отобрать права управления
/musicroom agent join / quit	Войти / выйти из общесерверной очереди
/musicroom agent add	Добавить текущий трек в очередь сервера
/musicroom agent vote	Начать голосование за пропуск
/musicroom agent vote <true/false>	Проголосовать за или против

Шаринг - /sharemusic

Команда	Действие
/sharemusic to <игрок / @a>	Поделиться треком с игроком или всем сервером
/sharemusic accept <uuid>	Принять приглашение
/sharemusic reject <uuid>	Отклонить приглашение
/sharemusic reject all	Отклонить все
/sharemusic list <страница>	Список приглашений

Администрирование - /concerto-server (требует OP)

Команда	Действие
/concerto-server audit <uuid>	Одобрить broadcast-запрос
/concerto-server audit reject <uuid>	Отклонить запрос
/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 <ник>.

Это удобно для строительных проектов: вся команда движется под единый саундтрек, не нужно каждому настраивать свой плейлист.

Запуск общесерверного караоке

1. В серверных настройках Concerto оставь включённым режим очереди. Можно настроить автоматическое приглашение при входе на сервер.
2. Игроки заходят в очередь командой /musicroom agent join, затем выбирают песню и жмут Добавить в очередь сервера. Команда /musicroom agent add тоже работает, обе ограничены параметром musicAgentAddTimeLimit (по умолчанию 60 секунд между заявками).
3. Если сервер не может получить полный трек и возвращает только превью, об этом уведомляются все участники очереди.
4. Не нравится трек - любой участник может запустить голосование командой /musicroom agent vote, остальные голосуют true или false. Набралось большинство - песня скипается.
5. Когда очередь пустая, сервер проигрывает заготовленные плейлисты из Concerto/preset_radios/ (если настроены).

Общий доступ к музыкальному сервису

1. Залогинься в Нетиз, QQ Music или КуГоу на своём клиенте.
2. Файлы .cookie появятся в папке клиента Concerto/. Скопируй их в ту же папку на сервере.
3. В серверных настройках включи опцию musicAgentUseShared и выполни /concerto-server reload-cookie.

Теперь все игроки смогут слушать треки через твой аккаунт, не логинясь сами. Относись к cookie-файлам как к паролям - они дают полный доступ к учётной записи.

Серверные плейлисты

Экспортируй свой плейлист командой /concerto export-as-playlist, получишь JSON-файл в Concerto/local_playlists/. Скопируй его на сервер в Concerto/preset_radios/. Клиенты подхватят эти списки автоматически или по команде /concerto-server fetch-radios. Файл music_agent.json - это то, что играет в KTV-режиме, когда никто не ставит треки.

Кэш и загрузки

Concerto кэширует музыку только по твоей команде. /concerto save сохранит текущий трек в локальный кэш, /concerto download-current скачает его вместе с текстами песни в папку Concerto/. /concerto download-all загрузит весь активный плейлист. Размер кэша настраивается через maxCacheSize в client_config.json (по умолчанию 100 МБ).

Конфигурация

Для повседневного использования редактировать файлы не нужно - игровые настройки покрывают основные опции. Ниже справка для тех, кто хочет тонкой настройки. Файлы лежат в Concerto/; редактируй их только при закрытой игре.

client_config.json

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

Параметр	По умолчанию	Описание
playerVolume	1.0	Громкость плеера (0.0 - 1.0)
playerVolumeFollowsMaster	true	Умножать на мастер-громкость Minecraft
playbackBackend	"JAVASOUND"	Аудио-бэкенд: "JAVASOUND" или "OPENAL"
displayPlayerScreenCoverAndSpectrum	true	Показывать обложку и спектр на экране плеера
neteaseMusicQuality	"HIRES"	Качество Нетиза: от "STANDARD" до "HIRES"
maxCacheSize	100000000	Лимит кэша в байтах (музыка и картинки отдельно)
handshakeRequired	true	Требовать handshake перед использованием серверных функций
confirmAfterReceived	true	Спрашивать перед приёмом шаринга (false = авто-принятие)
joinAgentWhenInvited	false	Автоматически заходить в очередь при приглашении
registerMusicCommand	true	Регистрировать алиас /music
printRequestResults	false	Логировать ответы API (отладка)
kuGouMusicLite	false	Использовать lite-эндпоинты КуГоу
autoGetKuGouDailyVIP	false	Авто-получение дневного VIP КуГоу

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	Broadcast @a требует одобрения через /concerto-server audit
serverMusicAgent	true	Включить общесерверную очередь (KTV)
agentInviteWhenJoin	true	Приглашать игроков в очередь при входе
musicRoomCommandPermission	2	Минимальный уровень прав для создания комнат
musicAgentAddTimeLimit	60	Секунд между заявками одного игрока в очередь
musicAgentUseShared	true	Резолвить треки через серверные cookie
kuGouMusicLite	false	Использовать lite-эндпоинты КуГоу (распространяется на клиентов)

Частые вопросы

Как настроить музыкальный сервис на сервере? Залогинься на своём клиенте, скопируй файлы .cookie из клиентской папки Concerto/ в серверную, выполни /concerto-server reload-cookie. Храни cookie как пароли - они дают доступ к аккаунту.

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

QQ Music перестаёт работать через пару дней. Cookie QQ Music быстро истекают. Обнови файлы на сервере и запусти /concerto-server reload-cookie.

Какой аудио-бэкенд выбрать? JAVASOUND - рекомендованный вариант. Если звук тормозит или идёт на неправильное устройство, попробуй OPENAL. Смена применяется со следующего трека.

Перемотка иногда работает медленно. Некоторые стриминговые источники и радио не поддерживают произвольный переход, поэтому 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. Проверь настройки звука в самой игре.

Для чего это всё

Concerto превращает Minecraft в социальный музыкальный хаб. Вместо того чтобы каждый сидел в своём Spotify или YouTube, вы слушаете одно и то же в реальном времени, обсуждаете треки в чате, голосуете за пропуск, делитесь находками. Для творческих серверов, лобби-серверов и просто компаний друзей это способ добавить общую атмосферу без необходимости выходить из игры или настраивать сторонние Discord-боты.

Плюс мод полезен для одиночной игры: собрал плейлист из разных источников, настроил HUD с текстами песен и обложкой, и теперь длинные сессии копания или фарма проходят под собственный саундтрек, а не под дефолтную музыку Майнкрафт.

Если ты запускаешь сервер для друзей, можешь настроить Concerto на BungeeHost в пару кликов: плагин ставится автоматически, комнаты и общая очередь заработают сразу после перезапуска. Это один из немногих способов организовать синхронное прослушивание музыки прямо в игре, без сторонних программ и ботов.

Скачать мод Concerto стоит, если хочешь объединить разные музыкальные источники в единый интерфейс, слушать треки вместе с друзьями в реальном времени или просто иметь нормальный плеер с обложками и текстами песен, не покидая Minecraft.