pv-addon-discs - свои треки на пластинках

pv-addon-discs - это серверный плагин-аддон для голосового чата Plasmo Voice, который превращает обычные музыкальные пластинки в Майнкрафте в полноценный кастомный медиаплеер. Идея простая: берёшь в руку диск, пишешь команду с ссылкой на трек, и теперь этот диск играет любую музыку с YouTube, SoundCloud, Twitch или даже прямого стрима. И главное - сам файл никуда не скачивается и не хранится на сервере, звук стримится напрямую через библиотеку LavaPlayer. По духу проект похож на Simple Voice Chat AudioPlayer и CustomDiscs, но заточен именно под экосистему Plasmo Voice.

Если вы когда-нибудь хотели устроить на сервере вечеринку с диджеем, запустить фоновое радио в спавне или просто пранкануть друга пластинкой с мемом вместо Pigstep - это именно тот плагин. Скачать pv-addon-discs стоит в первую очередь тем, кто держит социальный или ванильный сервер с друзьями: вайб общения через голосовой чат плюс общая музыка на фоне работает безотказно.

Как это работает в игре

Механика построена на ванильных пластинках и проигрывателях. Берёте в руку обычный музыкальный диск, выполняете команду /disc burn <url> [name] - и диск "записывается". После этого его можно вставить в проигрыватель (jukebox), и трек начнёт звучать всем, кто находится рядом. Звук идёт через Plasmo Voice, поэтому громкость зависит от расстояния, как и обычный голосовой чат - позиционный звук в чистом виде.

Если трек надоел или хочется вернуть диск к обычному виду, есть команда /disc erase. Не помните точную ссылку на ролик? /disc search <запрос> выполнит поиск прямо по YouTube, без выхода из игры. А /disc cancel останавливает воспроизведение (в том числе звука goat horn, рога козы, который плагин тоже затрагивает). По умолчанию команды доступны только операторам, так что случайный игрок не забьёт ваш сервер десятичасовыми лоуфай-миксами.

Что поддерживает плагин

Источников реально много, и это главная сила аддона:

• YouTube - обычные видео и даже live-трансляции (с нюансами, о них ниже)
• SoundCloud
• Bandcamp
• Vimeo
• Twitch - именно живые стримы
• Прямые HTTP-ссылки на аудиофайлы

Из прямых ссылок понимает форматы MP3, FLAC, WAV, Matroska/WebM, MP4/M4A, OGG-стримы, AAC и стрим-плейлисты в формате M3U и PLS. По факту это превращает плагин в универсальную приставку: можно завести на спавне радио, ретранслирующее интернет-станцию, или устроить трансляцию Twitch-ивента для всего сервера.

Отдельно стоит отметить связку с соседними проектами: Simple Voice Radio умеет ретранслировать диски pv-addon-discs по радиочастоте, то есть музыку с пластинки можно вещать всем, у кого в инвентаре рация. А CDisc Music умеет конвертировать созданные здесь пластинки в свой формат. Если собираете полноценную музыкальную инфраструктуру на сервере - эта связка вам в руки.

Установка и требования

Плагин работает только на Paper (а также на его форках Purpur и Folia). Это не мод для Fabric или Forge, клиентский сетап на Fabric/Quilt у игроков на это никак не влияет. Порядок действий такой:

1. Поставьте на сервер Plasmo Voice, PacketEvents и pv-addon-lavaplayer-lib. Игрокам нужен Plasmo Voice на клиенте - без него они просто не услышат музыку.
2. Скачайте pv-addon-discs и закиньте jar в папку ~/plugins.
3. Перезапустите сервер.

Плагин активно обновляется: последний релиз 1.2.1 поддерживает свежие версии игры вплоть до Minecraft 26.3, а также ветки 1.21.x и старше. В 1.2.1, кстати, починили раздражающую ошибку zip file closed при остановке сервера и глюк с тултипом у goat horn на 1.21.5+, а ещё добавили вывод отладочных логов LavaPlayer - для диагностики очень удобно.

