المكونات الإضافية على خوادم Minecraft؛ يعمل بنظام الترخيص والاقتصاد والحماية والسوق والحدث والمطالبة ومكافحة الغش والعديد من الأنظمة الخاصة. إذا لم يتم تثبيت أحد المكونات الإضافية، فقد لا يعمل جزء كبير من الخادم.

تحدث أخطاء البرنامج المساعد عادةً في وحدة التحكم أو سجلات/latest.log يظهر في الملف. الأخطاء الأكثر شيوعاً؛ تعذر تحميل البرنامج المساعد, إصدار واجهة برمجة التطبيقات غير مدعوم, تبعية غير معروفة, plugin.yml غير صالح وعدم توافق إصدار Java.

1. أين يمكنك رؤية خطأ البرنامج المساعد؟

إذا لم يتم تحميل المكون الإضافي، فإن أول مكان يجب البحث فيه هو وحدة تحكم الخادم وملف last.log.

tail -n 200 logs/latest.log

للتتبع المباشر:

tail -f logs/latest.log

للبحث حسب اسم البرنامج المساعد:

grep -i "pluginadi" logs/latest.log

2. خطأ في إصدار واجهة برمجة التطبيقات غير مدعوم

يشير هذا الخطأ إلى أن إصدار Minecraft API الذي يدعمه البرنامج المساعد غير متوافق مع إصدار الخادم.

Unsupported API version 1.20

على سبيل المثال، قد يكون البرنامج الإضافي جاهزًا للإصدار 1.20، ولكن قد يكون خادمك يعمل بالإصدار 1.16.5. في هذه الحالة، قد لا يتم تحميل البرنامج الإضافي أو قد يعمل بشكل غير صحيح.

الحل:

• تحقق من إصدار Minecraft الذي يدعمه البرنامج المساعد.
• قم بتنزيل إصدار البرنامج المساعد المتوافق مع إصدار الخادم الخاص بك.
• لا تتوقع أن تعمل المكونات الإضافية الجديدة على خوادم قديمة جدًا.
• إذا لزم الأمر، ابحث عن الإصدار المناسب من أرشيف الإصدار القديم للمكون الإضافي.

3. خطأ تبعية غير معروف

بعض المكونات الإضافية لا تعمل بمفردها. يطلب تثبيت مكون إضافي آخر أولاً. وهذا ما يسمى التبعية.

Unknown dependency Vault
Could not load plugin because dependency LuckPerms was not found

على سبيل المثال، المكونات الإضافية الاقتصادية في كثير من الأحيان قبو يريد. قد تحتاج المكونات الإضافية للتفويض أو السوق أيضًا إلى مكونات إضافية للمكتبة.

الحل:

• اقرأ المتطلبات في صفحة البرنامج المساعد.
• قم بتنزيل البرنامج المساعد التبعية المفقود.
• تأكد من أن المكون الإضافي للتبعية متوافق أيضًا مع إصدار الخادم الخاص بك.
• أعد تشغيل الخادم بالكامل.

4. خطأ plugin.yml غير صالح

داخل ملف جرة البرنامج المساعد plugin.yml إذا كان الملف تالفًا أو مفقودًا أو غير صحيح، فلا يمكن تثبيت البرنامج الإضافي.

Invalid plugin.yml
Plugin does not contain a plugin.yml

يحدث هذا عادة عندما:

• تم تنزيل الملف الخطأ.
• بدلاً من المكون الإضافي، تم وضع الكود المصدري المضغوط في مجلد المكونات الإضافية.
• ملف الجرة تالف.
• تم حزم البرنامج المساعد بشكل غير صحيح من قبل المطور.

كحل، البرنامج المساعد هو الصحيح. .جرة يجب تنزيل الملف. لا ينبغي وضع ملف source-code.zip الذي تم تنزيله من GitHub مباشرةً في مجلد المكونات الإضافية.

5. عدم توافق إصدار جافا

يتطلب إصدار Minecraft والمكونات الإضافية إصدارات Java محددة. إذا تم استخدام إصدار Java خاطئ، فقد لا يتم فتح المكون الإضافي أو الخادم على الإطلاق.

java -version

خطأ شائع:

UnsupportedClassVersionError

يشير هذا الخطأ إلى أنه تم تجميع المكون الإضافي باستخدام Java أحدث، ولكن تم استخدام Java الأقدم على الخادم.

المنطق العام:

