إصلاح خطأ مزج المقذوفات في ماينكرافت: العثور على التعديل المسؤول عن العطل

إذا توقف ماينكرافت أثناء بدء التشغيل بسبب خطأ في سطر الأوامر org.spongepowered.asm.mixin.transformer.throwables.MixinTransformerError، فهذا يشير إلى وجود خلل في عملية تحويل Mixin، ولكنه عادةً لا يُحدد التعديل أو التغيير الذي تسبب في ذلك. اقرأ Caused byالتفاصيل المتداخلة واسم تكوين Mixin، ثم قارن هذا التعديل بإصدارات ماينكرافت وبرنامج التحميل لديك. هذه هي الطريقة الموثوقة لتحديد سبب هذا العطل.

الكلمة throwablesالمذكورة هنا هي جزء من اسم حزمة جافا لفئات الأخطاء والاستثناءات. ولا تعني كرات الثلج أو الجرعات أو غيرها من العناصر القابلة للرمي في ماينكرافت. كما أن نص الخطأ وحده لا يؤكد وجود تعديل "Throwables Transformer" أو حزمة تعديلات باسم "Mod Mayhem". لذا، تعامل مع أرقام الإصدارات وأسماء ملفات التكوين وحلول الإصلاح السريع غير المذكورة في سجلاتك أو وثائق مطور التعديل على أنها غير موثقة.

ما معنى خطأ MixinTransformerError؟

تستخدم العديد من تعديلات ماينكرافت Mixins لتغيير فئات اللعبة أثناء تحميلها. إذا كان Mixin يتوقع دالة أو فئة مختلفة أو مفقودة في اللعبة المثبتة أو برنامج التحميل أو تعديل آخر، فقد يفشل التحويل. كما يمكن أن يتسبب تعارض بين تعديلين في ظهور نفس المشكلة. يصف دليل Sponge Mixins بأنها تغييرات تُجرى على كود Java أثناء التشغيل، بينما يشرح دليل تقارير الأعطال في Fabric كيف يمكن لأسماء Mixins والفئات المستهدفة المساعدة في تحديد التعديل المعني.

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

اقرأ سجل التغييرات قبل تغيير الملفات

ابحث عن ملف تشغيل اللعبة logs/latest.logوأحدث ملف في مجلد crash-reports. يختلف مجلد Minecraft الافتراضي على أنظمة Windows و macOS و Linux؛ وقد تستخدم برامج تشغيل الطرف الثالث مجلدًا منفصلاً للتشغيل، لذا استخدم خيار "فتح تشغيل" أو "سجل" في برنامج التشغيل. يشرح دليل Fabric لتحميل السجلات المواقع الافتراضية ويوضح محتوى تقارير الأعطال.

ابحث عن MixinTransformerError، ثم افحص الأسطر المحيطة وسلسلة Caused byالرسائل كاملةً. سجّل اسم إعدادات المزيج، والفئة المستهدفة، والطريقة الفاشلة، ومعرّف الوحدة، وأي تبعية مذكورة. لا تعتمد على الأسطر الأخيرة فقط؛ فقد يظهر الدليل المفيد في وقتٍ أبكر.

حل من أربع خطوات لمشكلة تعطل تطبيق ماينكرافت ميكسين

1. قم بعمل نسخة احتياطية من العالم وانسخ النسخة

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

2. توافق إصدارات ماينكرافت، والمحمل، وجافا، والتعديلات

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

على الخادم، تحقق من كلا الجانبين. قارن قائمة التعديلات الخاصة بالخادم مع قائمة التعديلات المطلوبة لدى العملاء، وتأكد من وجود كل تبعية مطلوبة بالإصدار الصحيح. لا تستبدل برنامج التحميل بالكامل أو تضيف Sponge لمجرد ظهور اسم حزمته في تتبع الأخطاء.

3. اعزل التعديل أو زوج التعديلات التي تتسبب في حدوث العطل

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

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

4. قم بتطبيق تغيير موثق واحد وأعد الاختبار

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

زيادة ذاكرة الوصول العشوائي (RAM) بشكل شامل، أو حذف جميع ملفات الإعدادات، أو تعديلها mods.toml، أو إضافة إعدادات Mixin عشوائية، لن تُصلح تعديلًا لم يعد هدف حقنه متوافقًا مع اللعبة. تجنب تعديل ملفات JAR الخاصة بالتعديلات أو تعطيل فحوصات Mixin كحل روتيني؛ فقد تُخفي هذه التغييرات العطل الحقيقي أو تُؤدي إلى تثبيت أقل استقرارًا. قم بإجراء تغيير واحد في كل مرة حتى تتمكن من التراجع عنه إذا تغير الخطأ.

إذا حدث الحادث

شارك تقرير الأعطال الكامل والبيانات ذات الصلة latest.logمع مطور التعديل أو قناة دعم حزمة التعديلات. أدرج إصدار Minecraft الخاص بك، والمُحمِّل، وإصدار Java، وقائمة التعديلات الكاملة، وما إذا كان العطل يحدث على جهاز العميل أو الخادم، والخطوات اللازمة لإعادة إنتاجه. يشرح دليل تقارير أعطال Fabric كيف يمكن لأسماء mixin وفئات الهدف المساعدة في تتبع الفشل. قبل النشر علنًا، احذف رموز الوصول أو أي معلومات خاصة أخرى إن وجدت في السجل، ولكن احتفظ بسلسلة الاستثناءات سليمة.

إذا كنت تستخدم SpongeForge، فراجع ملاحظات توافق التعديلات الخاصة بـ Sponge لمعرفة إصدار Minecraft وإعدادات الخادم المناسبة. يُحذرون من أن بعض التعديلات تتطلب إصدارًا أو ترتيب تحميل متوافقًا، وأن التوافق قد يتغير مع تحديثات الإصدارات. للحصول على معلومات أساسية حول وظيفة Mixin، راجع نظرة عامة على Mixin من Sponge ومشروع SpongePowered Mixin .

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

هل تعني كلمة "throwables" أن تعديل العناصر القابلة للرمي معطل؟

لا. في مسار الحزمة هذا، throwablesيشير إلى فئات الأخطاء والاستثناءات في جافا. استخدم إعدادات المزيج، والفئة المستهدفة، والسبب المتداخل لتحديد الوحدة النمطية ذات الصلة.

هل ينبغي عليّ تخصيص المزيد من ذاكرة الوصول العشوائي (RAM)؟

لا تتحقق من تخصيص الذاكرة إلا عندما يُشير سجل النظام إلى وجود مشكلة في الذاكرة، مثل خطأ في OutOfMemoryErrorحقن Mixin. عادةً ما يتطلب فشل حقن Mixin التحقق من التوافق أو التبعيات أو التفاعل بين التعديلات.

هل يمكنني حذف العالم لإصلاحه؟

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