CustomDiscs SVC

Если вы когда-нибудь хотели поставить на сервере свою музыку вместо стандартных пластинок Майнкрафта - CustomDiscs SVC решает эту задачу. Плагин превращает обычные музыкальные диски в кастомные: можно загрузить локальный файл в формате MP3, WAV или FLAC, либо стримить трек напрямую с YouTube или SoundCloud. Звук воспроизводится позиционно от координат джукбокса, то есть игроки слышат музыку естественно, по мере приближения к проигрывателю. Работает это через Simple Voice Chat, поэтому качество и направленность звука на высоте.

Скачать плагин CustomDiscs SVC стоит владельцам серверов, которые хотят добавить уникальную атмосферу: собственные саундтреки на спавне, музыкальные зоны, тематические пластинки для ивентов. Проект набрал уже почти 60 тысяч загрузок на Modrinth и активно обновляется - последняя версия 2.7.0 поддерживает Minecraft 1.21.6-1.21.11, а также экспериментальные ветки 26.1.x и 26.2.

Что умеет CustomDiscs

Плагин покрывает практически все сценарии использования кастомной музыки на сервере Майнкрафт:

• Локальное воспроизведение - загружайте файлы MP3, WAV или FLAC прямо на сервер в папку plugins/CustomDiscs/musicdata;
• Удалённое воспроизведение - стримьте треки с YouTube и SoundCloud по прямой ссылке;
• Позиционный звук - музыка исходит от джукбокса, громкость зависит от расстояния игрока;
• Настройка радиуса - для каждого проигрывателя можно задать свою дистанцию слышимости;
• Кастомные модели дисков - разные текстуры для локальных и удалённых пластинок через Custom Model Data;
• Визуализации - частицы, голограммы с названием трека или комбинированный режим;
• Ограничения - максимальный размер файла и длительность трека настраиваются в конфиге;
• Переводы - из коробки доступны английский и русский языки;
• Поддержка Folia - плагин корректно работает с региональным планировщиком;
• API для разработчиков - события, менеджер воспроизведения, обработчики аудиопакетов.

В последнем обновлении разработчики вернули удалённое воспроизведение (оно временно не работало), добавили четыре режима визуализации джукбоксов, локализованные голограммы и исправили обработку вставки дисков через воронки и редстоун-механизмы. Командная система переведена на Paper Brigadier, что улучшило автодополнение и подсказки.

Требования для установки

CustomDiscs SVC - не самостоятельный плагин, ему нужны зависимости:

• Simple Voice Chat - обязателен, именно через него идёт передача позиционного аудио;
• PacketEvents - для работы с сетевыми пакетами.

Важный момент: игрокам тоже нужен клиентский мод Simple Voice Chat, иначе они просто не услышат кастомную музыку. Без него диски будут вставляться в джукбокс, но звука не будет.

Поддерживаются серверы на Paper, Folia и Purpur. Версии Minecraft - от 1.21.6 до 1.21.11, плюс экспериментальные снапшоты 26.1.x и 26.2.

Установка и настройка

Процесс стандартный для серверных плагинов Майнкрафт:

1. Установите Simple Voice Chat и PacketEvents на сервер.
2. Скачайте CustomDiscs SVC и положите JAR-файл в папку plugins.
3. Перезапустите сервер.
4. Проверьте конфигурацию в plugins/CustomDiscs/config.yml.
5. Убедитесь, что Simple Voice Chat настроен и работает - без этого тестировать диски бессмысленно.

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

• язык интерфейса и сообщений;
• проверка обновлений и отладочное логирование;
• максимальный размер загружаемого файла;
• радиус воспроизведения по умолчанию;
• общая громкость и максимальная длительность трека;
• Custom Model Data для разных типов дисков;
• настройки частиц и голограмм;
• параметры YouTube OAuth2, PO-токена, прокси.

После изменения конфига выполните /cd reload - перезагружать сервер не нужно.

Как создать кастомную пластинку

Процесс простой: берёте обычную музыкальную пластинку в руку и выполняете команду. Если в аргументах есть пробелы, заключайте их в двойные кавычки.

Из локального файла

Сначала загрузите аудиофайл на сервер. Можно положить его вручную в plugins/CustomDiscs/musicdata, либо скачать по прямой ссылке:

/cd download "https://example.com/music/track.mp3" track.mp3

Затем держите пластинку в основной руке и конвертируйте её:

/cd create local track.mp3 "Название трека"

Из YouTube или SoundCloud

Держите пластинку и укажите ссылку:

/cd create remote "https://www.youtube.com/watch?v=..." "Название трека"

Вставьте полученный диск в джукбокс - музыка начнёт играть с позиционным звуком.

