Concerto

Concerto - это встроенный музыкальный плеер для Minecraft, созданный на Fabric. Если тебе надоело слушать однообразные звуки шахт и монстров, а хочется включить любимые треки прямо в игре - этот мод то, что надо. Он умеет воспроизводить локальные файлы, тянуть музыку из интернета, а также подключаться к китайским стримингам NeteaseCloud и QQ Music. И это не просто плеер - есть полноценные мультиплеерные фичи: можно создать музыкальную комнату и слушать треки вместе с друзьями, устраивать KTV (когда кто-то заказывает песню), а на сервере можно настроить общий плейлист и даже делиться VIP-треками.

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

---

Актуальная версия референса: 1.3.5

Поддерживаемые версии Minecraft: 1.16.5, 1.17.1, 1.18.2, 1.19.4, 1.20.1, 1.20.6, 1.21.1, 1.21.4. Другие не тестировались.

Предупреждение безопасности

Никому не показывай файл .cookie из папки Concerto! Он содержит данные для входа.

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

• U - открыть управление очередью
• I - главное меню мода
• N - следующий трек
• P - пауза/продолжить

Команды

1. /concerto (клиентская, можно использовать алиас /music, настраивается)

• pause - пауза/продолжить
• start - начать воспроизведение
• stop - остановить
• skip - пропустить трек
• skip [номер] - переключиться на трек с указанным номером
• cut - вырезать/удалить текущий трек из очереди
• clear - очистить очередь и остановить
• mode [normal|random|reversed|loop] - режим воспроизведения: по порядку, случайно, в обратном порядке, повторять
• reload - перезагрузить очередь и настройки клиента
• list [страница] - показать очередь (10 песен на странице)
• save - кешировать текущую песню
• like - лайкнуть трек
• dislike - убрать лайк
• download-current - скачать текущую песню в папку Concerto
• download-all - скачать всю очередь
• export-as-playlist - экспортировать очередь как JSON для серверного плейлиста
• add - устарело

2. /concerto-server (серверная, только для админов)

• audit [UUID] - одобрить песню, которой поделились со всеми
• audit reject [UUID] - отклонить
• audit reject all - отклонить все
• audit list [страница] - список песен на проверку
• reload - перезагрузить конфиг сервера
• fetch-radios - синхронизировать серверные плейлисты клиентам (доступно всем)
• agent reset - перезагрузить очередь запросов на сервере
• agent cut - принудительно переключить на следующий трек

3. /sharemusic (клиентская, работает даже без мода на сервере)

• to [игрок|@a] - поделиться текущей песней с игроком или со всеми (если сервер без мода - через /msg)
• accept [UUID] - принять песню
• reject [UUID] - отклонить
• reject all - отклонить все
• list [страница] - список входящих

4. /musicroom (клиентская, требует мод на сервере)

• create - создать и войти в музыкальную комнату (UUID копируется в буфер)
• join [UUID] - присоединиться к комнате
• quit - выйти
• members - список участников
• op [игрок] - дать/забрать права админа комнаты (только создатель)
• agent join - присоединиться к очереди запросов на сервере
• agent quit - покинуть очередь
• agent query - посмотреть будущие запросы на сервере
• agent add - добавить текущий трек в серверную очередь
• agent vote - начать голосование за пропуск трека
• agent vote [true/false] - проголосовать за/против

5. /neteasecloud - устарело

Локальная очередь

• Нажми U для интерфейса управления очередью
• Кликни по песне, затем нажми play (или двойной клик)
• Перетаскивай файлы/папки в интерфейс для добавления

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

• Экспортируй через /concerto export-as-playlist
• Положи JSON-файл в папку Concerto/preset_radios/ на сервере
• Если файл называется music_agent.json, он будет использоваться как плейлист по умолчанию, когда серверная очередь пуста
• Используй /concerto-server reload для применения
• Игроки увидят серверные плейлисты в главном меню

Конфигурация сервера

Файл Concerto/server_config.json:

• auditionRequired - требовать одобрения для общих песен (по умолчанию true)
• serverMusicAgent - включить серверные запросы песен (по умолчанию true)
• agentInviteWhenJoin - автоматически приглашать новых игроков в очередь запросов (по умолчанию true)
• musicRoomCommandPermission - минимальный уровень прав для создания комнаты (по умолчанию 2)
• musicAgentAddTimeLimit - интервал между запросами от одного игрока (по умолчанию 60 сек)
• musicAgentUseShared - использовать сервер для парсинга ссылок на песни (по умолчанию true)

