Плагин позволяет воспроизводить музыку из пользовательских ресурс-паков на сервере Minecraft без замены базовых звуков игры.
Описание плагина Music
Music создан для удобного проигрывания кастомных музыкальных циклов (loop) на серверах. Он не заменяет стандартные звуки Minecraft, а добавляет возможность создавать повторяющиеся музыкальные треки в определённых областях мира. По умолчанию поддерживается одновременное воспроизведение до 220 циклов, но это значение можно увеличить при необходимости.
Возможности
- Проигрывание песен через ресурс-паки;
- Поддержка нескольких ресурс-паков и музыкальных файлов на одном сервере;
- Настраиваемые ссылки для скачивания ресурс-паков;
- Конфигурируемое время повторения каждой песни;
- Каждый игрок управляет своей музыкой самостоятельно — только операторы могут изменять или останавливать чужие треки;
- Совместимость со всеми версиями Bukkit.
Команды
| Команда | Описание |
|---|---|
| /Music | Основное управление плагином |
| /Music setUpStation [НазваниеПесни] [ID] | Запускает песню на станции с указанным ID |
| /Music addToQueue [НазваниеПесни] [ID] | Добавляет песню в очередь станции |
| /Music removeFromQueue [Индекс] [ID] | Удаляет песню с указанным индексом из очереди станции |
| /Music clearQueue [ID] | Очищает очередь станции |
| /Music Help | Показывает список всех команд |
| /Music ListStations [Страница] | Отображает список активных станций, песен и владельцев |
| /Music PlayOnce [НазваниеПесни] | Воспроизводит песню один раз, аналогично стандартной команде /playSound |
Права доступа
- music.* — полный доступ ко всем функциям;
- music.admin — равнозначно полному доступу;
- music.changevolumetoglobal — возможность установить глобальную громкость для музыкальных станций;
- music.default — базовые права для работы с музыкальными станциями:
- music.usejukebox — взаимодействие с музыкальными станциями;
- music.placejukebox — установка музыкальных станций;
- music.changesong — смена трека на станции;
- music.changevolume — изменение громкости станции.
Установка
- Скопируйте файлы Music.jar и Music в папку plugins вашего сервера;
- Перезапустите сервер.
Совместимость и особенности
Плагин не требует дополнительных зависимостей. Возможны конфликты, если у клиента есть ресурс-пак с звуками, совпадающими по названию с серверными, но отличающимися содержанием. Названия песен чувствительны к регистру — например, «Piano» и «piano» будут восприниматься как разные аудио-файлы.
Работа с новыми звуками
Инструкции по добавлению новых песен и созданию ресурс-паков находятся в файле README.txt, который появляется в папке Server/plugins/Music после первого запуска сервера с установленным плагином.
API для разработчиков
- Music.playSound(String songname, int StreamID, Location location, String owner) — запускает циклическое воспроизведение песни с заданным именем, идентификатором станции, локацией и владельцем;
- Music.playSoundOnce(String songname, Location location) — воспроизводит песню один раз в указанной точке;
- Music.removeSound(int StreamID) — останавливает воспроизведение песни на станции с указанным ID.
Автоматическое обновление
Плагин поддерживает автоматическую проверку и загрузку обновлений. Для отключения обновлений отредактируйте файл plugins\AUpdater\global.yml, установив параметр update в false.
