URL Custom Discs

Плагин для серверов Майнкрафт, который создаёт пользовательские музыкальные пластинки из ссылок YouTube и файлов MP3. Треки добавляются в серверный ресурс-пак, а игроки получают его обновление во время игры; музыку можно включать в проигрывателе или обычными командами.

Возможности

• Создание пластинок с собственным названием из ссылки YouTube или MP3-файла с сервера.
• Режим mono воспроизводит музыку с пространственным звуком, как у проигрывателя, а stereo — обычным стереозвуком.
• Пользовательские треки работают с /playsound и /stopsound, включая воспроизведение в заданных координатах.
• Доступны режимы работы через удалённый API, со своим HTTP-сервером и локальное обновление ресурс-пака для объединения с уже используемым пакетом.

Команды

• Список команд: /customdisc help
• Создать пластинку: /customdisc create <URL OR audio_name.mp3> <disc_name> <mono/stereo>
• Выдать пластинку себе: /customdisc give <disc_name>
• Показать список пластинок: /customdisc list
• Удалить пластинку: /customdisc delete <disc_name>
• Вывести сведения о пластинке в руке: /customdisc info
• Обновить зависимости: /customdisc updatedep
• Включить трек: /playsound minecraft:customdisc.<disc_name> ambient @a ~ ~ ~ 1 1
• Остановить трек: /stopsound @a * minecraft:customdisc.<disc_name>

Для MP3-файла поместите его в папку audio_to_send в каталоге плагина. Имя файла должно быть без пробелов и специальных символов; в команде указывайте его вместе с расширением .mp3.

Настройка

В режиме API параметры находятся в plugins/URLCustomDiscs/config.yml: pluginUsageMode: api, apiBaseURL, token, apiDownloadResourcePackURL и localYtDlp. Ссылку из apiDownloadResourcePackURL укажите в server.properties в параметре resource-pack=; для обязательной загрузки ресурс-пака игроками используйте require-resource-pack=true.

Режим API одновременно хранит до 10 пластинок, длительность каждой ограничена 5 минутами, а общий размер ресурс-пака — 80 МБ. Для самостоятельного размещения нужен HTTP-сервер: плагину требуется доступ к нему для обновления пакета, а игрокам — для его скачивания.

Требования

Для загрузки аудио из YouTube плагин использует yt-dlp и Deno, а для преобразования MP3 в формат Ogg Vorbis — FFmpeg. При включении localYtDlp: true загрузка выполняется на самом сервере; на общем хостинге запуск yt-dlp может быть недоступен.

Необязательный ProtocolLib показывает уведомление «Now Playing» при установке пользовательской пластинки в проигрыватель.