• غالبًا ما تتطلب إصدارات Minecraft الأقدم Java أقدم.
• تتطلب إصدارات Minecraft الأحدث إصدار Java أحدث.
• يجب التحقق من متطلبات Java في وصف البرنامج المساعد.
• يجب التحقق من إصدار Java المحدد في لوحة الاستضافة.

6. هل ملف البرنامج المساعد موجود في المجلد الصحيح؟

ملفات البرنامج المساعد على خوادم Bukkit وSpigot وPaper الإضافات يتم طرحه في المجلد.

ls plugins/

يجب أن يكون ملف البرنامج المساعد مثل هذا:

plugins/PluginAdi.jar

غالبًا ما لا تعمل المكونات الإضافية المتبقية في ملفات zip أو rar أو كود المصدر أو المجلدات.

7. تعارضات البرنامج المساعد

قد يتعارض مكونان إضافيان يؤديان نفس المهمة مع بعضهما البعض. على سبيل المثال، قد يحاول مكونان إضافيان مختلفان للدردشة أو مكونان إضافيان اقتصاديان مختلفان أو نظامان مختلفان للمطالبات إدارة نفس الأحداث.

أعراض الصراع:

• تم تثبيت البرنامج المساعد ولكن أوامره لا تعمل.
• أحد المكونات الإضافية يطغى على إعداد الآخر.
• حدث تعارض أو استثناء يحدث في وحدة التحكم.
• لا يمكن للاعبين استخدام الأوامر حتى لو كان لديهم إذن.
• يتصرف الخادم بشكل مختلف بعد إعادة التشغيل.

للعثور على حل، يمكن اختبار المكونات الإضافية عن طريق تعطيلها واحدة تلو الأخرى. ومع ذلك، قبل القيام بذلك على الخادم المباشر، يجب عمل نسخة احتياطية وتفضيل ساعات اللعب المنخفضة.

8. خطأ في التكوين قد يمنع البرنامج المساعد من الفتح

لن يتم فتح بعض المكونات الإضافية إذا كان هناك خطأ YAML في ملف التكوين. تعد المسافات البادئة للمسافات البيضاء مهمة بشكل خاص في ملفات YAML.

الأخطاء الشائعة:

• باستخدام حرف علامة التبويب
• لا تترك مسافة بعد القولون
• كتابة النص الذي يتطلب علامات الاقتباس دون علامات الاقتباس
• تلف الملف بسبب الحرف التركي أو الرمز الخاص
• حفظ ملف التكوين المفقود

إذا كان هناك ملف تكوين غير صحيح، فيمكن إعادة تسمية مجلد البرنامج المساعد مؤقتًا لعمل نسخة احتياطية من مجلد البرنامج المساعد وإعادة إنشاء التكوين.

الأخطاء الشائعة

• تثبيت المكونات الإضافية غير المتوافقة مع إصدار الخادم
• عدم تثبيت المكونات الإضافية للتبعية المفقودة
• الخلط بين الملف المضغوط لمصدر GitHub باعتباره مكونًا إضافيًا
• عدم التحقق من إصدار جافا
• محاولة تثبيت مكون إضافي باستخدام /reload
• استخدام علامات التبويب في ملفات تكوين YAML

الأسئلة الشائعة

الإضافة موجودة في مجلد الإضافات ولكنها لا تعمل، لماذا؟
يمكن أن يكون عدم توافق الإصدار أو التبعية المفقودة أو عدم توافق Java أو خطأ في التكوين. يجب فحص ملف last.log.

ماذا يعني UnsupportedClassVersionError؟
لقد تم للتو تجميع البرنامج المساعد مع Java. إصدار Java المستخدم على الخادم قديم.

هل هي آمنة للاستخدام/إعادة التحميل؟
لا ينصح به للعديد من المكونات الإضافية. تعد إعادة التشغيل الكاملة أكثر أمانًا لتثبيت المكونات الإضافية وإزالتها وتغييرات التكوين الرئيسية.

توصيات السلامة والعمليات

• قم بتنزيل الإضافات من مصادر موثوقة.
• قبل إضافة المكون الإضافي إلى الخادم المباشر، جربه على خادم الاختبار.
• قم بعمل نسخة احتياطية من مجلد المكونات الإضافية قبل كل تحديث للمكونات الإضافية.
• قم بتقليل مساحة الهجوم عن طريق إزالة المكونات الإضافية غير الضرورية.
• تحقق من سجلات البرنامج المساعد بانتظام.

تم إعداد هذه المقالة خصيصًا لـ PvPServer.