Cómo añadir plugins a Lavalink

Los plugins añaden fuentes y funciones a Lavalink: otros sitios de música, letras, tipos de búsqueda y más. En un nodo de PlayNHost puedes añadir uno de dos maneras: poner el archivo .jar del plugin en la carpeta plugins, o añadir una línea dependency a application.yml y dejar que Lavalink lo descargue. En ambos casos, sus ajustes van en la sección plugins: de application.yml, y el nodo necesita reiniciarse.

Qué hay ya

Tu nodo arranca con un plugin: la fuente de YouTube, como plugins/youtube-plugin-1.18.2-playnhost1.jar, con sus ajustes en plugins:, youtube:. La lista de plugins bajo lavalink: está vacía:

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

No añadas otra vez el plugin de YouTube, ni como archivo ni como línea dependency. Una línea dependency para él con otra versión hace que Lavalink borre el archivo de PlayNHost en el siguiente inicio (la consola dice Deleted ./plugins/youtube-plugin-1.18.2-playnhost1.jar).

Forma 1: subir el archivo del plugin

Funciona incluso cuando el sitio de descarga del plugin está caído, porque al iniciar no se descarga nada.

1. Descarga el .jar del plugin desde su propia página de releases, normalmente en GitHub. Elige una versión hecha para Lavalink 4.
2. En el panel, detén el nodo.
3. Abre Files, abre la carpeta plugins y sube el .jar: Cómo subir, editar y gestionar los archivos de tu servidor.
4. Añade los ajustes del plugin a application.yml (mira más abajo), guarda e inicia el nodo.

Forma 2: una línea de dependency

1. Copia la línea de dependencia del plugin desde su página. Tiene tres partes: group:name:version.
2. Detén el nodo, abre application.yml en Files y sustituye plugins: [] bajo lavalink: por una lista:

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

3. Usa la versión exacta de la página del plugin y el repository que indique, si lo hay.
4. Guarda e inicia el nodo. Lavalink descarga el archivo en plugins en ese inicio y lo conserva.

Los ajustes del plugin

Cada plugin lee su propio bloque bajo la clave de primer nivel plugins:, junto a youtube:. Añade el tuyo dentro de esa misma sección plugins:. Una segunda línea plugins: en el primer nivel rompe el archivo.

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

application.yml es YAML: sangra con espacios, nunca con tabuladores, y mantén cada nivel dos espacios más adentro que el anterior. Un plugin que necesita claves (una cuenta, un ID de cliente) puede detener todo el nodo al iniciar si lo activas sin ellas, así que rellena sus claves o déjalo desactivado.

Comprueba que se cargó

Inicia el nodo y lee Console. Cada plugin que se carga imprime una línea Loaded antes de la línea de listo. En un nodo nuevo, la del plugin de YouTube se ve así:

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

Un plugin que añadiste tiene su propia línea Loaded con el nombre de su archivo. Un plugin de una línea dependency se descarga en el primer inicio y se carga del mismo modo.

Si el nodo se detiene en su lugar, el error justo encima suele nombrar el plugin o la línea de application.yml que falla: Errores de Lavalink y qué significan.

Conviene saber

• Haz un backup antes de editar application.yml: Cómo crear, descargar y restaurar backups.
• No cambies server.port ni plugins.youtube.remoteCipher.url: el panel establece los dos en cada inicio.
• Usa solo plugins de confianza. Un plugin se ejecuta dentro de tu nodo con acceso total a él, incluida la contraseña.
• Los sitios cambian lo que dejan hacer a los bots, así que un plugin de fuente puede necesitar una actualización. Mira primero la página de releases del plugin cuando uno deje de funcionar.
• YouTube tiene su propia guía: Cómo reproducir YouTube en Lavalink 4.