إضافة Minecraft لا تُحمَّل؟ تحقّق من هذه الأمور السبعة.

1. اقرأ أول خطأ ذي صلة في وحدة التحكم

تكتب Paper مشكلات تحميل الإضافات في وحدة تحكم بدء التشغيل وفي logs/latest.log. ابدأ قرب بداية آخر تشغيل، وابحث عن اسم الإضافة، واقرأ الاستثناء الموجود تحته مباشرةً. عادةً يكون أول سطر مفيد أهم من مئات أسطر تتبّع الاستدعاءات التي تليه.

2. تأكّد من أنه ملحق للخادم، وليس موداً

يحمّل Paper وPurpur إضافات Bukkit أو Paper. ويحمّل Fabric وForge وNeoForge المودات. وضع ملف JAR خاص بـ Fabric أو Forge في مجلد Paper plugins لن يجعله متوافقاً. إذا كانت مجموعتك تحتاج إلى مودات على أجهزة اللاعبين والخادم، فابدأ بـ دليل مودات خادم Minecraft بدلاً من ذلك.

3. طابق إصدار الخادم والإضافة

راجع صفحة المشروع الرسمية للإضافة لمعرفة إصدارات Minecraft وبرامج الخادم المدعومة. كلمة Latest لا تعني دائماً أنه يعمل مع كل خادم. إذا ذكر المؤلف دعم Paper فقط، فلا تفترض دعم Folia؛ يشرح دليل Paper وFolia السبب.

4. ثبّت التبعية المفقودة

عادةً يذكر الخطأ UnknownDependencyException إضافةً أخرى يجب تحميلها أولاً، مثل Vault أو ProtocolLib. ثبّت التبعية المطلوبة من صفحتها الرسمية، وتأكّد من دعمها لإصدار الخادم نفسه، ثم أعد التشغيل. لا تنزّل ملفاً عشوائياً باسم مشابه.

5. أزل إصدارات الإضافات المكررة

احتفظ بملف JAR واحد لكل إضافة. مثلاً، قد ينتج عن وجود إصدارين من EssentialsX خطأ ambiguous plugin name. أوقف الخادم، واحتفظ بالإصدار المتوافق، وأزل النسخة المكررة، ثم شغّله مجدداً.

6. افحص اسم الملف ومجلده

يجب أن تكون الإضافة ملفاً كاملاً بصيغة .jar في المستوى الأول من مجلد plugins . لا تبحث Paper في المجلدات الفرعية للإضافات عن ملفات JAR. إذا كان التنزيل ملف ZIP، فاقرأ تعليمات المشروع واستخرج ملف JAR الصحيح الخاص بـ Paper أو Bukkit أولاً.

7. اعزل الإضافة بأمان

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

عندما يوقفك الكتالوج قبل التثبيت

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

• لا يوجد إصدار متوافق: قارن إصدار Minecraft الفعلي وبرنامج الخادم في Manage بصفحة إصدار المؤلف. لا تختر محمّلاً مختلفاً لإجبار البحث على إظهار نتيجة.
• تعارض مع الإصدار المثبت: افحص الإضافة الموجودة قبل إضافة إصدار آخر. احتفظ بنسخة قابلة للاستعادة، وأوقف الخادم قبل تغيير الملفات المثبتة.
• تغيّر الإعداد الذي راجعته: أغلق المراجعة القديمة وافتح مراجعة جديدة بعد تغيير برنامج الخادم أو إصدار اللعبة أو إصدار الإضافة.
• اكتمل التثبيت، لكن الإضافة ما زالت مفقودة: عُد إلى أول خطأ بدء تشغيل وفحوص التبعيات أعلاه. نجاح التنزيل لا يثبت أن Paper فعّلت الإضافة.

حل المشكلات من ChunkArc Manage

افتح وحدة التحكم المباشرة في ChunkArc Manage، وأعد التشغيل مرة واحدة، ودوّن أول خطأ يذكر اسماً. يرشّح كتالوج الإضافات المشاريع حسب برنامج الخادم وإصداره. كما توفّر الإضافات المثبتة التي لها ملفات إعداد مدعومة محرراً محمياً، لتصحيح إعداد YAML أو JSON دون فتح مدير ملفات عام.

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