JamLib — مكتبة تقنية لتشغيل مودات Minecraft الأخرى

JamLib — مكتبة تقنية لتشغيل مودات Minecraft الأخرى

JamLib هو مود مكتبة لـ Minecraft لا يضيف بذاته أي عناصر أو كتل أو مخلوقات أو هياكل إلى اللعبة. إنه غلاف مساعد يمنح مؤلفي المودات الأخرى ما يلي: تجريد منصة بين اللوادر، ونظام ملفات إعدادات جاهزًا، وكاشفًا لملفات jar المعاد تعبئتها. من دون هذه المكتبة، لن تعمل المودات التي تتطلبها ببساطة.

ما الذي يفعله المود

تحل المكتبة ثلاث مهام للمطور في آنٍ واحد:

• تجريدات منصة قائمة على Architectury — نفس الكود يعمل على Fabric وForge وNeoForge وQuilt دون فروع منفصلة.

• واجهة برمجية للإعدادات بصيغة JSON5 مع شاشة إعدادات تلقائية داخل اللعبة.

• التحقق من ملف jar الخاص بالمود بحثًا عن علامات إعادة التعبئة من «مرايا» القرصنة.

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

إعدادات JSON5

لا يسمح JSON القياسي بالتعليقات داخل الكود. أما JSON5، الذي تتعامل معه المكتبة عبر الاعتمادية Jankson، فيسمح بذلك. عمليًا، هذا يعني أن ملفات إعدادات المودات المبنية على JamLib تبدو مثل .json5 وتحتوي بالفعل على تعليقات تصف كل معامل مع قيمته الافتراضية مباشرة فوقه.

تحافظ الملفات على تعديلات المستخدم عند إعادة الكتابة: إذا أضفت ملاحظتك الخاصة في سطر يبدأ بـ //، فستبقى في مكانها بعد الحفظ التالي للإعدادات. لا تستطيع مكتبات JSON القياسية فعل ذلك.

تُولَّد شاشات الإعدادات بشكل منفصل. على Fabric وQuilt، تُلتقط الواجهة عبر قائمة المودات القياسية، وعلى Forge وNeoForge عبر واجهة برمجية مدمجة لشاشات الإعدادات في اللودر. لا يحتاج مؤلفو المودات إلى كتابة واجهة رسومية يدويًا: يأخذ JamLib الحقول من فئة الإعدادات ويبني لها عناصر تحكم مع التحقق من الصحة — نطاق الأرقام، تعبير نمطي للنصوص، تحذيرات حول ضرورة إعادة تشغيل اللعبة.

كاشف المودات المعاد تعبئتها

هناك ميزة منفصلة تتحقق مما إذا كان ملف .jar للمود المثبَّت قد تم تنزيله من مصدر رسمي. تعيد بعض المواقع تعبئة المودات بأسمائها الخاصة، وتضيف أحيانًا برامج من طرف ثالث. يقارن JamLib الاسم الفعلي للملف بحقل JamLib-File-Name الموجود في بيانه (manifest). إذا لم يتطابقا، يظهر تحذير في الدردشة بعد تحميل العالم. تظهر الرسالة مرة واحدة لكل ملف مشبوه، وبعدها يُحفظ اسم هذا الملف .jar.

لا ينطبق التحقق إلا على المودات التي أضاف مؤلفوها عمدًا حقل JamLib-File-Name إلى بيانها (أي مودات من نفس المطور أو ممن دمجوا هذه الميزة يدويًا). لا تفحص المكتبة كل ملف .jar في مجلد mods بحثًا عن الفيروسات أو الأكواد الضارة — فهي ليست برنامج مكافحة فيروسات.

الخلاصة

يحرر JamLib مطور المود من كتابة نظام إعدادات وتجريد منصة يدويًا لأربعة لوادر في آنٍ واحد. لا معنى لتثبيت JamLib إلا مع مود تابع يتطلبه. إذا لم تحتوِ الحزمة على أي مود من JamCoreModding أو من مؤلف طرف ثالث مبني على هذه المكتبة، فسيبقى ملف .jar الخاص بـ JamLib في مجلد mods دون دور فعّال.