Lavalink’e plugin nasıl eklenir

Plugin’ler Lavalink’e kaynaklar ve özellikler ekler: başka müzik siteleri, şarkı sözleri, arama türleri ve daha fazlası. PlayNHost node’unda bir plugin’i iki yolla eklersiniz: plugin’in .jar dosyasını plugins klasörüne koyarsınız ya da bir dependency satırını application.yml dosyasına ekleyip Lavalink’in onu indirmesini sağlarsınız. İki durumda da ayarları plugins: bölümüne yazılır (application.yml içinde) ve node’un yeniden başlatılması gerekir.

Zaten olanlar

Node’unuz tek bir plugin’le başlar: YouTube kaynağı, plugins/youtube-plugin-1.18.2-playnhost1.jar olarak, ayarları plugins:, youtube: altında. lavalink: altındaki plugin listesi boştur:

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

YouTube plugin’ini ne dosya olarak ne de dependency satırı olarak yeniden eklemeyin. Onun için başka bir sürümle yazılmış bir dependency satırı, Lavalink’in PlayNHost dosyasını bir sonraki başlangıçta silmesine yol açar (console Deleted ./plugins/youtube-plugin-1.18.2-playnhost1.jar der).

1. yol: plugin dosyasını yükleyin

Bu, plugin’in indirme sitesi kapalı olsa bile çalışır, çünkü başlangıçta hiçbir şey indirilmez.

1. Plugin’in .jar dosyasını kendi sürüm sayfasından indirin, genellikle GitHub’dan. Lavalink 4 için yapılmış bir sürüm seçin.
2. Panel’de node’u durdurun.
3. Files’ı açın, plugins klasörünü açın ve .jar dosyasını yükleyin: Sunucu dosyalarınızı yükleme, düzenleme ve yönetme.
4. Plugin’in ayarlarını application.yml dosyasına ekleyin (aşağıya bakın), kaydedin ve node’u başlatın.

2. yol: bir dependency satırı

1. Plugin’in dependency satırını sayfasından kopyalayın. Üç parçası vardır: group:name:version.
2. Node’u durdurun, application.yml dosyasını Files altında açın ve plugins: [] satırını (lavalink: altındaki) bir listeyle değiştirin:

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

3. Plugin’in sayfasındaki tam sürümü ve varsa onun belirttiği repository adresini kullanın.
4. Kaydedin ve node’u başlatın. Lavalink dosyayı o başlangıçta plugins klasörüne indirir ve saklar.

Plugin’in ayarları

Her plugin kendi bloğunu, en üst düzeydeki plugins: anahtarının altında, youtube: yanında okur. Sizinkini aynı plugins: bölümünün içine ekleyin. En üst düzeyde ikinci bir plugins: satırı dosyayı bozar.

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

application.yml bir YAML dosyasıdır: boşlukla girinti verin, asla sekme kullanmayın ve her seviyeyi bir üstündekinden iki boşluk içeride tutun. Anahtarlara (bir hesap, bir client ID) ihtiyaç duyan bir plugin, onlar olmadan açılırsa başlangıçta tüm node’u durdurabilir; bu yüzden anahtarlarını doldurun ya da kapalı bırakın.

Yüklendiğini kontrol edin

Node’u başlatın ve Console’u okuyun. Yüklenen her plugin, hazır satırından önce bir Loaded satırı yazdırır. Yeni bir node’da YouTube plugin’inin satırı şöyle görünür:

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

Kendi eklediğiniz bir plugin, dosya adıyla birlikte kendi Loaded satırını alır. Bir dependency satırından gelen plugin ilk başlatmada indirilir, sonra aynı şekilde yüklenir.

Bunun yerine node duruyorsa, hemen üstündeki hata genellikle sorunlu plugin’i ya da application.yml satırını belirtir: Lavalink hataları ve ne anlama geldikleri.

Bilmekte fayda var

• application.yml dosyasını düzenlemeden önce yedek alın: Yedek oluşturma, indirme ve geri yükleme.
• server.port ya da plugins.youtube.remoteCipher.url değerlerini değiştirmeyin: panel ikisini de her başlangıçta ayarlar.
• Yalnızca güvendiğiniz plugin’leri kullanın. Bir plugin node’unuzun içinde, şifre dahil tam erişimle çalışır.
• Siteler botlara neye izin verdiklerini değiştirir, bu yüzden bir kaynak plugin’i güncelleme gerektirebilir. Biri çalışmayı bıraktığında önce plugin’in sürüm sayfasına bakın.
• YouTube’un kendi rehberi var: Lavalink 4’te YouTube nasıl oynatılır.