دليل
كيف تصلح أخطاء plugins الـ Minecraft
حُدّث في 18 أكتوبر 2026
عندما لا يُحمَّل plugin، يقول الخادم السبب في أغلب الأحيان: السبب في وحدة التحكم أثناء الإقلاع، قبل اسم الـ plugin أو بعده ببضعة أسطر. تعلّم قراءة ذلك الجزء من السجل وسيستغرق إصلاح معظم الأخطاء دقيقة. إليك الأخطاء الشائعة ومعانيها.
اذكر إصدار خادمك وما يجب أن يفعله الـ plugin.
ولّد هذا بـ Codexeخطوة بخطوة
1.افتح سجل الإقلاع
اقرأ وحدة التحكم، أو
logs/latest.logفي مجلد الخادم. في لوحة الاستضافة، استخدم وحدة التحكم أو مدير الملفات فيها.2.ابحث عن اسم الـ plugin
اعثر على أول خطأ يذكره. الأسطر التي تبدأ بـ
[ERROR]أو[WARN]ويليها تتبّع المكدس (stack trace) هي المهمة.3.اقرأ السطر الأول وأسطر "Caused by"
يقول السطر الأول ما الذي فشل؛ ويقول آخر سطر
Caused by:عادةً لماذا. والأسطر التي تحمل اسم حزمة الـ plugin نفسه تبيّن أين في كوده.4.طابقه مع القائمة أدناه
معظم أخطاء الإقلاع مشكلة إصدار أو Java أو اعتمادية، والرسالة تقول أيّها.
5.أصلح شيئاً واحداً وأعد التشغيل
غيّر شيئاً واحداً، وأعد التشغيل (لا
/reload) واقرأ السجل من جديد. أخطاء plugin واحد قد تسبب أخطاء في غيره.
الأخطاء الشائعة
| ما تراه | ما يعنيه | الحل |
|---|---|---|
Unsupported API version 1.21 | قيمة api-version للـ plugin أحدث من خادمك. | احصل على النسخة المناسبة لخادمك، أو حدّث الخادم. |
Could not load 'plugins/X.jar' مع Invalid plugin.yml أو Jar does not contain plugin.yml | واصف الـ plugin مفقود أو فيه خطأ YAML، أو أن الملف ليس plugin. | تأكد أنك نزّلت الـ plugin وليس كوده المصدري أو mod أو ملفاً مضغوطاً. وإذا بنيته بنفسك، فأصلح plugin.yml. |
UnsupportedClassVersionError، "class file version 65.0" | يحتاج الـ plugin إلى Java أحدث مما يعمل عليه الخادم (61 = Java 17، و65 = Java 21، و69 = Java 25). | شغّل الخادم على إصدار Java ذاك، أو أعد بناء الـ plugin لإصدار Java لديك. |
NoClassDefFoundError أو ClassNotFoundException | فئة يحتاجها الـ plugin غير موجودة: plugin اعتمادية مفقود، أو مكتبة لم تُضمَّن في ملف .jar، أو أن الـ API غير موجود في هذا الإصدار. | ثبّت الـ plugin المذكور في الخطأ (Vault أو ProtocolLib)، أو استخدم بناءً لإصدارك. |
Unknown/missing dependency plugins | plugin مذكور في depend غير مثبّت. | ثبّته في plugins/. |
Error occurred while enabling X (Is it up to date?) | حُمّل الـ plugin لكنه انهار في onEnable. | اقرأ سطر Caused by: غالباً خطأ في الإعدادات أو اعتمادية مفقودة. |
Ambiguous plugin name | يوجد ملفا .jar للـ plugin نفسه في plugins/. | احذف القديم. |
أخطاء لا تتعلق بالتحميل
- الـ plugin أخضر لكن أمراً يقول "Unknown command": الأمر غير موجود في
plugin.yml، أو أن plugin آخر يستخدم الاسم نفسه. - "I'm sorry, but you do not have permission": ينقص اللاعب عقدة الصلاحية. ابحث عن العقدة في صفحة الـ plugin وامنحها عبر plugin الصلاحيات لديك.
- أخطاء بعد تعديل config.yml: تحتاج YAML إلى مسافات لا علامات جدولة (tabs)، وإلى علامات تنصيص حول النص الذي يبدأ بـ
:أو&. - يعمل بعد إعادة التشغيل، ويتعطل بعد /reload: الـ plugin لا يدعم
/reload. أعد التشغيل بدلاً من ذلك.
أي إصدار Java يحتاجه خادمك
يحتاج Minecraft 1.20.5 وما بعده إلى Java 21، ويحتاج 26.x إلى Java 25؛ ومن 1.18 إلى 1.20.4 يحتاج إلى Java 17. نفّذ java -version بإصدار Java نفسه الذي يستخدمه الخادم (في لوحة الاستضافة يكون عادةً إعداداً اسمه Docker image أو Java version). الـ plugin المبني لإصدار Java أقدم يعمل على إصدار أحدث، لا العكس.
إصلاح plugins مصنوعة بـ Codexe
تُجمَّع الـ plugins المصنوعة على Codexe للإصدار الذي اخترته ويُتحقق من صلاحية plugin.yml قبل أن تصبح Ready. على خادم تجريبي، يعرض تبويب السجلات السجل مباشرة مع إبراز الأخطاء، ويحفظه تصدير السجلات كملف. صف ما تراه في محادثة المشروع ("الـ plugin أحمر في /plugins والسجل يقول ...") وسيغيّر Codexe الكود ويبنيه من جديد. وإذا فشل «تجميع» على الملفات كما سلّمها Codexe تماماً، فإن أصلحه بالذكاء الاصطناعي يصلحها مجاناً.
أسئلة
أين يوجد سجل الخادم؟
logs/latest.log في مجلد الخادم، للتشغيل الحالي. والتشغيلات الأقدم في المجلد نفسه كملفات .log.gz.
هل يمكن لـ plugin أن يعطّل آخر؟
نعم: الاعتمادية المفقودة أو المعطّلة توقف كل plugin يحتاج إليها. أصلح أول خطأ في السجل قبل الأخطاء الأخرى.
هل مشاركة السجل الخاص بي آمنة؟
في الغالب، لكن تحقق منه أولاً: قد تحتوي السجلات على عناوين IP، ومع بعض الـ plugins على كلمات مرور قواعد البيانات الظاهرة في الأخطاء.
أعد بناء plugin معطّل لخادمك
يُفتح هذا الوصف جاهزاً للإرسال:
“plugin لـ Paper 1.21.4 باسم SimpleWarps يحلّ محل القديم الذي لم يعد يُحمَّل: /setwarp و/warp و/delwarp مع اسم، و/warps يعرضها في GUI، وصلاحية warps.admin للإنشاء والحذف، ونقاط الانتقال محفوظة بعد إعادة التشغيل، والرسائل في config.yml.”
ولّد هذا بـ Codexe