LibJF — مكتبة تقنية ونواة لدعم التعديلات الخارجية في Minecraft

LibJF — مكتبة تقنية ونواة لدعم التعديلات الخارجية في Minecraft

مكتبة LibJF هي مكتبة معيارية من المطور JFronny، تحتوي على مجموعة من المكونات المشتركة لتعديلاته الخاصة. على جهاز كمبيوتر اللاعب، لا يتم تثبيت هذا التعديل عادةً بمفرده، ولكن كتابعية إلزامية — بدونه لن تبدأ التعديلات المعنية. لا يضيف LibJF وصفات أو وحوش أو كتل جديدة إلى Minecraft. مهمته مختلفة: استخراج الوظائف المتكررة — تنسيق التكوين، نظام الترجمة، خادم HTTP المحلي، اثنتان من علامات الأدوات المساعدة — في مشروع منفصل وإعادة استخدامه عبر التعديلات المختلفة لنفس المطور.

الغرض في حزمة التعديلات (Modpack)

تنقسم المكتبة إلى وحدات منفصلة، كل منها مسؤولة عن مهمتها الخاصة: تنسيق ملفات التكوين وقائمتها داخل اللعبة، وعلامات العناصر، والترجمة، ومكونات الشبكة. التعديلات التي تعتمد على LibJF تقوم فقط بتحميل الوحدات التي تستخدمها بالفعل. لذلك، بعد بدء اللعبة لأول مرة، لن يظهر ملف واحد فقط في مجلد config/، ولكن عدة ملفات (ملف واحد لكل وحدة نشطة).

أحد التأثيرات الأساسية التي سيلاحظها اللاعب على الفور هو إعادة التحميل التلقائي للتكوينات. المعلمة watchForChanges ممكّنة افتراضيًا: إذا قمت بتغيير أي ملف تكوين يعمل من خلال LibJF، فسيتم تطبيق التغييرات دون إعادة تشغيل اللعبة.

علامات عالمية للعناصر والدروع

يضيف LibJF علامتين متاحتين لكل من التعديلات الأخرى وحزم البيانات (datapacks) العادية:

العلامات نفسها فارغة — يتم ملؤها بواسطة حزمة بيانات أو تعديل خارجي. لجعل مجموعة جلدية كاملة "غير قابلة للاختراق" في وضع البقاء على قيد الحياة (survival)، على سبيل المثال، يكفي إنشاء حزمة بيانات صغيرة تضيف minecraft:leather_helmet, minecraft:leather_chestplate, minecraft:leather_leggings و minecraft:leather_boots إلى ملف العلامة libjf:overpowered.

النظام الفرعي للترجمة

توفر الوحدة libjf-translate-v1 لتعديلات المطور الأخرى وصولاً إلى خدمة ترجمة السلاسل النصية. المكتبة نفسها لا تترجم أي شيء في الدردشة أو الواجهة — إنها تحدد فقط الخدمة الخارجية التي ستمر عبرها الطلبات إذا قام تعديل المستهلك باستدعائها. يتم دعم أربعة خيارات من المزودين:

• Google — الواجهة العامة لترجمة جوجل (القيمة الافتراضية).

• DeepLX — تنفيذ مفتوح لواجهة برمجة تطبيقات DeepL.

• LibreTranslate — حل مفتوح المصدر مستضاف ذاتيًا؛ يتطلب تحديد عنوان المثيل بشكل منفصل.

• Noop — جزء إضافي يعيد النص المُدخل دون تغيير؛ مفيد للاختبارات ولتعطيل الترجمة تمامًا.

تحدد المعلمة المنفصلة throttleMillis الحد الأدنى للتوقف المؤقت بين مكالمات الخدمة. هذا التقييد ضروري لتجنب الحظر المؤقت من واجهة برمجة التطبيقات المجانية عند تكرار الطلبات من تعديل المستهلك.

خادم الويب المحلي

تطلق الوحدة libjf-web-v1 خادم HTTP صغيرًا داخل اللعبة. يتم استخدامه بواسطة تعديلات المؤلف الأخرى عندما يكون من الضروري منح العميل أكثر من مجرد حزمة شبكة عادية (على سبيل المثال، صفحة ثابتة أو ملف معاينة). في بيئة اللاعب القياسية، عادة ما تكون هذه الوحدة صامتة: المنفذ مفتوح فقط محليًا (127.0.0.1)، ومشاركة الملفات معطلة.

يمكن لمسؤولي الخوادم الخاصة تمكين مشاركة الملفات العشوائية من مجلد config/wwwroot كموارد ثابتة من خلال معلمة تكوين منفصلة — هذه ميزة اختيارية، غير مفعلة بشكل افتراضي.

الخاتمة

تعد LibJF مكتبة تبعية مطلوبة عندما تحتوي حزمة تعديلات على تعديل من نفس المطور أو حزمة بيانات تستخدم العلامات libjf:overpowered أو libjf:shulker_boxes_illegal. مقابل المكتبات الأخرى من هذه الفئة، تتميز ببنية معيارية ووجود خادم HTTP محلي مع طبقة ترجمة، وهو ما لا تقدمه معظم المكتبات المساعدة. بالنسبة لحزمة تعديلات Minecraft Java Edition العادية، لا معنى لتثبيت LibJF؛ أما بالنسبة لحزم التعديلات التي تحتوي على تعديلات JFronny، فهو مكون إلزامي.