peyaj's CustomDiscs

peyajCustomDisc

Плагин кастомных музыкальных дисков для Paper-серверов. Загружай любой аудиофайл — получай играбельный диск.

Возможности

• Веб-панель — загружай диски и управляй ими прямо из браузера
• Автоконвертация — принимает MP3, WAV, FLAC, M4A, MP4, WMA, AAC, WebM → OGG
• Генерация ресурспака — паки для Java и Bedrock собираются автоматически
• Интеграция с музыкальными блоками — полноценный голограммный дисплей с информацией о текущем треке
• Режим повтора — Shift-ПКМ по любому музыкальному блоку включает зацикливание
• Музыка по регионам — назначай диски на регионы WorldGuard (автоматически зацикливается)
• Каталог в игре — просматривай и собирай диски через GUI
• Поддержка Geyser — игроки с Bedrock слышат кастомный диск вместе с голограммами

Требования

Команды

Добавление дисков

Рекомендуемый способ добавления дисков — через веб-панель (/disc web). Там можно загружать аудиофайлы, рисовать собственную текстуру диска и просматривать всё перед сохранением. Поддерживаемые форматы загрузки: MP3, WAV, FLAC, M4A, MP4, WMA, AAC, WebM. Плагин сам конвертирует их в OGG.

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

/disc add rushe https://mywebsite.com/audio/rushe.mp3 Rush_E Sheet_Music_Boss relic

Используй подчёркивания (_) вместо пробелов в названии трека и имени автора. Последний аргумент — текстура стиля диска (необязательно).

Права

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

[!IMPORTANT] Настрой конфиг СНАЧАЛА, прежде чем создавать или добавлять кастомные диски!

1. Настрой web-port на открытый/выделенный порт на твоём хостинге (это внутренний порт, к которому привязывается веб-сервер).
2. Настрой public-url так, чтобы он указывал на публичный IP/домен твоего сервера и порт. Плагин использует этот URL для сборки ссылки на скачивание ресурспака, которая отправляется игрокам. Если добавить песни до этой настройки, игрокам будут отправляться ссылки на ресурспак, ведущие на localhost, и они не сработают.

[!WARNING] НЕ используй порт своего Minecraft-сервера (по умолчанию 25565) для web-port! Веб-интерфейс и сервер загрузок работают как отдельный сервис на твоём хостинге. Нужно назначить/выделить полностью отдельный порт для web-port (например, 8080, 25566 и т.п.). Использование порта Minecraft вызовет BindException (Address already in use), и плагин не сможет включиться.

[!WARNING] Пользователи Geyser и текстуры Bedrock Если у вас включено auto-reload-geyser: true, плагин будет выполнять /geyser reload каждый раз, когда вы добавляете или удаляете пластинку. Однако у Geyser есть ограничение: он не может горячо перезагружать текстуры новых ресурспаков во время работы сервера. Если вы создаёте совершенно новую пластинку, игроки Bedrock могут видеть её как "Paper", пока вы не выполните полный /restart сервера. (Если вы просто заменяете аудио для существующей пластинки, перезапуск не требуется).

# config.yml
web-port: 8080
public-url: "http://your-server-ip:8080"
haproxy-support: false

# Region music (managed via commands)
region-music:
  spawn: "my_disc_id"

# Jukebox settings
jukebox:
  volume: 1.0
  pitch: 1.0
  sound-category: "RECORDS"
  range: 64.0
  enable-particles: true

Stats