فهم سجلات Minecraft

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

ملفات السجل المهمة

كل شيء موجود في المجلد logs/ (جذر الخادم، أو instance/.minecraft على العميل):

  • latest.log
    السجل الكامل للتشغيل الحالي. هذا هو الملف الذي تفتحه أولًا؛ الخطأ يكون هنا دائمًا تقريبًا.
  • debug.log
    نسخة أكثر تفصيلًا بكثير من التشغيل نفسه. استخدمها عندما لا يقول latest.log ما يكفي.
  • السجلات المؤرشفة
    تُضغط عمليات التشغيل الأقدم على هيئة 2026-06-08-1.log.gz. فك ضغطه لقراءة جلسة سابقة.
  • crash-reports/
    مجلد منفصل يحتوي على تقرير مركّز، يُكتب فقط عندما تتعطل اللعبة. انظر كيفية قراءة تقرير عطل Minecraft.

كيفية قراءة سطر سجل

كل سطر يتبع التنسيق نفسه:

[14:23:51] [Server thread/ERROR]: Encountered an unexpected exception
  • [14:23:51]
    الطابع الزمني: متى وقع الحدث.
  • [Server thread/ERROR]
    الخيط الذي سجّله، والمستوى.
  • الرسالة
    ما الذي حدث فعلًا، وغالبًا ما يتبعه تتبع المكدس إذا كان خطأ.

يُظهر لك مستوى السجل الخطورة بنظرة واحدة: INFO (عادي), WARN (هناك خطأ ما لكنه ليس قاتلًا), ERROR (عطل حقيقي), و FATAL (الخادم يُغلق).

الخيوط: من يتحدث

  • Server thread / main
    حلقة اللعبة الأساسية. الأخطاء هنا تؤثر عادة مباشرة على اللعب (وقد تتسبب في تعطل الخادم).
  • Worker / IO threads
    العمل في الخلفية مثل إدخال/إخراج القطع (chunk I/O). مفيد لمشكلات القرص وحفظ العالم.
  • Mod/plugin threads
    مُسمّى باسم مود أو إضافة: تلميح سريع لما هو المسؤول.

ما الذي يجب البحث عنه

  1. مرّر إلى أول سطر ERROR/FATAL أو Exception؛ الأخطاء اللاحقة غالبًا ما تكون مجرد نتائج له.
  2. اقرأ قسم بدء التشغيل بحثًا عن مودات/إضافات فاشلة أو إصدار Java خاطئ أو EULA غير مقبول.
  3. انتبه إلى تكرار رسائل WARN غير المرغوبة مثل «Can't keep up!» (الأداء، انظر Can't Keep Up) أو «moved too quickly».
  4. دوّن آخر الأسطر قبل التجمد أو الإغلاق: فهي تُظهر ما كان الخادم يفعله عندما توقف.
  5. قارن أي خطأ مع المشكلات الشائعة القائمة للحصول على الحل الدقيق.

سجلات الخادم مقابل سجلات العميل

يتشاركان التنسيق نفسه لكنهما في أماكن مختلفة. سجل الخادم يسجّل حفظ العالم واتصالات اللاعبين وتحميل الإضافات/المودات؛ سجل العميل يسجّل العرض وحزم الموارد واتصالك الخاص. عند استكشاف مشكلة انضمام، قارن كليهما: قد يكون السبب في جانب واحد فقط.

مشاركة السجلات بأمان

قد تحتوي السجلات على عنوان IP الخاص بخادمك وأحيانًا رموزًا، لذا لا تلصقها علنًا دون إلقاء نظرة أولًا. استخدم خدمة لصق (مثل mclo.gs) للمشاركة، أو ارفع الملف مباشرة إلى MCDoctor.ai، الذي يقرأ السجل ويشرح لك السبب والحل، دون تنقيب يدوي.

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

في مجلد logs/ في جذر خادمك أو في مجلد instance/.minecraft. التشغيل الحالي هو latest.log؛ والتشغيلات الأقدم هي ملفات .log.gz مضغوطة.

يغطّيان التشغيل نفسه، لكن debug.log أكثر تفصيلًا بكثير. ابدأ بـ latest.log وانتقل إلى debug.log فقط عند الحاجة إلى مزيد من التفاصيل.

يعني WARN أن هناك خطأً ما لكنه ليس قاتلًا؛ وERROR هو فشل حقيقي؛ وFATAL يعني أن الخادم يتوقف. ركّز على أول سطر ERROR/FATAL.

نعم، ارفع latest.log أو تقرير عطل وسيحلّله MCDoctor.ai ويعيد السبب المحتمل والإصلاح الموصى به.