So fügst du Plugins zu Lavalink hinzu

Plugins erweitern Lavalink um Quellen und Funktionen: andere Musikseiten, Lyrics, Suchtypen und mehr. Auf einem PlayNHost-Node fügst du eines auf zwei Wegen hinzu: Leg die .jar-Datei des Plugins in den Ordner plugins oder füg eine dependency-Zeile zur application.yml hinzu und lass Lavalink es herunterladen. In beiden Fällen stehen seine Einstellungen im Abschnitt plugins: der application.yml, und der Node braucht einen Neustart.

Was schon da ist

Dein Node startet mit einem Plugin: der YouTube-Quelle, als plugins/youtube-plugin-1.18.2-playnhost1.jar, mit ihren Einstellungen unter plugins:, youtube:. Die Plugin-Liste unter lavalink: ist leer:

lavalink:
  plugins: []
  pluginsDir: "./plugins"

Füg das YouTube-Plugin nicht noch einmal hinzu, weder als Datei noch als dependency-Zeile. Eine dependency-Zeile dafür mit einer anderen Version lässt Lavalink beim nächsten Start die PlayNHost-Datei löschen (die Console zeigt Deleted ./plugins/youtube-plugin-1.18.2-playnhost1.jar).

Variante 1: die Plugin-Datei hochladen

Das funktioniert auch, wenn die Download-Seite des Plugins down ist, weil beim Start nichts heruntergeladen wird.

1. Lad die .jar des Plugins von seiner eigenen Release-Seite herunter, meist auf GitHub. Wähl ein Release, das für Lavalink 4 gemacht ist.
2. Stopp den Node im Panel.
3. Öffne Files, öffne den Ordner plugins und lad die .jar hoch: So lädst du Serverdateien hoch, bearbeitest und verwaltest sie.
4. Füg die Einstellungen des Plugins zur application.yml hinzu (siehe unten), speichere und starte den Node.

Variante 2: eine Dependency-Zeile

1. Kopier die Dependency-Zeile des Plugins von seiner Seite. Sie hat drei Teile: group:name:version.
2. Stopp den Node, öffne die application.yml unter Files und ersetz plugins: [] unter lavalink: durch eine Liste:

lavalink:
  plugins:
    - dependency: "com.github.topi314.lavasrc:lavasrc-plugin:VERSION"
      repository: "https://maven.lavalink.dev/releases"
  pluginsDir: "./plugins"

3. Nimm die genaue Version von der Seite des Plugins und das repository, das sie nennt, falls eines angegeben ist.
4. Speichere und starte den Node. Lavalink lädt die Datei bei diesem Start in plugins herunter und behält sie.

Die Einstellungen des Plugins

Jedes Plugin liest seinen eigenen Block unter dem Schlüssel plugins: auf oberster Ebene, neben youtube:. Füg deines im selben Abschnitt plugins: hinzu. Eine zweite Zeile plugins: auf oberster Ebene macht die Datei kaputt.

plugins:
  youtube:
    enabled: true
    # ... leave the YouTube lines as they are
  lavasrc:
    sources:
      spotify: false

Die application.yml ist YAML: Rück mit Leerzeichen ein, nie mit Tabs, und halte jede Ebene zwei Leerzeichen tiefer als die darüber. Ein Plugin, das Schlüssel braucht (ein Konto, eine Client-ID), kann beim Start den ganzen Node stoppen, wenn es ohne sie eingeschaltet ist. Trag also seine Schlüssel ein oder lass es aus.

Prüfen, ob es geladen wurde

Starte den Node und lies die Console. Jedes Plugin, das geladen wird, gibt vor der Ready-Zeile eine Loaded-Zeile aus. Auf einem neuen Node sieht die des YouTube-Plugins so aus:

Loaded 'youtube-plugin-1.18.2-playnhost1.jar' (17 classes)
Lavalink is ready to accept connections.

Ein Plugin, das du hinzugefügt hast, bekommt eine eigene Loaded-Zeile mit seinem Dateinamen. Ein Plugin aus einer dependency-Zeile wird beim ersten Start heruntergeladen und dann genauso geladen.

Stoppt der Node stattdessen, nennt der Fehler direkt darüber meist das Plugin oder die Zeile der application.yml, die schuld ist: Lavalink-Fehler und was sie bedeuten.

Gut zu wissen

• Mach ein Backup, bevor du die application.yml bearbeitest: Backups erstellen, herunterladen und wiederherstellen.
• Ändere server.port und plugins.youtube.remoteCipher.url nicht: Das Panel setzt beide bei jedem Start.
• Nutz nur Plugins, denen du vertraust. Ein Plugin läuft in deinem Node mit vollem Zugriff darauf, auch auf das Passwort.
• Seiten ändern, was sie Bots erlauben, deshalb kann ein Quellen-Plugin ein Update brauchen. Sieh zuerst auf der Release-Seite des Plugins nach, wenn eines nicht mehr funktioniert.
• YouTube hat eine eigene Anleitung: So spielst du YouTube auf Lavalink 4 ab.