URL Custom Discs

URL Custom Discs - это плагин для серверов Minecraft, который решает одну из самых неудобных проблем: добавление своей музыки в игру. Раньше, чтобы поставить на сервер кастомный диск, приходилось вручную редактировать ресурспак, конвертировать файлы, заливать их на хостинг и просить игроков перекачивать обновления. С этим плагином всё делается прямо в игре парой команд.

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

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

Поддерживается пространственный звук (моно), как у обычных дисков в проигрывателе, или обычное стерео - выбираешь сам. Кстати, ванильные команды /playsound и /stopsound тоже работают с кастомными треками, так что можно устроить целый концерт без единого проигрывателя.

Команды

• /customdisc help - список всех команд
• /customdisc create <URL или audio_name.mp3> <название_диска> <mono/stereo> - создать диск из YouTube или локального MP3
• /customdisc give <название_диска> - выдать себе диск
• /customdisc list - список всех дисков (можно кликнуть по названию, чтобы подставить команду)
• /customdisc delete <название_диска> - удалить диск
• /customdisc info - информация о диске в руке (полезно для отладки)
• /customdisc updatedep - обновить зависимости Deno и yt-dlp

Ванильные команды для воспроизведения:

• /playsound minecraft:customdisc.<название_диска> ambient @a ~ ~ ~ 1 1
• /stopsound @a * minecraft:customdisc.<название_диска>

Режимы работы

Плагин предлагает три режима на выбор:

API Mode (по умолчанию) - самый простой способ. Плагин использует удалённый API для обработки аудио и хостинга ресурспака. Ничего настраивать не нужно, всё работает из коробки. Правда, есть ограничения: максимум 10 дисков одновременно, каждый трек не длиннее 5 минут, размер ресурспака до 80 МБ. Если три месяца не было активности - токен и ресурспак удаляются.

Self-Hosted Mode - для продвинутых. Ты сам хостишь ресурспак на своём HTTP-сервере. Подходит, если хочешь полный контроль или уже используешь свой сервер для других ресурспаков.

Edit-Only Mode - позволяет обновлять ресурспак локально и копировать его в нужную папку. Удобно, если у тебя уже есть свой ресурспак и ты хочешь объединить его с дисками.

Установка (API Mode)

1. Скачай URLCustomDiscs.jar в папку plugins на сервере.
2. Запусти сервер, чтобы плагин создал конфиг plugins/URLCustomDiscs/config.yml.
3. В конфиге укажи pluginUsageMode: api.
4. Найди секцию REMOTE API MODE CONFIGURATION - там будут поля apiBaseURL, token, apiDownloadResourcePackURL. Пока они пустые, это нормально.
5. Зайди на сервер и выполни /customdisc create <URL> <название> <mono/stereo>. После этого плагин сгенерирует token и apiDownloadResourcePackURL.
6. Скопируй apiDownloadResourcePackURL и вставь в server.properties в поле resource-pack=.
7. Перезапусти сервер.
8. (Опционально) Чтобы принудительно загружать ресурспак у игроков, поставь require-resource-pack=true в server.properties и перезапусти сервер.
9. (Опционально) Если YouTube заблокирует API (маловероятно), можно включить localYtDlp: true в конфиге - тогда плагин будет скачивать аудио напрямую через yt-dlp на твоём сервере. Но на shared-хостингах это может не работать.
10. (Опционально) Скачай ProtocolLib для красивых уведомлений "Now Playing", когда игрок вставляет диск в проигрыватель.

Важно знать про аудио

Плагин использует yt-dlp для скачивания с YouTube и FFmpeg для конвертации в Ogg Vorbis (формат, который понимает Minecraft). Если твой хостинг не позволяет запускать эти инструменты (например, Shockbyte), можно скачать MP3 вручную через любой сайт-конвертер и положить файл в папку audio_to_send внутри директории плагина. Потом просто выполни команду с именем файла.

Зависимости

• ProtocolLib (опционально) - для уведомлений "Now Playing"
• Deno, yt-dlp, FFmpeg - устанавливаются автоматически и обновляются плагином

Дисклеймер

Вся ответственность за использование музыки лежит на тебе. Убедись, что у тебя есть права на треки, которые ты добавляешь на сервер. Плагин - просто инструмент.