Forge Config API Port — Minecraft Java Edition

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

كيف تعمل المكتبة

تعمل Forge Config API Port كوسيط بين كود التعديل ونظام ملفات اللعبة. وهي تعيد بالكامل إنشاء الحزم الأصلية net.minecraftforge.common.ForgeConfigSpec و net.neoforged.fml.config في بيئة Fabric. يكتب المطور وصف الإعدادات مرة واحدة فقط باستخدام صيغة Forge القياسية، وتقوم المكتبة تلقائيًا بإنشاء الملفات المقابلة على القرص وإدارة تحميلها.

صيغة ملفات الإعدادات TOML

تحفظ المكتبة جميع الإعدادات بصيغة TOML. توفر هذه الصيغة بنية مريحة للقراءة والتعديل باستخدام أي محرر نصوص عادي. يمكن أن تحتوي كل معلمة على تعليقات، قيم افتراضية، بالإضافة إلى حدود واضحة للقيم المقبولة (الحد الأدنى والأقصى للرقم). تظهر ملفات الإعدادات تلقائيًا في مجلد config داخل الدليل الرئيسي للعبة بعد تشغيل التعديل لأول مرة. وهي تحمل الامتداد .toml والاسم الذي حدده مطور التعديل.

المزامنة التلقائية وإعادة التحميل الديناميكي

من أهم ميزات Forge Config API Port هي الدعم المدمج للمزامنة وإعادة التحميل الديناميكي للإعدادات:

• المزامنة بين الخادم والعميل (Sync): عندما يتصل لاعب بالخادم، يرسل الخادم تلقائيًا إعداداته إلى العميل. هذا يمنع حدوث تعارضات بسبب اختلاف إصدارات الإعدادات بين اللاعبين على الخادم.

• إعادة التحميل الديناميكي (Reload): تراقب المكتبة التغييرات في ملفات TOML في الوقت الفعلي. إذا قمت بتعديل وحفظ ملف الإعدادات أثناء اللعب، فستقوم Forge Config API Port على الفور بتحديث المعلمات في الذاكرة العشوائية (RAM) دون الحاجة إلى إعادة تشغيل لعبة Minecraft.

تعمل هذه الآليات تلقائيًا، مما يعفي المطورين من الحاجة إلى برمجة تفاعلات الشبكة بأنفسهم لمزامنة قيم الإعدادات.

الأهمية للاعبين والمطورين

بالنسبة للاعبين العاديين، لا تضيف Forge Config API Port أي محتوى مرئي أو كتل أو عناصر جديدة. يكمن دورها في ضمان تشغيل التعديلات الأخرى. بدون تثبيت هذه المكتبة، لن تبدأ اللعبة ببساطة إذا كانت التعديلات الأخرى تشير إلى كلاساتها. التعديل مطلوب بشكل أساسي لمستخدمي Fabric، حيث أن Forge وNeoForge يحتويان على هذه الميزات بشكل افتراضي في بنيتهما.

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

1. توفير مئات أسطر الكود التي كانت تُستهلك سابقًا لتطوير منطق منفصل لحفظ الإعدادات لمختلف المُحمِّلات.

2. ضمان تجربة إدارة تعديلات متطابقة للمستخدمين النهائيين، حيث أن ملفات الإعدادات لها هيكل متطابق على Fabric وForge.

3. استخدام أدوات التحقق من القيم القوية الخاصة بـ Forge، والتي تصحح تلقائيًا مدخلات المستخدم الخاطئة وتستعيد القيم الافتراضية عند حدوث أخطاء.

التعديلات الشائعة التي تعتمد عليها

يستخدم مطور المكتبة، المعروف باسم Fuzs (أو Fuzs_)، هذه المكتبة في جميع تعديلاته الشائعة. إليك بعض الأمثلة الشهيرة:

• Easy Magic: تعديل يغير ميكانيكيات طاولة التطوير، مما يسمح بحفظ العناصر داخل مخزن الطاولة ويضيف طرقًا جديدة لتحسين التطويرات.

• Trading Post: كتلة تجمع عروض التجارة لجميع القرويين المحيطين في واجهة مستخدم واحدة.

• Visuality: تعديل للمؤثرات البصرية يضيف جزيئات واقعية من الأوساخ والشرارات ورذاذ الماء الناتجة عن أفعال الكائنات المختلفة.

• Easy Shulker Boxes: يتيح التفاعل مع صناديق الشالكر مباشرة من المخزن دون الحاجة إلى وضعها على الأرض.

بالإضافة إلى مشاريع Fuzs، يستخدم مئات المطورين الآخرين Forge Config API Port لنقل أعمالهم من Forge إلى Fabric، مما يمنح اللاعبين إمكانية الوصول إلى مكتبة ضخمة من المحتوى عالي الجودة.