Обмен музыкой (не совместное прослушивание)

• Если на сервере стоит мод, запросы идут скрыто; иначе - через /msg
• Админы могут включить модерацию общих песен
• Принять песню нужно вручную
• Обмениваться можно только безопасными источниками: NeteaseCloud и QQ Music

Музыкальные комнаты

• Любой админ комнаты может управлять воспроизведением (пауза, пропуск и т.д.)
• Не делай слишком много админов, чтобы избежать хаоса
• UUID комнаты копируется при создании
• Только безопасные источники

Серверные запросы песен

• Нажми кнопку деталей у песни и выбери "запросить на сервер"
• Используй /musicroom agent vote для голосования за пропуск
• Чтобы включить VIP-песни, скопируй .cookie на сервер и включи musicAgentUseShared (потребуется перезапуск сервера)
• Если есть music_agent.json, он будет проигрываться, когда очередь пуста

Конфигурация клиента

Файл Concerto/client_config.json:

• confirmAfterReceived - автоматически принимать все входящие песни (по умолчанию выкл)
• hideWhenChat - скрывать информацию о песне при открытом чате (по умолчанию вкл)
• printRequestResults - выводить ответы HTTP-запросов (не включай без нужды, по умолчанию выкл)
• maxCacheSize - максимальный размер кеша (по умолчанию 100MB)
• joinAgentWhenInvited - автоматически присоединяться к очереди запросов при приглашении (по умолчанию выкл)
• registerMusicCommand - зарегистрировать /music как алиас /concerto (по умолчанию вкл)
• scrollingTextSpeed - скорость прокрутки текста (по умолчанию 1.0)
• neteaseMusicQuality - качество звука для Netease ("STANDARD","HIGHER","EXHIGH","LOSSLESS","HIRES", по умолчанию "HIRES")
• displayLyrics - показывать лирику (по умолчанию вкл)
• lyricsPosition - позиция текста (формат описан ниже, по умолчанию 0.5,1-70)
• lyricsAlignment - выравнивание (LEFT, CENTER, RIGHT, по умолчанию CENTER)
• lyricsColor - цвет текста (формат ARGB, по умолчанию #ff00aaaa)
• displaySubLyrics - показывать перевод лирики (по умолчанию вкл)
• subLyricsPosition - позиция перевода (по умолчанию 0.5,1-60)
• subLyricsAlignment - выравнивание (по умолчанию CENTER)
• subLyricsColor - цвет (по умолчанию #ffffaa00)
• displayMusicDetails - показывать детали песни (по умолчанию вкл)
• musicDetailsPosition - позиция (по умолчанию 1-5,0+5)
• musicDetailsAlignment - выравнивание (по умолчанию RIGHT)
• musicDetailsColor - цвет (по умолчанию #ffffffff)
• displayTimeProgress - показывать прогресс (по умолчанию вкл)
• timeProgressPosition - позиция прогресс-бара (по умолчанию 1-5,0+15)
• timeProgressAlignment - выравнивание (по умолчанию RIGHT)
• timeProgressTextColor - цвет текста времени (по умолчанию #ffffffff)
• timeProgressColor - цвет полосы прогресса (по умолчанию #ff0155bc)
• timeProgressBgColor - цвет фона полосы (по умолчанию #ffa1c7f6)

Формат позиции

горизонтальная_доля[смещение],вертикальная_доля[смещение]. Если смещение 0, можно опустить. Пример: 0.5,1-70 - центр по горизонтали, 70 пикселей от нижнего края.

Формат цвета

(0x|#) + 8-значный hex (ARGB). Например, #ffffffff - полностью непрозрачный белый, #ff00aaaa - полностью непрозрачный циан.

Кешируемые песни

Включают Netease, QQ Music и другие онлайн-ресурсы.

Лайки

Только для Netease Cloud Music.

Безопасные источники

Только Netease Cloud и QQ Music. Локальные файлы и другие онлайн-ресурсы не считаются безопасными.

Вопросы и ответы

Пока нет.