Music HUD

Music HUD - мод/плагин для Minecraft, который позволяет игрокам на сервере заказывать музыку через Netease Cloud Music и слушать её вместе. Он ничего не меняет в геймплее, но добавляет атмосферу: теперь можно устроить дискотеку, просто закинуть в чат ссылку на песню.

Что это и зачем нужно

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

Основные фишки

• Графический интерфейс (GUI): удобное меню для поиска песен, альбомов, плейлистов и исполнителей. Никаких консольных команд - всё мышкой.
• HUD на экране: показывает текущий трек, название, исполнителя, кто заказал, и автоматически крутит текст песни (как в Apple Music - строчки сменяют друг друга).
• Синхронизация по серверу: очередь воспроизведения общая - все игроки слышат одно и то же, и могут добавлять свои треки.
• Автоподбор фона: при проигрывании HUD динамически меняет фон, создавая красивые переливы.
• Поддержка Netease Cloud Music: можно войти в свой аккаунт (через QR-код или SMS), загрузить свои плейлисты и добавить их в очередь.
• Режим холостого хода: если никто не заказывает, можно настроить случайное воспроизведение музыки из заданного источника.
• Совместимость с Reactive Music: при использовании Music HUD звуки Reactive Music приглушаются, чтобы не было наложения.

Как это работает

Мод состоит из двух частей: клиентской (сам мод с GUI и HUD) и серверной (управляет очередью и передачей звука). Для полноценной работы нужно развернуть API-сервер Netease Cloud Music Enhanced - именно он получает данные о треках и транслирует аудиопоток.

Варианты развертывания API

• Встроенный вариант (рекомендуется для клиента): скачайте бинарный файл API под вашу платформу (Windows/Linux) и положите в папку music-hud внутри .minecraft. Music HUD сам запустит и остановит его при входе в игру. Удобно для одиночной игры или когда хост сам запускает сервер.
• Отдельный сервер (рекомендуется для крупных серверов): разверните NCM API Enhanced на отдельной машине или в Docker, укажите его адрес в конфиге. Так нагрузка на игровой сервер будет минимальной.

Требования

• Forge / Fabric / NeoForge: мод совместим с разными загрузчиками. Для Fabric потребуется Forge Config API Port, для всех версий - ModernUI (клиентский мод для красивого интерфейса).
• Версии Minecraft: актуально для 1.19-1.21 (уточняйте под версию).
• Поддержка ОС: Windows, Linux (Mac - экспериментально).

Нюансы

Сервис Netease Cloud Music ориентирован на китайский рынок, поэтому за пределами Китая возможны проблемы с доступом. Многие треки могут быть недоступны из-за региональных ограничений. Если живёте не в Китае - проверяйте работу заранее.

Настройки хранятся в файлах config/music_hud-common.toml (клиентские) и config/music_hud-server.toml (серверные). Там можно поменять порт API, путь к бинарнику и другие параметры.

Подводя итог

Music HUD - отличный проект, если вы хотите добавить на сервер атмосферу общего прослушивания музыки без заморочек с модами на звук. Да, он завязан на конкретный сервис и требует небольшого развертывания, но результат того стоит - игроки могут сами решать, что играет, а вы получаете красивое оформление. Для серверов с русскоязычным комьюнити, где многие используют Netease Cloud Music (или для тех, кто готов заморочиться с прокси), это must-have.