حل مشكلة تعطل إعدادات ماينكرافت: حل مشكلة "لا يمكن الحصول على قيمة الإعدادات قبل تحميلها"

لحل مشكلة تعطل إعدادات ماينكرافت، توقف عن قراءة قيمة إعدادات Forge حتى يقوم Forge بتحميل الإعدادات المطابقة. سجّل الإعدادات ForgeConfigSpecفي مُنشئ التعديل الخاص بك، ثم اقرأ قيمها من دالة الاستدعاء الخاصة بتلك الإعدادات ModConfigEvent.Loading. ModConfigEvent.Reloadingإذا كنت تُثبّت تعديلًا لشخص آخر، فقم بتحديث أو عزل التعديل المذكور في تقرير العطل؛ لأن إصلاح الكود يعود لمؤلف ذلك التعديل.

تُصاغ الرسالة عادةً على النحو التالي IllegalStateException: Cannot get config value before config is loaded. تشير إلى قراءة مبكرة لقيمة إعداد، لكن تتبع المكدس الدقيق والمُحمِّل مهمان. كُتب مثال Forge أدناه لنمط واجهة برمجة تطبيقات Forge 1.20.1؛ لا تقم بلصقه دون تغيير في NeoForge أو مشروع Fabric.

ماذا يعني خطأ IllegalStateException في إعدادات ماينكرافت؟

يُمكّن Forge المود من تعريف متغير ForgeConfigSpecوتحميل قيمه من ملفات الإعدادات. المتغير ConfigValueعبارة عن مرجع لإعداد معين؛ ويطلب .get()استدعاء الدالة القيمة المحملة. إذا تمت عملية القراءة قبل أن يقوم Forge بربط ملف الإعدادات المناسب وتحميله، فإنه يُطلق استثناء IllegalStateException بدلاً من إرجاع قيمة.

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

إصلاح مشكلة تعطل إعدادات Forge في أربع خطوات

الخطوة 1: تحديد أي وحدة تقرأ القيمة مبكرًا جدًا

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

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

الخطوة الثانية: تحديد وتسجيل مواصفات التكوين

أنشئ المواصفات مرة واحدة، واحتفظ بكائن القيمة، ثم سجّل نفس المواصفات من مُنشئ mod. يُعرّف هذا المثال عددًا صحيحًا محدودًا في تكوين شائع:

public final class MyModConfig {
    public static final ForgeConfigSpec SPEC;
    public static final ForgeConfigSpec.IntValue MAX_MOBS;

    static {
        ForgeConfigSpec.Builder builder = new ForgeConfigSpec.Builder();
        MAX_MOBS = builder.defineInRange("maxMobs", 10, 0, 100);
        SPEC = builder.build();
    }
}

public ExampleMod() {
    IEventBus modBus = FMLJavaModLoadingContext.get().getModEventBus();
    ModLoadingContext.get().registerConfig(ModConfig.Type.COMMON, MyModConfig.SPEC);
    modBus.addListener(this::onConfigLoading);
    modBus.addListener(this::onConfigReloading);
}

تأكد من أن نوع التكوين المُعلن عنه متوافق مع مكان وجود الإعداد. يميز Forge بين CLIENTتكوينات COMMONو و SERVER؛ ولا يمكن استبدال تكوين خادم العالم بملف خاص بالعميل فقط.

الخطوة 3: قراءة القيم من أحداث التحميل وإعادة التحميل المطابقة

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

private static volatile int maxMobs = 10;

private void onConfigLoading(ModConfigEvent.Loading event) {
    updateIfOwned(event.getConfig());
}

private void onConfigReloading(ModConfigEvent.Reloading event) {
    updateIfOwned(event.getConfig());
}

private void updateIfOwned(ModConfig config) {
    if (config.getSpec() != MyModConfig.SPEC) return;
    maxMobs = MyModConfig.MAX_MOBS.get();
}

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

الخطوة الرابعة: اختبر مسار بدء التشغيل نفسه الذي تسبب في التعطل

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

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

إذا كان المشروع يستخدم Fabric أو NeoForge

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

إذا كانت أسماء تتبع الأخطاء غير صحيحة net.neoforged، فاستخدم وثائق واجهة برمجة تطبيقات NeoForge لمعرفة إصدار Minecraft وNeoForge المحدد. يتشارك Forge وNeoForge في بعض المفاهيم، لكن أسماء الحزم وواجهات برمجة التطبيقات المدعومة قد تختلف. لا تخلط بين أجزاء التعليمات البرمجية الخاصة بهما أو تُضف دالة رد نداء وهمية لإخفاء الاستثناء.

قائمة التحقق السريعة للوقاية

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

للحصول على تفاصيل خاصة بكل إصدار، يُرجى مراجعة دليل تهيئة Forge 1.20.1 ، ووثائق دورة حياة التعديلات الخاصة به ، ودليل ناقل أحداث Forge . ينبغي لمطوري Fabric البدء بوثائق Fabric Loader ثم مراجعة مكتبة التهيئة المستخدمة في مشروعهم.