Music HUD

MusicHUD - музыкальный мод и плагин для Minecraft, который добавляет полноценный плеер на базе NetEase Cloud Music прямо в игру. Он подходит для одиночного выживания, LAN-игры и серверов: механики Minecraft не меняются, а музыка, плейлисты, тексты песен и управление воспроизведением получают отдельный удобный интерфейс.

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

Скачать MusicHUD имеет смысл тем, кому нужен музыкальный плеер для Minecraft без лишних изменений игрового процесса. При этом стоит учитывать важный нюанс: из-за особенностей сервиса NetEase Cloud Music мод может работать нестабильно за пределами Китая.

Подробнее интерфейс и внешний вид можно посмотреть в галерее.

Что такое MusicHUD

MusicHUD добавляет в Minecraft графический интерфейс для поиска и прослушивания музыки. Управление вынесено в GUI и настраиваемый HUD, поэтому не приходится постоянно переключаться между игрой и отдельным музыкальным приложением.

Мод поддерживает два сценария работы:

• Подключенный режим - сервер или LAN-хост управляет общей очередью, воспроизведением и прогрессом трека. Такой вариант подходит для совместного прослушивания с друзьями.
• Изолированный режим - музыка запускается только на клиенте конкретного игрока и не влияет на остальных участников.

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

Возможности музыкального плеера

MusicHUD работает с основными объектами NetEase Cloud Music и позволяет управлять ими прямо во время игры:

• поиск музыки, плейлистов, альбомов и исполнителей;
• добавление и удаление треков из избранного;
• подписка и отписка от плейлистов, альбомов и исполнителей;
• голосование за пропуск текущей композиции;
• вход в аккаунт NetEase Cloud Music по QR-коду или SMS-коду;
• просмотр сохраненных плейлистов, альбомов и исполнителей;
• синхронизация истории прослушиваний с аккаунтом;
• управление музыкальным облаком NetEase Cloud Music;
• настройка источников для фонового воспроизведения в режиме простоя;
• автоматическая случайная смена треков, когда плеер не занят;
• отображение текста песни в интерфейсе и на HUD;
• показ игрока, заказавшего композицию, или его аватара.

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

HUD и качество звука

Интерфейс MusicHUD построен вокруг аккуратного GUI и настраиваемого HUD. В музыкальном оверлее могут отображаться текст песни, текущий трек и информация об игроке, который его запросил. Фон HUD сделан динамическим и меняется плавно, поэтому панель не выглядит полностью статичной.

Для текста песен используется поочередная прокрутка, вдохновленная Apple Music, включая отображение строк по мере воспроизведения. Это удобно, если вы следите за словами композиции, не открывая отдельное меню.

Воспроизведение построено на оптимизированном аудиоконвейере OpenAL. MusicHUD поддерживает варианты качества, доступные в NetEase Cloud Music, а при наличии подходящего оборудования способен выводить 32-битный звук с плавающей точкой и многоканальное объемное аудио.

Поток загружается и обрабатывается на клиенте. Поэтому серверу не нужно передавать сами аудиоданные всем игрокам, а нагрузка на его сеть и производительность остается небольшой. Клиентам при этом не требуется создавать лишний постоянный кэш: воспроизведение идет потоково.

На Minecraft 1.21.1 MusicHUD также исправляет MC-265514 - ошибку, которая ухудшала качество вывода звука и присутствовала в версиях от 23w31a до 1.21.4.

Совместимость

• При воспроизведении через MusicHUD можно отключать Reactive Music, чтобы ванильная музыка не накладывалась на выбранные треки.
• Подключенный режим совместим с ViaVersion.
• Для Sound Physics Perfected предусмотрена адаптация: его реверберация отключается для аудиоконвейера MusicHUD, чтобы не ухудшать качество музыки.
• На Minecraft 1.21.1 MusicHUD совместим с Raise Sound Limit Simplified и сохраняет исправление аудиоконвейера Blaze3D.

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

Загрузчики и зависимости

Для работы проекта требуются следующие компоненты:

• ModernUI - устанавливается только на клиенте. Для Minecraft 1.21.9-1.21.11 рекомендуется использовать ветку mVUS, а для версий 26.2 и 26.3 используется эта же ветка.
• Forge Config API Port - нужен только при установке на Fabric.
• Fabric API - нужен только при установке на Fabric.
• Architectury API - требовался для Fabric и NeoForge в MusicHUD 1.2.0 и более старых версиях.

