خطأ NoClassDefFoundError في ماينكرافت: إصلاح أعطال فئة جافا المفقودة

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

إذا بحثت عن خطأ "Lang Java" في ماينكرافت، java.langفإن اسم حزمة Java هو المذكور في نص الخطأ. وهو ليس مجلد موارد لغة ماينكرافت. اتبع الخطوات الأربع التالية بالترتيب، وتجنب حذف ملفات الحفظ أو مجلد مكتبات ماينكرافت بالكامل كخطوة أولى.

ما معنى خطأ NoClassDefFoundError في ماينكرافت جافا

يُعرّف أوراكل NoClassDefFoundErrorخطأ NoClassDefFoundError بأنه خطأ في الربط يحدث عندما يتعذر على JVM أو مُحمّل الفئات العثور على تعريف فئة يحتاجها الكود أثناء التشغيل. في ماينكرافت، قد تنتمي هذه الفئة إلى ماينكرافت نفسها، أو إلى Fabric أو Forge، أو إلى إضافة، أو إلى مكتبة تتطلبها إضافة. قد يحدث هذا الخطأ بعد التحديث، أو عند إنشاء إضافة لإصدار مختلف من ماينكرافت أو مُحمّل الفئات، أو عند غياب تبعية مطلوبة، أو عند تلف التثبيت أو بيئة التشغيل. لا يُحدد الاسم وحده السبب المُطبق. يشرح مرجع واجهة برمجة تطبيقات جافا من أوراكل لخطأ NoClassDefFoundError معناه على مستوى JVM.

اقرأ اسم الفئة بعد النقطتين. على سبيل المثال، net/fabricmc/...يشير إلى كود متعلق بـ Fabric، بينما com/vendor/mod/...يشير غالبًا إلى وحدة نمطية أو مكتبة مدمجة. الاسم الموجود أسفل هذا الرمز java/lang/ينتمي إلى بيئة تشغيل Java. هذه مجرد دلائل، وليست حكمًا قاطعًا؛ استخدم تتبع المكدس المحيط للتأكد.

java.lang.IllegalArgumentExceptionهو نفسه ملف جافا قياسي، وليس ملف لغة ماينكرافت. إذا أشارت سجلات النظام إلى أن هذا الملف مفقود، فاعتبر إعدادات وقت التشغيل أو تحميل الملفات المختارة غير صحيحة، وتحقق منها بتشغيل اللعبة بدون تعديلات. لا تقم بتنزيل ملف بديل من موقع خارجي.

أربع خطوات لإصلاح خطأ NoClassDefFoundError في ماينكرافت

1. ابحث عن الفئة المفقودة بالضبط في السجل

افتح أحدث تقرير عطل خاص logs/latest.logبالتثبيت المتأثر. ابحث عن NoClassDefFoundError، وانسخ اسم الفئة الكامل الذي يليه، واقرأ عدة أسطر أعلى وأسفل التطابق. لاحظ أيضًا Caused by:الإدخال الأول وأول وحدة أو مُحمِّل مذكور في تتبع المكدس. قد يكون السطر الأخير نتيجة لعطل سابق، لذا لا تتوقف عند الرسالة الأخيرة.

بالنسبة لمشغل Minecraft القياسي، توجد سجلات اللعبة عادةً داخل مجلد دليل اللعبة logs، وتقارير الأعطال في مجلد آخر crash-reports. أما مجلد اللعبة المخصص أو مشغل الطرف الثالث، فيحتفظ بملفاته في مجلد خاص به. يُدرج دليل البحث عن السجلات في Fabric المواقع الشائعة للعديد من المشغلات. إذا كنت ستشارك سجلًا للمساعدة، فاحذف تفاصيل الحساب ورموز الوصول وعناوين الخوادم الخاصة أولًا.

2. اختبر نفس إصدار ماينكرافت بدون تعديلات.

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

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

3. قم بمطابقة كل تعديل مع اللعبة وبرنامج التحميل

تأكد من إصدار ماينكرافت، ونوع برنامج التحميل، وإصدار برنامج التحميل الظاهر في الملف الشخصي المتأثر. ثم تحقق من صفحة إصدار كل إضافة مشتبه بها للتأكد من توافقها مع الإصدارات الثلاثة. لا يمكن استبدال إصدارات Fabric وForge وNeoForge إلا إذا نصّ مطور الإضافة صراحةً على التوافق. ثبّت أيضًا التبعيات المذكورة من قِبل مطور الإضافة؛ فقد تكون الإضافة موجودة بينما لا توجد إحدى الفئات التي تعتمد عليها.

