Мод для Майнкрафт, который добавляет музыкальный проигрыватель с локальными файлами, прямыми HTTP-ссылками и сервисами NetEase Cloud Music, QQ Music и KuGou Music. Музыку можно слушать в одиночку, вместе с участниками музыкальной комнаты или через общую очередь сервера.
Возможности
- Поддерживаются MP3, OGG/Opus, FLAC, WAV, M4A/AAC и AIFF; файлы и целые папки можно перетаскивать в список воспроизведения.
- У треков доступны обложка, исполнитель, источник, текст, перемотка по полосе прогресса и режимы порядка: обычный, случайный, обратный и повтор.
- Музыкальные комнаты синхронизируют для участников трек, позицию и паузу. Комнату можно назвать, открыть для списка комнат, разрешить вход и выдать отдельным игрокам право управления.
- В режиме общей очереди игроки предлагают песни серверу и голосуют за пропуск текущего трека. Когда очередь пуста, включается подготовленный сервером список радиостанций.
- Можно отправлять текущий трек другому игроку или всем игрокам, принимать и отклонять приглашения.
- Проигрыватель показывает текст, перевод текста, сведения о треке, время, полосу прогресса и обложку на экране; их вид и положение меняются в настройках.
Как пользоваться
Клавиши можно переназначить в меню «Настройки» → «Управление»:
I— открыть главное окно;U— открыть список воспроизведения;N— следующий трек;P— пауза или продолжение.
В списке воспроизведения дважды нажмите на композицию, чтобы включить её. В музыкальной комнате создайте её командой /musicroom create [name], передайте друзьям UUID и предложите им выполнить /musicroom join <uuid>. Для общей очереди используйте /musicroom agent join, затем добавьте текущий трек через /musicroom agent add или кнопку запроса песни на сервере.
Основные команды проигрывателя: /concerto pause, /concerto start, /concerto stop, /concerto clear, /concerto restart, /concerto reload, /concerto save, /concerto download-current, /concerto download-all, /concerto export-as-playlist и /concerto clean-cache. У /concerto есть отключаемый псевдоним /music.
Команды комнаты и очереди: /musicroom quit, /musicroom remove, /musicroom members, /musicroom op <player>, /musicroom agent vote и /musicroom agent vote <true|false>. Для обмена музыкой предназначены /sharemusic to <player|@a>, /sharemusic accept <uuid>, /sharemusic reject <uuid>, /sharemusic reject all и /sharemusic list <page>.
Администраторы используют /concerto-server: проверка общих отправок — audit, обновление настроек и файлов входа — reload и reload-cookie, управление очередью — agent reset, agent cut, agent stop и agent start. Все подкоманды, кроме fetch-radios, требуют уровень прав 2.
Настройки
Файлы настроек, списки воспроизведения, загрузки и данные входа лежат в папке Concerto/. В client_config.json регулируются громкость playerVolume, привязка к общей громкости playerVolumeFollowsMaster, способ вывода playbackBackend, размер кэша maxCacheSize, качество NetEase neteaseMusicQuality, псевдоним /music через registerMusicCommand и экранные элементы с ключами displayLyrics, displayMusicDetails, displayTimeProgress и displayCoverImg.
При проблемах с выводом звука оставьте JAVASOUND или переключитесь на OPENAL; изменение сработает со следующего трека. Если проигрыватель завис или пропал звук, выполните /concerto restart; для очистки музыки и изображений используйте /concerto clean-cache.
Серверные параметры находятся в server_config.json: serverMusicAgent включает общую очередь, musicRoomCommandPermission задаёт уровень прав для создания комнаты, musicAgentAddTimeLimit ограничивает частоту добавления песен, а auditionRequired включает проверку рассылок через @a.
Требования и совместимость
На клиенте мод работает с Fabric или NeoForge; для Fabric требуется Fabric API. На сервере совместные комнаты, обмен треками и общая очередь требуют установки Concerto на Fabric, NeoForge либо Paper в виде плагина. Без серверной части мод остаётся локальным проигрывателем в одиночной игре и на серверах.
Для серверного доступа к музыкальным сервисам файлы .cookie из клиентской папки Concerto/ помещают в одноимённую папку сервера и применяют командой /concerto-server reload-cookie. Экспортированные списки воспроизведения размещают в Concerto/preset_radios/; файл music_agent.json используется как музыка для пустой общей очереди.
