Кастомная музыка¶

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

📌 1. Требования для игроков¶

Чтобы создавать и слушать кастомную музыку на сервере, убедитесь, что у вас выполнено главное условие:

Установлен мод Simple Voice Chat: У вас в клиенте (Fabric / Forge / NeoForge) должен быть установлен мод Simple Voice Chat, и вы должны быть подключены к голосовому чату на сервере.
Поддерживаемые форматы аудио: .mp3, .wav, .flac.

Примечание

Для прослушивания готовых пластинок дополнительные права на сервере не требуются.

📥 2. Как загрузить свою музыку на сервер¶

Загрузка файла выполняется прямо из игры с помощью команды /cd download.

Синтаксис команды:¶

/cd download "<прямая_ссылка_на_файл>" <имя_файла.расширение>

Важно

Ссылка обязательно должна быть заключена в двойные кавычки "...".
Расширение файла в <имя_файла.расширение> должно строго совпадать с реальным форматом исходного файла (например, если файл .mp3, имя должно оканчиваться на .mp3).

Где взять прямую ссылку?¶

Прямая ссылка с любого хостинга:
- Ссылка должна вести напрямую на скачивание файла.
- Пример:
```
/cd download "https://example.com/my_song.mp3" my_song.mp3
```
Использование Filebin (Бесплатно и без регистрации):
- Перейдите на filebin.net, загрузите ваш аудиофайл.
- Скопируйте ссылку на корзину (Bin URL) или прямую ссылку на файл.
- Примеры:
```
/cd download "https://filebin.net/mybinname" my_song.mp3
/cd download "https://filebin.net/mybinname/my_song.mp3" my_song.mp3
```
Google Drive:
- Обычная ссылка доступа Google Диска не сработает напрямую. Настройте доступ «Все, у кого есть ссылка» и преобразуйте её в прямую ссылку с помощью сервисов-конвертеров (например, GD direct link generator).

🎛️ 3. Команды плагина для игроков¶

Алиас команды: вместо /customdisc можно использовать короткий вариант /cd.

Команда	Описание	Пример
`/cd download "<url>" <filename>`	Загрузить аудиофайл на сервер	`/cd download "https://site.com/song.mp3" song.mp3`
`/cd range <значение>`	Изменить радиус слышимости звука (в блоках)	`/cd range 50`
`/cd revert`	Полностью очистить предмет от кастомного звука и возвратить в ванильный вид	`/cd revert`

🔊 4. Настройка радиуса звучания (`/cd range`)¶

Вы можете изменить расстояние, на котором будет слышна ваша музыка:

Возьмите в главную руку кастомную пластинку, козий рог или голову игрока.
Введите команду:
```
/cd range <радиус_в_блоках>
```
Пример: /cd range 100 — музыку будет слышно в радиусе 100 блоков.
Максимальный радиус ограничен настройками сервера (по умолчанию до 256 блоков).

🧹 6. Полный сброс предмета (`/cd revert`)¶

Если вы хотите вернуть кастомную пластинку, рог или голову к обычному ванильному состоянию:

Возьмите предмет в главную руку.
Введите команду /cd revert.
Все кастомные данные (звук, описание/lore, радиус, перезарядка, текстура) будут удалены.

❓ 7. Решение частых проблем¶

Я поставил пластинку в проигрыватель, но звука нет:
1. Проверьте, работает ли у вас мод Simple Voice Chat (нажмите клавишу V в игре).
2. Убедитесь, что вы не заглушили звук проигрывателей в настройках Voice Chat или игры.
3. Проверьте, загрузился ли файл без ошибок.
Ошибка при вызове /cd download:
1. Забыли кавычки вокруг ссылки ("https://...").
2. Указали неправильное расширение файла. Если исходник .wav, а вы написали .mp3, сервер выдаст ошибку UnsupportedAudioFileException.
Если имя файла уже существует:
- Плагин автоматически добавит суффикс к имени (например, song_1.mp3) и уведомит вас в чате.

Приятного прослушивания музыки в Minecraft! 🎧