ابدأ بالتعديلات التي أُضيفت أو حُدِّثت مباشرةً قبل حدوث العطل. انقلها إلى مجلد مؤقت خارج اللعبة بدلاً من حذفها. إذا بدأت اللعبة، فأضف التعديلات المحذوفة تدريجيًا حتى يعود الخطأ؛ تحقق من آخر دفعة والتبعيات المُعلنة لها. بالنسبة لحزم التعديلات الكبيرة، استخدم وظيفة الإصلاح أو التحديث الخاصة بالحزمة، وتجنب خلط الملفات من حزم غير ذات صلة. قد يتسبب عدم التوافق الموثق في ظهور خطأ "فئة مفقودة" حتى عندما تكون جميع ملفات JAR قابلة للقراءة، لذا فإن استبدال ملف تالف ليس الحل دائمًا. تتضمن الأسئلة الشائعة لمستخدمي Fabric أمثلة على عدم توافق المُحمِّل والتعديلات.

4. تحقق من Java، ثم أصلح التثبيت المتأثر فقط.

يعتمد إصدار Java المطلوب على إصدار Minecraft وبرنامج التشغيل. يتضمن برنامج تشغيل Minecraft الرسمي بيئة تشغيل Java خاصة به لملفات تعريف اللعبة العادية، لذا فإن تثبيت JDK على مستوى النظام ليس حلاً تلقائيًا. إذا كنت تستخدم برنامج تشغيل آخر أو تشغل خادمًا يدويًا، فتحقق من ملف Java القابل للتنفيذ المُختار لتلك الحالة وقارن الإصدار المطلوب مع وثائق اللعبة وبرنامج التحميل. على سبيل المثال، تشير ملاحظات إصدار Mojang 1.20.5 إلى أن اللعبة تتطلب Java 21؛ ولا ينبغي تطبيق هذا الشرط على جميع إصدارات Minecraft. راجع ملاحظات إصدار 1.20.5 الرسمية ودليل تثبيت Java من Fabric .

إذا أشارت سجلات اللعبة إلى وجود مشكلة في أحد ملفات Minecraft الأساسية، واستمرت المشكلة حتى بعد تثبيت ملف تعريف جديد، فقم بعمل نسخة احتياطية من savesملفات اللعبة، بما في ذلك لقطات الشاشة وأي إعدادات ترغب في الاحتفاظ بها. ثم أعد إنشاء الإصدار أو ملف التعريف المتأثر فقط من خلال عملية التثبيت أو الإصلاح المدعومة من قِبل المُشغّل. لا تحذف .minecraft/librariesالمجلد بأكمله، أو جميع الإصدارات، أو ذاكرة التخزين المؤقت المشتركة للمُشغّل دون وجود دليل؛ لأن عملية التنظيف الشاملة قد تُؤدي إلى زيادة عدد التنزيلات وتُصعّب تحديد السبب الأصلي. لا تستبدل ملف JAR الخاص باللعبة بملف من موقع غير رسمي.

أخطاء شائعة لا تعالج السبب

• لا تُضِف علامات JVM عشوائية. فمثل هذه العلامات -Dfml.ignorePatchDiscrepancies=trueلا تُعيد فئة مفقودة، وقد تُخفي معلومات تشخيصية مفيدة.
• لا تفترض أن جافا قديمة دائمًا. قد يحدث عدم توافق في وقت التشغيل، ولكن قد يكون سبب عدم وجود الفئة هو تبعية لوحدة إضافية أو مُحمِّل غير متوافق. يُعد نص الاستثناء واختبار جافا الأساسي أكثر فائدة من تثبيت أحدث إصدار من جافا دون تدقيق.
• لا تقم بمسح بيانات العالم لاختبار تعطل التشغيل. نادرًا ما يكون العالم ضروريًا لإعادة إنتاج عطل يحدث أثناء بدء التشغيل. احتفظ بملفات الحفظ الأصلية دون تغيير أثناء الاختبار.

إذا استمر الحادث

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