Architectury API: نظرة عامة على مكتبة الوسيط للمودات متعددة المنصات في Minecraft

عادةً ما يضطر المطورون، عند إنشاء مودات لعدة محمّلات في Minecraft، إلى كتابة وصيانة قواعد كود منفصلة لكل من Fabric وForge وNeoForge. تحل مكتبة Architectury API هذه المشكلة من خلال توفير طبقة تجريد وسيطة بين كود المود وواجهات البرمجة الخاصة بكل محمّل. فهي تتيح للمطورين إنشاء مودات متعددة المنصات يكون فيها معظم الكود مشتركًا، بينما تتم عملية الترجمة (compilation) لكل بيئة تلقائيًا. بالنسبة للاعبين، تُعد هذه المكتبة تبعية إلزامية لتشغيل عشرات الإضافات الشائعة.

المفهوم والمزايا التقنية لـ Architectury API

الهدف الرئيسي من Architectury API هو تقليل الكود المكرر أثناء تطوير المودات. فبدلًا من تعلّم واستخدام أنظمة الأحداث والتسجيل المنفصلة الخاصة بـ Fabric وForge، يعمل المطورون بفئات وسيطة موحّدة.

أبرز الآليات التي توفرها المكتبة للمطورين:

• سجل موحّد: يتيح تسجيل كتل وعناصر وبيئات (biomes) أو كائنات جديدة عبر واجهة مشتركة واحدة، تقوم المكتبة نفسها بتكييفها لاحقًا مع متطلبات المحمّل المحدد.

• الاتصال الشبكي: يبسّط إرسال حزم بيانات مخصصة بين العميل والخادم من خلال توحيد بروتوكولات الشبكة الخاصة بـ Forge وFabric.

• معالجة الأحداث: يوفّر قائمة مشتركة من أحداث اللعبة (مثل التفاعل مع كتلة، أو موت أحد الكائنات، أو فتح قائمة)، مما يعفي المطور من كتابة مستمعي أحداث منفصلين لكل نظام.

• أتمتة البناء: يقوم امتداد مخصص لبيئة تطوير Gradle بإنشاء ملفات .jar النهائية تلقائيًا لكل محمّل انطلاقًا من الكود المشترك.

الأثر على التوافق والمودات الشائعة المعتمِدة عليها

يُبسّط استخدام Architectury API بشكل كبير صيانة وتحديث المودات لإصدارات Minecraft الجديدة، إذ يكفي المطورين تحديث المكتبة نفسها فقط دون الحاجة لإعادة كتابة منطق إضافاتهم الخاصة. هذا ما يجعل Architectury API ركيزة أساسية للعديد من المشاريع الكبيرة.

أمثلة على مودات معروفة تتطلب هذه المكتبة:

• Cloth Config API: مكتبة شائعة لإنشاء شاشات الإعدادات، تستخدم أدوات Architectury لرسم قوائم الإعدادات.

• Rough Enough Items (REI): واجهة شهيرة لاستعراض وصفات التصنيع، تعتمد على حزم شبكية وسجلات متعددة المنصات.

• Lighty: مود لتصور مستوى الإضاءة، يحتاج إلى Architectury لتتبع أحداث العرض (rendering) على كل من Fabric وForge.

• Better Archeology: إضافة تُدخل هياكل ومواد وكتل أثرية جديدة عبر محمّلات مختلفة باستخدام أدوات تسجيل مشتركة.

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

خصائص التوافق ومتطلبات التثبيت

يصدر فريق التطوير Architectury API كإضافة تقنية بحتة. يجب على اللاعب تنزيل ملف المكتبة الذي يطابق تمامًا إصدار لعبته والمحمّل الذي اختاره (Fabric أو Forge أو NeoForge).

يتم التثبيت وفق المخطط المعتاد — بنقل ملف .jar إلى مجلد mods. لا تُنشئ المكتبة ملفات إعدادات خاصة بها في مجلد config، لأن إعداداتها مدمجة مباشرة في المودات المعتمِدة عليها. تعمل في الخلفية ولا تتطلب أي تدخل يدوي في الإعدادات، مما يستبعد خطر الأعطال الناجمة عن إعداد خاطئ.

الخلاصة

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