Точную комбинацию загрузчика и зависимостей нужно сопоставлять с версией самого MusicHUD. Особенно это касается старых сборок, где Architectury API еще был обязательным.

MusicHUD как серверный плагин

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

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

Сервер не сохраняет пользовательские данные навсегда. Информация временно хранится только в рамках текущей сессии подключения.

Настройка API-сервера

MusicHUD использует API-сервер NetEase Cloud Music API Enhanced. Его можно запустить вместе с модом или развернуть отдельно. Первый вариант удобнее для клиента, второй обычно практичнее для выделенного сервера.

Запуск API вместе с модом

Этот способ позволяет MusicHUD самостоятельно управлять жизненным циклом API-сервера. Есть ограничение: после аварийного завершения Minecraft, например при критическом сбое, процесс API может не закрыться автоматически.

Автоматический запуск

В настройках MusicHUD доступна кнопка загрузки API. Через нее можно скачать подходящий backend NetEase Cloud Music API Enhanced и выбрать ускорение загрузки через прокси.

Ручной запуск

1. Загрузите бинарную сборку API Enhanced для своей операционной системы.
2. Распакуйте исполняемый файл из ZIP-архива.
3. Для модификации поместите файл в {corepath}/music-hud/ и переименуйте его в api, а в Windows - в api.exe.
4. Для серверного плагина используйте каталог {corepath}/plugins/MusicHud/ и такое же имя файла.
5. При необходимости разместите API в другом каталоге и укажите путь в конфигурации /config/music_hud-common.toml через параметр serverApiBinaryExecutablePath.

Путь может быть абсолютным или относительным. В Windows важно сохранить расширение api.exe.

Отдельный API-сервер

Отдельный запуск лучше подходит для сервера, где API должен работать независимо от клиента Minecraft. После развертывания проверьте адрес подключения MusicHUD.

Если API Enhanced работает не на стандартном порту 3000 или запущен на другой машине, измените параметр serverApiBaseUrl в конфигурации /config/music_hud-server.toml.

Также существует экспериментальная версия API-сервера на Rust. Она сохраняет большую часть API-эндпоинтов Node.js-версии и работает быстрее, но в ней все еще могут встречаться ошибки. MusicHUD поддерживает этот вариант начиная с версии 1.2.13, однако для постоянного серверного использования стоит заранее проверить авторизацию, поиск музыки и воспроизведение нужных плейлистов.

Установка для разных сценариев

Клиент

Одиночная игра или хост LAN-мира

Потребуется настроить или развернуть API-сервер. При использовании встроенного варианта MusicHUD может управлять его запуском самостоятельно.

Подключение к серверу или LAN-миру

Подключенный режим

Клиенту не нужно отдельно настраивать API-сервер. Однако сервер или хост LAN-мира должны иметь MusicHUD и настроенный API-сервер.

Изолированный режим

Для личного воспроизведения достаточно настроить API-сервер на клиенте. Серверная часть MusicHUD в этом сценарии не нужна для общей музыкальной синхронизации.

Сервер

На сервере потребуется установить или подключить MusicHUD и настроить API-сервер. Для общей очереди и синхронного прогресса используется подключенный режим.

Практические нюансы

Если музыка не ищется или авторизация не проходит, сначала проверьте доступность API Enhanced и корректность параметра serverApiBaseUrl. За пределами Китая проблемы могут быть связаны не с модом, а с доступностью самого сервиса NetEase Cloud Music.

На сервере имеет смысл использовать отдельное развертывание API. Так проще контролировать процесс, порт и адрес подключения, особенно если сервер работает постоянно. Для одиночной игры или LAN удобнее встроенный запуск, потому что не требуется вручную поддерживать отдельный процесс.

При совместном использовании Sound Physics Perfected часть эффектов для MusicHUD отключается специально. Это не ошибка конфигурации: музыка выводится через отдельный аудиоконвейер, которому реверберация может мешать.

Планируемые функции

• настраиваемая раскладка HUD в версии 1.4.0;
• поддержка дополнительных музыкальных платформ, включая QQ Music и Kugou Music, в версии 2.0.0.

Страница MusicHUD