MC Toolkit

أدلة / استكشاف الأخطاء وإصلاحها

رمز الخروج ليس سبب الانهيار، بل مجرد استسلام

الرقم لا يخبرك بشيء. السطر الذي يسبقه يخبرك بكل شيء، وهو موجود بالفعل في مجلد السجلات لديك.

خادم Java يموت يطبع Exit Code 1 ويتوقف. هذه هي الرسالة كاملة. رمز الخروج 1 يعني "انتهت العملية بشكل غير طبيعي" — إنه تصنيف وليس سببًا، ويشمل كل شيء من مجلد عالم مفقود إلى مود يرمي استثناءً أثناء تحميل الفئات.

أين تكمن الإجابة الحقيقية

رمز الخروج هو السطر الأخير من logs/latest.log. السبب موجود في الأسطر التي تسبقه. اقرأ من النهاية إلى الوراء حتى تصل إلى أول Exception أو Caused by: أو Failed to. ذلك السطر يسمّي الفئة أو المود أو الملف.

[Server thread/ERROR]: Encountered an unexpected exception
java.lang.NoSuchMethodError: net.minecraft.world.level.Level.getBiome
    at com.example.mod.ExampleMixin.inject(ExampleMixin.java:41)
Caused by: java.lang.NoClassDefFoundError: com/example/lib/Helper

NoClassDefFoundError هنا هو تبعية مفقودة، وليس عالمًا تالفًا. رمز الخروج لم يخبرك بأي من ذلك.

رموز الخروج التي ستراها فعلاً

الرمزالمعنى المعتاد
0إغلاق نظيف — /stop أو إعادة تشغيل مجدولة
1استثناء غير معالَج، أو رفض JVM بدء التشغيل
137قتلته نواة نظام التشغيل، وفي الغالب قاتل OOM
143SIGTERM — أوقفه منسّق الحاويات

الرمز 137 هو الذي يسيء الناس قراءته على أنه انهيار. لم يفشل JVM؛ بل شيء خارجه قرر أن العملية استهلكت ذاكرة أكثر من اللازم.

Java وBedrock ليستا المشكلة نفسها

خادم Bedrock يكتب bedrock_server.log ولا يصدر رمز خروج بنمط Java إطلاقًا — بل يُفرغ تقرير معالج انهيار يحتوي على تتبع مكدس وسطر Crash report. النصائح المكتوبة لسجلات Java لن تنطبق عليه.

حزم المودات تفشل بشكل مختلف

مع المودات، غالبًا ما يكون الاستثناء الأول مجرد عَرَض. فشل تطبيق mixin ينتج سلسلة يكون فيها الجاني الحقيقي هو أول سطر Mixin apply failed، وليس سطر NoSuchMethodError الذي يبعد ثلاثين سطرًا. ابحث في السجل عن Mixin قبل أن تبحث عن Exception.

التحقق مما إذا كان الخادم يعمل

السجل يخبرك لماذا مات. لكنه لا يخبرك ما إذا كان حيًّا الآن. فحص TCP على منفذ الخادم يجيب على ذلك بطلب واحد، وهو يعمل بنفس الطريقة مع Java وBedrock لأن كليهما يتحدث عبر مقبس.

الصق السجل في أداة Server Diagnostics لاستخراج السطر الفاشل، ووجّهها إلى مضيفك للتأكد من أن الخادم يستجيب فعلاً.

Server Diagnostics →

المزيد من الأدلة

عرض الكل →

تبحث عن أدوات ماينكرافت أخرى؟

مجموعة من المولّدات والعارضات والمحوّلات تعمل في المتصفح — كلها مجانية.