إصلاح مشكلة "خطأ أثناء حل تعارض الوحدات" في ماينكرافت

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

ماذا يعني خطأ حل وحدات ماينكرافت؟

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

إذا ذكرت الرسالة Error while resolving modulesاسمًا معينًا java.lang.module.ResolutionException، فغالبًا ما يشير ذلك إلى تعارض في بدء التشغيل المبكر في إعداد Forge أو NeoForge/ModLauncher. Modules A and B export package ... to module Cيشير سطر مثل هذا إلى تعارض في الحزم: من غير المرجح أن يحل تثبيت مكتبة أخرى المشكلة. في المقابل، رسائل Fabric أو Quilt التي تقول إن أحد التعديلات "يتطلب" تبعية معينة تعني عادةً أن هذه التبعية مفقودة أو أن الإصدار المثبت خارج النطاق المقبول. يفصل دليل استكشاف الأخطاء وإصلاحها في Quilt تحديدًا بين التبعيات المفقودة، والإصدارات غير المتوافقة، وأخطاء حل ملفات Jar-in-Jar.

أربع خطوات لإصلاح تعارض التبعيات أو الوحدات النمطية

1. قم بعمل نسخة احتياطية من ملف الحفظ والتقط صورة للخطأ بالكامل

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

ابحث من الأسفل عن أول مُعرّف Caused byتعديل ( mod ID) مُسمى. سجّل اسمي ResolutionExceptionالوحدتين أو التعديلين، بالإضافة إلى إصداري Minecraft وLoader بدقة. لا يكفي رمز الخروج وحده لتحديد مشكلة التبعية.requiresexports package

2. قم بمطابقة ملفات Minecraft، وبرنامج التحميل، وملفات التعديل.

تأكد من أن كل ملف JAR ينتمي إلى إصدار Minecraft المحدد، وإصدار Java، والمُحمِّل. لا يمكن استبدال تعديلات Fabric بإصدارات Forge أو NeoForge، كما أن عمل تعديل على إصدار Minecraft معين لا يضمن عمله على إصدار آخر. يُشير دليل تثبيت Fabric الرسمي إلى توافق كلٍّ من إصدار اللعبة والمُحمِّل. تأكد أيضًا من تغيير النسخة النشطة ، وليس مجلدًا مختلفًا .minecraft/mods.

تحقق من بيئة تشغيل Java فقط إذا أشارت سجلات النظام أو إعدادات التشغيل إلى عدم توافق في إصدار Java. تختلف المتطلبات باختلاف إصدار Minecraft: تستخدم الإصدارات الحديثة مثل 1.20.5 والإصدارات اللاحقة من 1.21 إصدار Java 21، بينما يُشير دليل Fabric 26.1 الحالي إلى استخدام Java 25. يُعد دليل Fabric Java الرسمي وملاحظات إصدار برنامج التشغيل مرجعين أكثر موثوقية من قاعدة "Java 21 لكل إصدار حالي". قد يستخدم مُشغّل Minecraft القياسي بيئة تشغيل مُدمجة؛ بينما يُمكن لملف تعريف مُشغّل مُخصص أو خادم أن يُشير إلى تثبيت Java مختلف.

3. حل مشكلة التبعية المفقودة من مصدر التعديل المذكور

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

لا تقم بتعديل fabric.mod.jsonملفات neoforge.mods.tomlالتعديل التي تم تنزيلها لتجاوز فحص الإصدار. تصف هذه الملفات قواعد التوافق والتبعيات الخاصة بالمؤلف؛ فتغييرها لا يُضيف أي كود مفقود، وقد يُحوّل تحذير بدء التشغيل الواضح إلى عطل لاحق. توضح وثائق ملفات التعديل في NeoForge بيانات التبعيات ونطاقات التوافق.

4. عزل تعارض الوحدات دون تعريض الحزمة الرئيسية للخطر

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

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

ما لا يجب تغييره

• لا تقم بإضافة علامات JVM غير الموثقة مثل -Dfabric.addModules=true; لا يتم إصلاح تعارض تصدير الوحدة النمطية عن طريق فرض وحدات نمطية غير ذات صلة في عملية التشغيل.
• لا تقم بحذف المجلد بأكمله modsأو إعادة تثبيت المشغل قبل قراءة أول سطر سجل ذي معنى.
• لا تفترض أن أحد التعديلات المألوفة هو السبب لمجرد وجود قائمة ثابتة بـ"الأسباب الرئيسية". تتغير التوافقية مع إصدارات ماينكرافت، وبرنامج التحميل، والتعديلات.
• لا تختبر التغييرات على نسختك الوحيدة من عالم قيّم. شغّل اللعبة حتى تصل إلى شاشة العنوان أولاً، ثم اختبر عالماً مؤقتاً قبل فتح ملف حفظ طويل الأمد.

متى يجب الإبلاغ عن ذلك لمطور التعديل؟

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

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