Важный нюанс с удалёнными сервисами. YouTube часто требует дополнительной настройки: OAuth2-авторизацию, PO-токен, удалённый cipher-сервер или HTTP(S)-прокси. Поведение провайдеров может меняться независимо от плагина. Если настраиваете OAuth2 - используйте запасной аккаунт и никому не показывайте токены. И да, стримьте только ту музыку, на которую у вас есть права.

Команды и права

Полная команда - /customdiscs, короткий алиас - /cd.

Команда	Описание	Право
/cd	Корневая команда	customdiscs
/cd help	Показать доступные команды	customdiscs.help
/cd reload	Перезагрузить конфиг и языковые файлы	customdiscs.reload
/cd download "<URL>" <файл>	Скачать аудио в musicdata	customdiscs.download
/cd create local <файл> "<название>"	Создать диск из локального файла	customdiscs.create.local
/cd create remote "<URL>" "<название>"	Создать диск из удалённого источника	customdiscs.create.remote
/cd distance <радиус>	Задать радиус слышимости джукбокса	customdiscs.distance

Команды create local, create remote и distance доступны только игрокам (не из консоли).

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

Право	По умолчанию	Описание
customdiscs.*	Операторы	Все права CustomDiscs
customdiscs.help	Все	Доступ к справке
customdiscs.reload	Операторы	Перезагрузка конфигурации
customdiscs.download	Операторы	Загрузка файлов на сервер
customdiscs.create	Все	Родительское право на создание дисков
customdiscs.create.local	Все	Создание из локальных файлов
customdiscs.create.remote	Все	Создание из удалённых URL
customdiscs.create.remote.youtube	Все	Создание из YouTube
customdiscs.create.remote.soundcloud	Все	Создание из SoundCloud
customdiscs.distance	Все	Изменение радиуса джукбокса

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

Если вы пишете свои плагины и хотите интегрироваться с CustomDiscs - есть публичный API. Артефакт публикуется в Maven-репозитории проекта.

Gradle (Kotlin DSL)

repositories {
    maven("https://repo.subkek.space/maven-public/")
}

dependencies {
    compileOnly("space.subkek:customdiscs-api:1.0.0-SNAPSHOT")
}

Maven

<repository>
    <id>subkek</id>
    <url>https://repo.subkek.space/maven-public/</url>
</repository>

<dependency>
    <groupId>space.subkek</groupId>
    <artifactId>customdiscs-api</artifactId>
    <version>1.0.0-SNAPSHOT</version>
    <scope>provided</scope>
</dependency>

В дескрипторе плагина укажите CustomDiscs и Simple Voice Chat как зависимости, затем получите API:

import space.subkek.customdiscs.api.CustomDiscsAPI;

CustomDiscsAPI api = CustomDiscsAPI.get();
if (api == null)
    throw new IllegalStateException("CustomDiscs не загружен");
boolean isCustom = api.isCustomDisc(itemStack);
api.getLavaPlayerManager().play(jukeboxBlock, audioIdentifier, null);

API предоставляет:

• CustomDiscsAPI - точка входа, идентификация дисков, доступ к менеджеру воспроизведения;
• LavaPlayerManager - запуск, остановка и проверка позиционного воспроизведения;
• обработчики пакетов для наблюдения за закодированными аудиофреймами;
• события CustomDiscInsertEvent и CustomDiscEjectEvent - вставка и извлечение диска;
• события LavaPlayerStartPlayingEvent и LavaPlayerStopPlayingEvent - жизненный цикл воспроизведения.

Учтите: события LavaPlayer могут выполняться асинхронно или на региональном потоке. Операции с миром Bukkit планируйте через соответствующий планировщик сервера или региона.

Сборка из исходников

Проект требует JDK 21, Gradle Wrapper включён:

./gradlew build

Готовый JAR появится в build/libs.

Хотите поиграть с друзьями с кастомной музыкой?

CustomDiscs SVC отлично работает на выделенных серверах. Если хотите быстро запустить свой сервер Майнкрафт с поддержкой плагинов и голосового чата - попробуйте BungeeHost. Там можно арендовать сервер Minecraft с установкой в один клик, и CustomDiscs вместе с Simple Voice Chat заработают без лишних танцев с конфигурацией. Хостинг серверов Майнкрафт на Bungee.Host подойдёт как для небольшой компании друзей, так и для полноценного проекта с десятками игроков.

Итог

CustomDiscs SVC - это must-have для серверов, где важна атмосфера и уникальный контент. Кастомные пластинки с любой музыкой, позиционный звук, гибкие настройки визуализации и поддержка Folia делают его одним из лучших решений в своей нише. Почти 60 тысяч загрузок говорят сами за себя. Скачать плагин CustomDiscs SVC и настроить свою музыку на сервере - дело десяти минут, если Simple Voice Chat уже работает.