GMusic - плагин для музыки и джукбоксов

GMusic добавляет на сервер Minecraft музыкальный плеер, который воспроизводит песни звуками нотных блоков. Игроки могут управлять музыкой через GUI: выбирать композиции, менять громкость и режим воспроизведения, ставить треки на паузу и добавлять их в избранное. Это удобно, когда хочется включить музыку на сервере без отдельных музыкальных модов у игроков.

Плагин поддерживает Bukkit, Spigot и Paper; также заявлена совместимость с Purpur и Folia. Поддерживаемые версии Minecraft Java Edition - от 1.13 до 1.21.x и 26.1-26.3. Дополнительный API или другой плагин для запуска GMusic не требуется. Для плейсхолдеров можно подключить PlaceholderAPI.

Возможности GMusic

• GUI-плеер с поиском песен по названию и постраничной навигацией.
• Управление громкостью, частицами и режимом воспроизведения: один раз, перемешивание или повтор.
• Пауза, продолжение, остановка и переключение на следующий трек.
• Обратное воспроизведение композиций.
• Персональное радио сервера со случайным выбором песен.
• Избранные треки и автоматический выбор музыки при входе игрока.
• Частицы, синхронизированные с музыкой, и звуковые эффекты окружения.
• Настройки по умолчанию и выбор, сохранять ли параметры игрока после выхода.
• Команды с автодополнением и редактирование песен в игре.
• Настраиваемые файлы конфигурации и языковые файлы.

Эффекты окружения меняют звучание в зависимости от игровой ситуации. Например, под водой громкость музыки приглушается, а звук становится слегка искаженным. В меню настроек щелчок средней кнопкой мыши возвращает выбранному параметру значение по умолчанию.

Джукбоксы и музыкальные диски

GMusic позволяет выдавать игрокам особые джукбоксы, привязанные к позиции блока. Музыку слышно рядом с таким джукбоксом, а при удалении от него звук становится тише. Дальность слышимости настраивается в конфигурации, а игрок может отключить прослушивание через /music toggle.

Плагин также создает диски с выбранными композициями. Они работают как обычные диски Minecraft и помещаются в стандартный ванильный джукбокс. Так музыку можно встроить в игровое пространство, а не только запускать персонально через меню.

Импорт песен и форматы

Основной формат GMusic - .gnbs. Поместите такие файлы в папку gnbs и перезагрузите плагин, чтобы добавить композиции в список.

Файлы .nbs и .mid или .midi можно положить в папку convert: GMusic обработает их при следующей перезагрузке. MIDI также можно заранее преобразовать в NBS с помощью Note Block Studio. Формат .mp3 напрямую не поддерживается.

У GNBS есть дополнительные возможности для управления нотами и частями композиции: отдельные ноты можно останавливать, а повторно используемые части и музыкальные строки - воспроизводить снова. Файлы не зашифрованы, их можно открыть текстовым редактором.

Команды

Команды игрока:

• /music - открыть музыкальное меню.
• /music play <Song> - включить песню по идентификатору.
• /music playing - показать текущую композицию.
• /music random - включить случайную песню.
• /music stop - остановить музыку.
• /music pause - поставить песню на паузу.
• /music resume - продолжить последнюю песню на паузе.
• /music skip - перейти к следующей песне.
• /music toggle - включить или отключить звук пространственных джукбоксов.

Административные команды:

• /amusic download <Type> <Song> <Path> - загрузить файл по URL.
• /amusic jukebox <Player> [<Amount>] - выдать игроку джукбоксы.
• /amusic disc <Song> <Player> [<Amount>] - выдать игроку диски с выбранной песней.
• /amusic radio - открыть серверное радио.
• /amusic play <Player> <Song> - включить песню игроку.
• /amusic playing <Player> - показать, что сейчас слушает игрок.
• /amusic random <Player> - включить игроку случайную песню.
• /amusic stop <Player> - остановить музыку у игрока.
• /amusic pause <Player> - поставить песню игрока на паузу.
• /amusic resume <Player> - продолжить песню игрока.
• /amusic skip <Player> - переключить песню игрока.
• /amusic toggle <Player> - переключить возможность слышать джукбоксы.
• /gmusicreload - перезагрузить конфигурацию и языковые файлы.

Права доступа

• GMusic.* - все права плагина.
• GMusic.Update - уведомления об обновлениях.
• GMusic.GMusicReload - перезагрузка конфигурации.
• GMusic.Music.* - все права на музыкальные команды.
• GMusic.Music - доступ к /music.
• GMusic.Music.Play, GMusic.Music.Playing, GMusic.Music.Random, GMusic.Music.Stop, GMusic.Music.Pause, GMusic.Music.Resume, GMusic.Music.Skip, GMusic.Music.Toggle - доступ к соответствующим командам игрока.
• GMusic.AdminMusic.* - все права административного управления музыкой.
• GMusic.AdminMusic - доступ к административным музыкальным командам.
• GMusic.AdminMusic.Play, GMusic.AdminMusic.Playing, GMusic.AdminMusic.Random, GMusic.AdminMusic.Stop, GMusic.AdminMusic.Pause, GMusic.AdminMusic.Resume, GMusic.AdminMusic.Skip, GMusic.AdminMusic.Toggle - доступ к соответствующим командам для управления музыкой игроков.
• GMusic.JukeBox - использование специальных джукбоксов.
• GMusic.Disc - использование музыкальных дисков.

Плейсхолдеры PlaceholderAPI

• %gmusic_option_volume% - текущая громкость.
• %gmusic_option_join% - включена ли музыка при входе.
• %gmusic_option_playmode% - выбранный режим воспроизведения.
• %gmusic_option_particles% - включены ли частицы.
• %gmusic_option_reverse% - включено ли обратное воспроизведение.
• %gmusic_option_toggle% - может ли игрок слышать музыку джукбоксов.
• %gmusic_playing% - воспроизводится ли музыка у игрока.
• %gmusic_playing_title% - название текущей песни.
• %gmusic_playing_id% - идентификатор текущей песни.
• %gmusic_playing_author% - автор текущей песни.
• %gmusic_playing_original_author% - оригинальный автор песни.
• %gmusic_playing_description% - описание текущей песни.
• %gmusic_playing_paused% - поставлена ли песня на паузу.

Язык и настройки

Чтобы выбрать язык, укажите нужный файл в параметре Lang.lang в config.yml. Для собственного перевода скопируйте один из языковых файлов, измените сообщения и впишите имя нового файла в Lang.lang.

GMusic подойдет администраторам, которые хотят добавить на сервер музыку, не требуя от игроков устанавливать клиентские моды. Перед настройкой проверьте права доступа и параметры сохранения: они определяют, останутся ли индивидуальные настройки игрока после выхода.