كيف تضيف إضافات إلى Lavalink

تضيف الإضافات مصادر وميزات إلى Lavalink: مواقع موسيقى أخرى، وكلمات الأغاني، وأنواع بحث وغير ذلك. على عقدة PlayNHost تضيف الإضافة بطريقتين: ضع ملف .jar الخاص بها في مجلد plugins، أو أضف سطر dependency إلى application.yml ودع Lavalink ينزّلها. وفي الحالتين تُوضع إعداداتها تحت قسم plugins: في application.yml، وتحتاج العقدة إلى إعادة تشغيل.

ما الموجود أصلًا

تبدأ عقدتك بإضافة واحدة: مصدر YouTube، بصيغة plugins/youtube-plugin-1.18.2-playnhost1.jar، وإعداداتها تحت plugins: ثم youtube:. وقائمة الإضافات تحت lavalink: فارغة:

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

لا تضف إضافة YouTube مرة أخرى، لا كملف ولا كسطر dependency. سطر dependency لها بإصدار آخر يجعل Lavalink يحذف ملف PlayNHost عند البدء التالي (تعرض Console السطر Deleted ./plugins/youtube-plugin-1.18.2-playnhost1.jar).

الطريقة 1: ارفع ملف الإضافة

تعمل هذه الطريقة حتى حين يكون موقع تنزيل الإضافة معطلًا، لأن شيئًا لا يُنزَّل عند البدء.

1. نزّل ملف .jar الخاص بالإضافة من صفحة إصداراتها، وغالبًا ما تكون على GitHub. اختر إصدارًا مصنوعًا لـ Lavalink 4.
2. في اللوحة، أوقف العقدة.
3. افتح Files، وافتح مجلد plugins وارفع ملف .jar: كيف ترفع ملفات سيرفرك وتعدّلها وتديرها.
4. أضف إعدادات الإضافة إلى application.yml (انظر أدناه)، واحفظ، ثم شغّل العقدة.

الطريقة 2: سطر dependency

1. انسخ سطر dependency الخاص بالإضافة من صفحتها. يتكون من ثلاثة أجزاء: group:name:version.
2. أوقف العقدة، وافتح application.yml في Files، واستبدل plugins: [] تحت lavalink: بقائمة:

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

3. استخدم الإصدار الدقيق من صفحة الإضافة، وقيمة repository التي تذكرها إن وُجدت.
4. احفظ وشغّل العقدة. ينزّل Lavalink الملف إلى plugins عند هذا البدء ويحتفظ به.

إعدادات الإضافة

تقرأ كل إضافة كتلتها الخاصة تحت المفتاح plugins: في المستوى الأعلى، بجانب youtube:. أضف كتلتك داخل قسم plugins: نفسه. وجود سطر plugins: ثانٍ في المستوى الأعلى يعطّل الملف.

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

ملف application.yml بصيغة YAML: استخدم المسافات للإزاحة، لا علامات Tab أبدًا، واجعل كل مستوى أعمق من الذي فوقه بمسافتين. والإضافة التي تحتاج إلى مفاتيح (حساب أو معرّف عميل) قد توقف العقدة كلها عند البدء إذا فُعّلت بدونها، فأدخل مفاتيحها أو اتركها معطلة.

تحقق من أنها تحمّلت

شغّل العقدة واقرأ Console. كل إضافة يتم تحميلها تطبع سطر Loaded قبل سطر الجاهزية. وعلى عقدة جديدة يبدو سطر إضافة YouTube هكذا:

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

الإضافة التي أضفتَها تحصل على سطر Loaded خاص بها باسم ملفها. والإضافة القادمة من سطر dependency تُنزَّل عند التشغيل الأول ثم تُحمَّل بالطريقة نفسها.

إذا توقفت العقدة بدلًا من ذلك، فالخطأ الذي فوق هذه الأسطر مباشرة يذكر عادةً اسم الإضافة أو سطر application.yml المسبب: أخطاء Lavalink ومعناها.

من المفيد أن تعرف

• خذ نسخة احتياطية قبل أن تعدّل application.yml: كيف تنشئ النسخ الاحتياطية وتنزّلها وتستعيدها.
• لا تغيّر server.port ولا plugins.youtube.remoteCipher.url: تضبط اللوحة كليهما عند كل بدء.
• لا تستخدم إلا إضافات تثق بها. تعمل الإضافة داخل عقدتك بوصول كامل إليها، بما في ذلك كلمة المرور.
• تغيّر المواقع ما تسمح به للبوتات، فقد يحتاج مصدر الإضافة إلى تحديث. راجع صفحة إصدارات الإضافة أولًا حين يتوقف أحدها عن العمل.
• لدى YouTube دليله الخاص: كيف تشغّل YouTube على Lavalink 4.