كيفية قراءة تقرير عطل Minecraft

يكتب Minecraft تقرير عطل في كل مرة يتوقف فيها اللعبة أو الخادم بشكل غير متوقع. ابحث هنا:

• crash-reports/
  ملف يحمل طابعًا زمنيًا مثل crash-2026-06-08_14.23.51-server.txt. هذا هو التقرير المخصص والمفصل.
• logs/latest.log
  سجل التشغيل الكامل. إذا لم يكن هناك تقرير عطل (انتهت العملية فقط)، فإن الخطأ هنا، في الأسفل تمامًا.
• logs/debug.log
  سجل أكثر تفصيلًا بكثير، مفيد عندما لا يكون latest.log مفصلًا بما يكفي.

على الخادم، تقع هذه المجلدات في جذر الخادم؛ على العميل، تكون داخل المجلد instance/.minecraft. افتح دائمًا أحدث ملف حسب الطابع الزمني.

كل تقرير له الأجزاء نفسها، من الأعلى إلى الأسفل:

• العنوان والوصف
  سطر Description واحد يلخص ما فشل، بالإضافة إلى الوقت. هذا هو دليلك الأول.
• تتبع المكدس (stack trace)
  نوع الاستثناء، ثم قائمة بأسطر الكود تُظهر أين حدث، وغالبًا ما يتبعها كتلة أو أكثر من Caused by: .
• المستوى / التفاصيل المتأثرة
  بالنسبة لأعطال العالم أو الكيان: الإحداثيات والبُعد والكيان/الكتلة المعنية.
• تفاصيل النظام
  إصدار Minecraft وإصدار Java والذاكرة المخصصة ومحمّل المودات وقائمة المودات الكاملة. ذهب للتشخيص.

1. اقرأ سطر Description. إنه ملخص بلغة بسيطة، مثل «Exception ticking entity» أو «Unexpected error». هذا يخبرك بالفئة بالفعل.
2. اعثر على نوع الاستثناء في أعلى تتبع المكدس (مثل java.lang.OutOfMemoryError, NullPointerException, NoClassDefFoundError). غالبًا ما يسمّي النوع المشكلة مباشرة.
3. انتقل إلى آخر «Caused by:». عندما تكون عدة منها متسلسلة، فإن الأعمق عادة هو السبب الجذري الحقيقي، وليس الأول.
4. ابحث عن اسم مود أو إضافة في مسار الحزمة (مثل com.somemod.Thing). هذا يشير مباشرة إلى المتسبب. أما التتبع net.minecraft.* الخالص فيشير بدلًا من ذلك إلى بيانات vanilla/العالم.
5. تحقق من تفاصيل النظام. تأكد من أن إصدار Java يطابق إصدار Minecraft لديك، وانظر كم من الذاكرة تم تخصيصه، وافحص قائمة المودات بحثًا عن تكرارات أو إدخالات قديمة.
6. طابِق العَرَض مع حل معروف. استخدم السبب الذي وجدته للانتقال إلى الحل المطابق (انظر الأمثلة أدناه).

• OutOfMemoryError: Java heap space
  ذاكرة غير كافية. انظر Out of Memory.
• Exception ticking entity
  كيان واحد تالف. انظر Ticking Entity.
• A single server tick took 60.00 seconds
  تجمّد الخادم. انظر Watchdog Crash.
• NoClassDefFoundError / ClassNotFoundException
  مكتبة مفقودة. انظر NoClassDefFoundError.
• Exit code -1 with no crash report
  اقرأ latest.log بدلًا من ذلك. انظر Error Code -1.

تصفّحها جميعًا في صفحة المشكلات الشائعة .

أحيانًا تنتهي العملية فقط (غالبًا بكود خروج 1 أو -1) دون كتابة تقرير عطل. في هذه الحالة، يكون الخطأ الحقيقي في أسفل logs/latest.log. مرّر للأعلى من النهاية حتى أول سطر ERROR أو FATAL أو Exception: هناك حدث الخلل. لفهم تنسيق السجل نفسه، انظر فهم سجلات Minecraft.