Как добавить плагины в Lavalink

Голый узел Lavalink может воспроизводить только то, что поддерживают его встроенные источники. Плагины добавляют больше: другие музыкальные сайты, фильтры и дополнительные функции. Управлять ими нужно в application.yml.

Где находятся настройки

Откройте Files в панели и отредактируйте application.yml при остановленном сервере. У плагинов две части:

1. Запись dependency, которая сообщает Lavalink, какой файл плагина скачать.
2. Необязательный блок настроек этого плагина.

lavalink:
  plugins:
    - dependency: "group:artifact:VERSION"
      snapshot: false

plugins:
  example:
    enabled: true

Точные group, имя и версия указаны на странице самого плагина (обычно в его релизах на GitHub). Всегда копируйте актуальную версию оттуда, потому что версии плагинов меняются.

Добавьте плагин

1. Найдите страницу плагина и скопируйте его строку dependency и настройки.
2. Остановите сервер, отредактируйте application.yml и сохраните.
3. Запустите сервер. Lavalink скачивает плагин при запуске, поэтому первый запуск занимает больше времени.
4. Найдите в Console строку, в которой плагин назван загруженным. Ошибка сразу после неё обычно означает опечатку в отступах в application.yml, который чувствителен к пробелам.

Полезно знать

• Сохраните копию application.yml перед редактированием. Используйте Бэкапы: Как создавать, скачивать и восстанавливать бэкапы.
• Не меняйте server.port: панель задаёт его при каждом запуске.
• Музыкальные сайты часто меняются и могут блокировать ботов. Плагину, который работал, позже может понадобиться обновление, поэтому, когда что-то перестаёт работать, проверьте страницу плагина.
• Используйте только плагины, которым доверяете. Они работают внутри вашего узла.