BS CustomJukebox (БС кастомджукбокс)

Плагин для серверов Майнкрафт, который превращает проигрыватели в музыкальную систему со своими пластинками, плейлистами и фоновой музыкой по зонам. Музыка воспроизводится из ресурс-пака в формате .ogg, не заменяя ванильные пластинки.

Возможности

• Пользовательские пластинки с названием, автором, описанием и CustomModelData; воспроизведение останавливается по длине композиции.
• Плейлисты, категории, перемешивание и режимы повтора loop и repeat-one.
• Фоновые музыкальные зоны: радиус, кубоид, регион WorldGuard или глобальное радио на весь сервер. Для пересекающихся зон задаётся приоритет, громкость и плейлист.
• Режим synced синхронизирует музыку для всех игроков, а individual запускает полную композицию для каждого вошедшего игрока.
• Высоту зоны можно ограничить по оси Y.
• Игроки могут отключить музыку плагина, выбрать личную громкость, пропустить композицию и собирать избранные пластинки в отдельный плейлист. По желанию отображается босс-бар с названием и прогрессом трека.
• Пустой проигрыватель открывает меню выбора пластинки; в панели администратора можно создавать и изменять пластинки, плейлисты, категории и зоны.
• Из осколков пластинок создаются целые пластинки. Осколки выпадают при убийстве крипера скелетом, могут выпадать при убийстве игроком и встречаться в луте данжей, бастионов, городов энда и руин троп.
• Попугаи танцуют рядом с пользовательской музыкой.
• Поддерживаются PlaceholderAPI, WorldGuard и GriefPrevention. Для игроков Майнкрафт Бедрок на сервере с Geyser/Floodgate нужен BS-CustomJukebox Bedrock Extension.

Команды

Для игроков:

• /cjb music <on|off|toggle|volume <0-4|reset>|status> — включить, отключить или настроить личную музыку.
• /cjb skip — пропустить текущую композицию.
• /cjb favorite <add|remove|toggle|list|play|clear> — управлять избранными пластинками.
• /cjb gui — открыть меню пластинок.
• /cjb list [page] и /cjb info <disc> — просмотреть список и сведения о пластинке.

Для администрации:

• /cjb zone <...> — создавать и настраивать музыкальные зоны и радио.
• /cjb playlist <...> — создавать плейлисты и запускать их.
• /cjb play <disc> [loop] [global|world|<radius>] — включить пластинку в своей точке.
• /cjb give и /cjb fragment — выдать пластинки и осколки.
• /cjb volume, /cjb mute, /cjb unmute — управлять общей громкостью.
• /cjb stop и /cjb reload — остановить воспроизведение и перезагрузить конфигурацию.

Альтернативные команды: /customjukebox, /jukebox, /jb.

Права

• customjukebox.use — пользоваться проигрывателями.
• customjukebox.gui, customjukebox.list, customjukebox.info — открывать меню и просматривать пластинки.
• customjukebox.music, customjukebox.favorite, customjukebox.skip — личные настройки, избранное и пропуск трека.
• customjukebox.admin — все административные команды.
• customjukebox.zone, customjukebox.playlist, customjukebox.play, customjukebox.stop, customjukebox.volume — отдельные административные действия.
• customjukebox.give, customjukebox.fragment, customjukebox.reload — выдача предметов и перезагрузка.
• customjukebox.bypass.protection — игнорировать проверки WorldGuard и GriefPrevention.

Настройка

Основные параметры находятся в config.json: язык, меню, осколки и их лут, число осколков для крафта, общая громкость, радиус слышимости проигрывателя, босс-бар, танцы попугаев и интеграции.

Пластинки и плейлисты задаются в disc.json, зоны — в zones.json, а личные настройки игроков хранятся в players.json. Для звуков ресурс-пака путь к .ogg, ключ события в sounds.json, поле name и значение sound в disc.json должны совпадать. CustomJukebox Pack Generator помогает создать ресурс-пак и подходящий disc.json.

Требования

• Сервер Paper или Folia и Java 21 либо новее.
• Ресурс-пак с аудиофайлами .ogg и настройкой resource-pack с resource-pack-sha1 в server.properties.
• WorldGuard, GriefPrevention, PlaceholderAPI и Geyser/Floodgate подключаются при необходимости.