Puzzles Lib — Minecraft Java Edition 1.21.1

Puzzles Lib هي مكتبة تقنية أساسية لمودات Minecraft، أنشأها المطوّر Fuzs. وهي لا تضيف أي بلوكات أو عناصر أو وحوش أو آليات لعب جديدة إلى عالم اللعبة بشكل مباشر. وظيفتها الرئيسية هي توفير واجهة برمجية مشتركة (API) تتيح للتعديلات الأخرى أن تعمل بنفس الدرجة من الاستقرار على مختلف المُحمِّلات، مع تجريد الكود الخاص بكل من Forge وFabric وNeoForge. يجب تحميل مود Puzzles Lib حصريًا لضمان عمل الإضافات المرتبطة به.

منظومة التعديلات المعتمدة عليها

هذه المكتبة شرط إلزامي لتشغيل أكثر من ثلاثين مشروعًا مختلفًا. وهي تحتوي على كود مشترك لمعالجة الأحداث، وعرض النماذج، ومزامنة البيانات بين العميل والخادم.

أشهر المودات التقنية لـ Minecraft التي تستخدم هذا الإطار:

• تغييرات الواجهات والبلوكات: Easy Magic، Easy Anvils، Visual Workbench. المكتبة مسؤولة عن حفظ العناصر في مخزون هذه البلوكات بعد إغلاقها وعن عرض الغنائم مباشرةً على نسيج البلوك.

• إضافات السحر والتجارة: Enchanting Infuser، Trading Post، Universal Enchants. توفّر Puzzles Lib منطق تفاعل هذه المودات مع مولّد الأرقام العشوائية الأصلي ومع خوارزميات توليد صفقات السكان.

• إضافات جانب العميل: البوصلات والساعات وغيرها من الإضافات المعلوماتية، حيث تتولى الـ API عرض البيانات على الشاشة دون انخفاض في الـ FPS.

إعداد مودات Fuzs

توحيد صيغ الإعدادات هو المهمة الأساسية لهذه المكتبة. فبدلًا من دعم JSON لـ Fabric وTOML لـ Forge، أرسى المطوّر معيارًا موحّدًا.

تُجبر Puzzles Lib جميع المودات المعتمدة عليها على استخدام صيغة .toml. وللمكتبة نفسها أيضًا ملف إعدادات خاص بها باسم puzzleslib-client.toml في مجلد config.

checkIncompatibleMods

enableOptifineWarning

forceResourcePacks

حل مشكلات التشغيل والتعارضات

بما أن Puzzles Lib مكتبة متعددة المنصات، فإن الأخطاء أثناء بناء العميل تحدث كثيرًا. يكشف تحليل السجلات عن ثلاثة أسباب رئيسية لتعطل اللعبة (crash) مرتبطة بهذه المكتبة.

غياب منفذ الإعدادات على Fabric

خطأ يؤدي إلى إغلاق اللعبة فورًا في مرحلة التهيئة. وبما أن Fabric لا يدعم أصلًا نظام إعدادات Forge (صيغة TOML)، فإن Puzzles Lib لا تستطيع قراءة ملفات الإعدادات. ولتصحيح الوضع يجب تحميل المود المساعد Forge Config API Port إلى مجلد mods.

عدم توافق إصدارات المُحمِّل

كثيرًا ما ينسخ اللاعبون ملف .jar الخاص بـ Puzzles Lib لـ Forge إلى بناء على Fabric، أو العكس. تحمل الملفات على منصتي CurseForge وModrinth الوسوم المناسبة (fabric، forge، neoforge في الاسم). تشغيل ملف مخصص لمُحمِّل آخر يؤدي حتمًا إلى خطأ Mod resolution failed أو java.lang.NoClassDefFoundError.

عدم تزامن وسوم الخادم

إذا كانت المكتبة مثبّتة على الخادم لكنها غائبة على العميل (أو كانت الإصدارات مختلفة)، يحصل اللاعب على خطأ Connection closed - mismatched mod channel list عند محاولة الاتصال. تتطلب Puzzles Lib التثبيت على كلا الطرفين بإصدار ملف متطابق.

التوافق

• التبعيات الإلزامية: للعب على Fabric/Quilt، يُعد Fabric API وForge Config API Port ضروريين بشكل حاسم. أما لـ Forge/NeoForge فلا حاجة لتحميل ملفات إضافية — فالأصناف مدمجة في المُحمِّل.

• عدم التوافق: يعمل التكامل مع OptiFine بشكل غير مستقر بسبب تعارضات في خط أنابيب العرض. يوصي المطوّر باستخدام بدائل: Sodium أو Embeddium.

الخلاصة

Puzzles Lib أداة تقنية بحتة تبسّط التطوير وتتيح تحديث قائمة كبيرة من التعديلات على جميع المُحمِّلات الحالية في آنٍ واحد. ومقارنةً بالأطر واسعة النطاق مثل Architectury API، يتسم هذا المود بتركيز ضيق ويخدم حصريًا منظومة مطوّر واحد. ومن حدوده بنية تبعيات مثقلة بعض الشيء للاعبي Fabric، الذين يضطرون لتحميل منافذ إعدادات خارجية. وجود هذا المود إلزامي لكل من يبني حزم تعديلات تقنية أو RPG باستخدام أدوات Fuzs.