CustomDiscs Plugin (Кастомдискс плагин)

Плагин для серверов Майнкрафт, который добавляет пользовательскую музыку для пластинок, козьих рогов и голов игроков. Звуки воспроизводятся через голосовой чат Simple Voice Chat, поэтому их слышат игроки в заданном радиусе.

Возможности

• Можно назначать аудиофайлы музыкальным пластинкам, козьим рогам и головам игроков.
• Поддерживаются файлы .wav, .flac и .mp3.
• Для каждого предмета настраивается дальность слышимости; для козьего рога также задаётся задержка повторного использования.
• Предмет можно вернуть к обычному ванильному состоянию, удалив звук, описание, дальность и задержку.
• Для пластинок, рогов и голов можно назначать внешний вид через Custom Model Data. Модели и текстуры для него задаются ресурс-паком.
• Сообщения плагина автоматически показываются на языке клиента игрока; русский язык включён.

Команды

• /customdisc или /cd — показать доступные команды.
• /cd download <url> <filename.extension> — скачать аудиофайл на сервер. Адрес файла указывайте в двойных кавычках, а расширение имени должно совпадать с форматом файла.
• /cd range <value> — задать дальность слышимости предмета в руке.
• /cd goatcooldown <value> — установить задержку козьего рога в тиках; 20 тиков равны одной секунде.
• /cd revert — вернуть пластинку, рог или голову в ванильное состояние.
• /cd setmodel — открыть меню выбора модели для предмета в руке.
• /cd setmodel <name> или /cd setmodel <value> — назначить модель по имени из models.yml либо по числовому значению Custom Model Data.
• /cd revertmodel — удалить внешний вид Custom Model Data.
• /cd reload — перечитать config.yml, языковые файлы и models.yml без перезапуска сервера.

Права

• customdiscs.* — все права плагина.
• customdiscs.create — создание пользовательских пластинок, рогов и голов.
• customdiscs.download — загрузка аудиофайла по ссылке.
• customdiscs.range — изменение дальности звука.
• customdiscs.horncooldown — изменение задержки рога.
• customdiscs.revert — возврат предмета к ванильному виду.
• customdiscs.setmodel и customdiscs.revertmodel — назначение и удаление Custom Model Data.
• customdiscs.reload — перезагрузка настроек и переводов.

Для прослушивания пластинок право не требуется.

Настройка

Аудиофайлы помещаются в plugins/CustomDiscs/musicdata/. Параметр subdirectory-depth в config.yml определяет, разрешены ли вложенные папки: none — только корневая папка, single — один уровень вложенности, unrestricted — любая глубина.

В config.yml настраиваются лимит размера загружаемых файлов, громкость пластинок, включение отдельных типов предметов, сообщения о воспроизведении, стандартная и максимальная дальность звука, задержка рогов и язык по умолчанию через default-lang. Для русского языка укажите default-lang: ru, если у игрока нет подходящего языка клиента.

Файл models.yml находится в plugins/CustomDiscs/. В нём для каждого материала указываются числовое значение value и название name, отображаемое в меню выбора модели. Custom Model Data включается параметром custom-model-data.enabled в config.yml.

Требования

Плагин работает на серверах Paper, Folia и их сборках, включая Purpur и Leaf. Серверу требуется Java 25 или новее, а также плагины Simple Voice Chat и PacketEvents.

Simple Voice Chat должен быть установлен и на сервере, и у каждого игрока, который будет слышать пользовательские звуки. Для Custom Model Data нужен активный ресурс-пак с моделями или текстурами, соответствующими заданным числовым значениям.