Совет: если собираете сервер с голосовым чатом и музыкой с нуля, проще всего арендовать сервер Майнкрафт на Bungee.Host - Plasmo Voice и все нужные аддоны устанавливаются там в один клик, не придётся вручную разбираться с зависимостями PacketEvents и lavaplayer-lib. Хостинг серверов Майнкрафт на Bungee.Host особенно выручает, когда нужен стабильный канал: стриминг аудио с YouTube чувствителен к сети, и на дешёвом хостинге с кривым маршрутом будут вылезать таймауты чтения. Запустить сервер Майнкрафт там можно за пару минут и сразу звать друзей.

Права доступа

По умолчанию команды только для OP, проигрывать готовые диски могут все. Раздача через LuckPerms или аналог:

Право	Что даёт	Доступ по умолчанию
pv.addon.discs.burn	Запись дисков командой /disc burn	Только OP
pv.addon.discs.erase	Очистка диска /disc erase	Только OP
pv.addon.discs.search	Поиск по YouTube /disc search	Только OP
pv.addon.discs.cancel	Остановка своего воспроизведения рога	Только OP
pv.addon.discs.cancel.other	Остановка воспроизведения у другого игрока	Только OP
pv.addon.discs.burn.burnable_check_bypass	Обход ограничения на запись только специальных дисков (если включено в конфиге)	Только OP
pv.addon.discs.play	Использование кастомных пластинок	Все игроки

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

Типичные проблемы и их решение

YouTube периодически ломает свои плеерные скрипты, и из-за этого стриминг может отваливаться. Вот что реально помогает.

Проблемный YouTube player script

1. Убедитесь, что у вас свежие версии pv-addon-discs и pv-addon-lavaplayer-lib.
2. Откройте plugins/pv-addon-discs/discs.toml, раскомментируйте и настройте блок youtube_source.remote_cipher:

[youtube_source.remote_cipher]
url = "https://cipher.kikkia.dev/"
password = ""

Это публичный инстанс yt-cipher. Можно поднять свой, если хочется независимости. 3) Перезапустите сервер и проверьте. 4) Если не заработало - переходите к oauth2.

"Sign in to confirm you're not a bot" / "Please sign in" при использовании YouTube

1. Снова проверьте, что версии плагинов актуальные.
2. В plugins/pv-addon-discs/discs.toml выставьте youtube_source.use_oauth2 = true.
3. Полностью перезапустите сервер - команда /vreload тут не поможет.
4. При инициализации плагин выведет в консоль сообщение с кодом авторизации. Следуйте инструкциям прямо в консоли.
5. После успешной авторизации увидите подтверждение в консоли. Токен вручную сохранять не нужно - плагин сделает это сам при остановке сервера.
6. Готово, треки с YouTube должны заиграть.

Read timed out

Обычно это значит, что ваш сервер не может достучаться до сервера, который хостит трек. Проверьте интернет-соединение сервера и напишите хостинг-провайдеру, если проблема повторяется. Если у вас есть HTTP-прокси, его можно указать опцией http_proxy в discs.toml - фича доступна начиная с версии 1.1.x.

API для разработчиков

Если вы пишете свои плагины и хотите интегрироваться с дисками - у аддона есть API с Bukkit-событиями. Подключается через Maven-репозиторий Plasmoverse, в Kotlin DSL это выглядит так:

repositories {
    maven("https://repo.plasmoverse.com/releases")
}

dependencies {
    compileOnly("su.plo.voice.addon:discs-paper:$VERSION")
}

Полный список событий есть в репозитории проекта в папке api. Для серверных разработчиков это открывает простор: можно, например, реагировать на запись диска, логировать действия игроков или строить автоматические радио-станции.

Стоит ли ставить

Проект набрал около 50 тысяч загрузок и уверенно держится в категории Social - не самый хайповый плагин в мире, но в своей нише лучший. Если у вас сервер на Paper/Purpur/Folia с Plasmo Voice и живым комьюнити, pv-addon-discs - это must-have для социальных активностей. Вечеринки, кинопросмотры с озвучкой, радио на спавне, музыкальные розыгрыши - всё это делается одним плагином без танцев с бубном. Скачайте pv-addon-discs, поставьте зависимости - и ваша пластинка Pigstep наконец-то сможет звучать чем-то действительно свежим.