Cardinal Components API — Minecraft Java Edition 1.18 – 26.1+
الاعتماديات: المُحمِّل: Fabric، Quilt إصدار Minecraft: 1.18 – 26.1+ الاعتماديات الإلزامية: Fabric API Cardinal Components API هي مكتبة…
الاعتماديات: المُحمِّل: Fabric، Quilt إصدار Minecraft: 1.18 – 26.1+ الاعتماديات الإلزامية: Fabric API Cardinal Components API هي مكتبة تقنية أساسية (Library Mod) لمنظومة Fabric وQuilt. وهي لا تضيف إلى اللعبة أي كتل أو ع
الاعتماديات:
المُحمِّل: Fabric، Quilt
إصدار Minecraft: 1.18 – 26.1+
الاعتماديات الإلزامية: Fabric API
Cardinal Components API هي مكتبة تقنية أساسية (Library Mod) لمنظومة Fabric وQuilt. وهي لا تضيف إلى اللعبة أي كتل أو عناصر أو مكونات لعب جديدة قد يراها اللاعب العادي. مهمتها الوحيدة، لكنها بالغة الأهمية، هي تزويد المطورين بمعيار شامل ومُحسَّن لربط بياناتهم الخاصة بكائنات اللعبة الأصلية (اللاعبون، الوحوش، القِطَع وما إلى ذلك).
لماذا تتطلب اللعبة هذا المود؟
بالنسبة للمستخدم العادي أو لمُجمِّع حِزَم المودات، يعمل هذا المود حصريًا "خلف الكواليس":
اعتمادية إلزامية: هذه المكتبة موجودة في قائمة متطلبات العديد من التعديلات المحتوائية الضخمة. فإذا أضاف المود نظام مانا سحرية، أو شجرة مهارات، أو خصائص فريدة للأسلحة، أو آلية عطش، فإنه يستخدم Cardinal Components لحفظ هذه البيانات. وبدونها سيُنهي العميل تشغيله مع خطأ (Crash).
استقرار التجميعة: بفضل استخدام مختلف المودات لواجهة برمجة تطبيقات مشتركة للتعامل مع البيانات، يقل بشكل كبير الضغط على الذاكرة العشوائية للخادم وتُقلَّص إلى أدنى حد التعارضات الداخلية بين الإضافات.
ربط البيانات (Data Attachment)
قبل إنشاء هذه المكتبة، كان على المبرمجين كتابة أنظمتهم المعقدة الخاصة أو استخدام طرق غير فعّالة لحفظ المعلومات المخصصة. تحل Cardinal Components هذه المشكلة عبر نظام أنيق من "المكونات"، يتيح ربط حاوية بيانات بأي فئة أساسية في Minecraft.
الكائن (الفئة) | أمثلة على الاستخدام |
الكيانات / اللاعبون (Entities / Players) | حفظ أوقات انتظار القدرات، والانتماء إلى فصيل، ومستوى الدرع الطاقي، أو مؤشرات مص الدماء. |
العناصر (Item Stacks) | حفظ الحالة الفريدة للسلاح (مثل شحن البطارية أو سجل القتل) دون استخدام وسوم NBT الأصلية الثقيلة. |
القِطَع / العوالم (Chunks / Worlds) | تسجيل مستوى التلوث السحري في قطعة معينة، أو الإحصاءات الاقتصادية العالمية للخادم، أو طقس مخصص. |
الجداول (Scoreboards) | ربط بيانات محددة بالفرق الأصلية (Teams) أو الأهداف (Objectives). |
أتمتة المهام الروتينية للمطورين
لا تكتفي واجهة برمجة التطبيقات بحفظ البيانات فحسب، بل تتولى أيضًا إدارة دورة حياتها:
الحفظ التلقائي (Persistence): تُسلسَل بيانات المكونات تلقائيًا وتُكتب بشكل موثوق في ملفات حفظ العالم (على سبيل المثال في level.dat) مع الكائن المرتبطة به.
المزامنة الشبكية (Synchronization): توفر المكتبة أدوات جاهزة لإرسال البيانات بأمان من الخادم إلى العميل. وهذا بالغ الأهمية للعرض الصحيح لأشرطة الصحة أو المانا المخصصة على شاشة اللاعب (HUD).
دعم النبضات (Ticking): يمكن للمكونات تحديث منطقها كل نبضة لعب بشكل مستقل عن الكائن. على سبيل المثال، يمكن لمكون "الإشعاع" أن يطرح صحة الكيان من تلقاء نفسه كل ثانية.
معالجة إعادة الإحياء (Respawn Handling): يمكن للمطور أن يحدد بوضوح للنظام ما يجب أن يحدث لبيانات اللاعب بعد موته: نسخها إلى الجسد الجديد (إذا كان مستوى مهارة) أو حذفها بالكامل (إذا كان تعزيزًا مؤقتًا).
الخلاصة
Cardinal Components API هي معيار الصناعة و"القاعدة الذهبية" للتطوير على بنية Fabric. تقدم المكتبة طريقة معيارية ومُحسَّنة إلى أقصى حد لتوسيع الكائنات الأصلية. وهي بالنسبة للمطورين أساس لا غنى عنه عند إنشاء مشاريع RPG أو صناعية معقدة، وبالنسبة للاعبين ضمان للاستقرار. وإذا طلبت اللعبة تحميل هذا المود، فهذا إجراء قياسي لتثبيت النواة التقنية اللازمة.
التثبيت
التثبيت النموذجي يستغرق حوالي 5 دقائق. الخطوات نفسها؛ يختلف فقط المُحمّل والبناء المطابق.
- 1Install a mod loader (Forge, Fabric or NeoForge) that matches your Minecraft version.
- 2Download the mod file (.jar) built for that same version.
- 3Place the .jar into your .minecraft/mods folder.
- 4Launch Minecraft with the modded profile and check the mod loads in-game.
