CustomDiscs Plugin - кастомные музыкальные диски в Майнкрафт

CustomDiscs - это плагин для Paper (и его форков вроде Purpur и Leaf), который позволяет добавлять на сервер собственные музыкальные диски, козлиные рога и головы игроков с воспроизведением звуков через Simple Voice Chat.

Ванильные диски в Майнкрафт - это красиво, но их немного и они статичны. С CustomDiscs ты можешь поставить любую аудиодорожку: от классики до собственных записей. Игроки будут слышать звук через голосовой чат - атмосфера становится совсем другой.

Требования:

• Java 25 или новее (начиная с версии 6.0.0)
• Simple Voice Chat (v2.6.1+) - обязателен и на сервере, и на клиенте
• PacketEvents (v2.11.2+) - вместо ProtocolLib (с версии 5.2.0)

Поддерживаемые форматы: .wav, .flac, .mp3. Файлы складываются в plugins/CustomDiscs/musicdata/. Можно настроить вложенность папок через subdirectory-depth в конфиге.

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

Основная команда - /customdisc или /cd. Вот что можно делать:

Команда	Описание
/cd create	Создать кастомный диск, рог или голову
/cd download <url> <filename>	Скачать аудиофайл по прямой ссылке
/cd range <value>	Установить радиус слышимости для предмета в руке
/cd horncooldown <ticks>	Задать кулдаун для козлиного рога
/cd revert	Вернуть предмет в ванильное состояние
/cd setmodel / /cd setmodel <name> / /cd setmodel <value>	Применить Custom Model Data (нужен ресурспак)
/cd revertmodel	Убрать Custom Model Data
/cd reload	Перезагрузить конфиг и языковые файлы

Права на прослушивание дисков не требуются - может любой игрок. Остальные действия регулируются пермишенами customdiscs.* и отдельными (полный список в оригинальной документации).

Загрузка файлов

Можно загружать файлы прямо с URL через команду /cd download. Ссылку обязательно заключать в двойные кавычки. Расширение в имени файла должно совпадать с реальным форматом - иначе будет ошибка.

Поддерживаются прямые ссылки и Filebin. Если файл с таким именем уже существует, плагин автоматически добавит суффикс (например, mysong_1.mp3).

Настройка радиуса и кулдауна

Для каждого кастомного предмета можно задать радиус звука (от 1 до 256 блоков по умолчанию). Для рогов - ещё и кулдаун в тиках (20 тиков = 1 секунда). Стандартный кулдаун - 140 тиков (7 секунд), максимум - 6000 тиков (5 минут).

Языки и переводы

Плагин автоматически определяет язык клиента игрока и показывает сообщения на его языке. Из коробки доступно больше 10 языков: английский, русский, французский, немецкий, испанский, китайский и другие. Можно добавить свой язык - просто создайте файл plugins/CustomDiscs/langs/xx.yml и переведите строки. После /cd reload изменения подтянутся без перезапуска сервера.

Custom Model Data (опционально)

Функция отключена по умолчанию. Если у тебя есть ресурспак, можно привязать к диску, рогу или голове собственную модель. Все настройки моделей задаются в models.yml. Команды /cd setmodel и /cd revertmodel позволяют управлять этим.

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

Конфигурация

Основной файл - plugins/CustomDiscs/config.yml. Вот что можно поменять:

# Максимальный размер скачиваемого файла (МБ)
max-download-size: 50

# Максимальная длина имени файла
filename-maximum-length: 100

# Громкость дисков (от 0 до 1)
music-disc-volume: 1

# Глубина вложенности папок: none, single, unrestricted
subdirectory-depth: none

# Язык по умолчанию (если для игрока нет файла)
default-lang: en

# Включить/выключить кастомные диски
music-disc-enable: true

# Показывать сообщение "Сейчас играет"
music-disc-playing-enable: true

# Радиус слышимости дисков (по умолч. 16, макс. 256)
music-disc-distance: 16
music-disc-max-distance: 256

# Аналогичные настройки для рогов и голов:
custom-horn-enable: true
custom-horn-distance: 16
custom-horn-max-distance: 256
horn-cooldown: 140
horn-max-cooldown: 6000

custom-head-enable: true
custom-head-distance: 16
custom-head-max-distance: 256

# Custom Model Data (отключено)
custom-model-data:
  enabled: false

# Проверка обновлений с Modrinth
update-checker:
  enabled: true
  channel: release

# Не менять - для автоматической миграции конфига
config-version: 3

Совместимость с версиями

CustomDiscs работает на Paper, Folia и их форках. Поддерживаются версии Майнкрафт от 1.19 до 26.2. Например:

• 1.19.4 - версия 2.3.x
• 1.20.4 - версии 2.6.x
• 1.21.4 - 4.2-4.4
• 1.21.9 - 1.21.11 - 5.1.2-5.1.3 / 6.0.2
• 26.1 - 26.2 - 6.0.0-6.0.2

Точную таблицу можно найти в оригинальной документации плагина.

Если вы ищете способ добавить на сервер Майнкрафт уникальные звуковые предметы, которые работают через голосовой чат, - CustomDiscs Plugin то, что нужно. Скачайте плагин CustomDiscs и дайте игрокам возможность слушать любимую музыку прямо в игре.