Cloth Config API — مود لشاشات الإعدادات في Minecraft
Cloth Config API هي مكتبة تتطلبها عشرات التعديلات في Minecraft لعرض إعداداتها على هيئة قائمة داخل اللعبة بدلاً من ملف نصي. وهي بحد ذاتها لا…
Cloth Config API هي مكتبة تتطلبها عشرات التعديلات في Minecraft لعرض إعداداتها على هيئة قائمة داخل اللعبة بدلاً من ملف نصي. وهي بحد ذاتها لا تضيف شيئاً إلى اللعبة: لا أغراضاً ولا كتلاً ولا آليات جديدة. إنها اعتمادية — فبدونها لن تعمل المودات التي ربطتها بنفسها وستُظهر خطأً في…
Cloth Config API — مود لشاشات الإعدادات في Minecraft
إصدار Minecraft الذي يستند إليه الاستعراض: 1.21.3
نطاق الإصدارات المدعومة: 1.14.x – 26.1.2
إصدار المود الذي كُتبت عنه المقالة: 17.0.144
Cloth Config API هي مكتبة تتطلبها عشرات التعديلات في Minecraft لعرض إعداداتها على هيئة قائمة داخل اللعبة بدلاً من ملف نصي. وهي بحد ذاتها لا تضيف شيئاً إلى اللعبة: لا أغراضاً ولا كتلاً ولا آليات جديدة. إنها اعتمادية — فبدونها لن تعمل المودات التي ربطتها بنفسها وستُظهر خطأً في قائمة التعديلات.
متى يُحتاج إلى المود
لا تُثبَّت المكتبة بمفردها، بل مع تعديلات أخرى. ويمكن معرفة ما إذا كانت لازمة لحزمة معينة بطريقتين:
في وصف المود على Modrinth أو CurseForge، يُذكر Cloth Config API ضمن قائمة Dependencies.
تُغلَق اللعبة عند تشغيل الحزمة، ويظهر في السجل (
logs/latest.log) ذكرٌ لغيابcloth-configأوcloth-config-2.
الاسم الداخلي cloth-config-2 يخص المود نفسه — وهو المعرّف الذي ظهر بدءاً من الإصدار الرئيسي الثاني للمكتبة. فإذا كتب أحدهم «مطلوب cloth-config-2»، فالمقصود هو الإصدار الحديث من Cloth Config API.
يجب أن يطابق إصدار المكتبة إصدار اللعبة تماماً. فإذا وُضع Cloth Config الخاص بـ 1.21.4 في حزمة على 1.21.5، فإما أنه لن يسمح للعبة بالعمل، أو سيتجاهل ببساطة المودات التي تعتمد عليه. وهذه حالة شائعة عندما تُظهر الحزمة خطأ «mod requires cloth-config».
كيفية فتح إعدادات المود
على Forge وNeoForge تكون قائمة التعديلات المثبتة مدمجة في القائمة الرئيسية للعبة — عنصر Mods. وبجانب كل مود ربط Cloth Config تظهر أيقونة إعدادات. والنقر عليها يفتح شاشة منفصلة بكل معاملات هذا التعديل تحديداً.
على Fabric لا توجد قائمة قياسية للمودات في المُحمِّل، لذا يتحقق الوصول إلى شاشات Cloth Config عبر أداة خارجية لعرض التعديلات — فهي تُظهر قائمة المثبَّت وتتيح النقر على الزر بجانب العنصر المطلوب.
إعدادات المود بمساعدة Cloth Config
كيف تبدو الشاشة نفسها
جميع شاشات المود مبنية وفق المخطط ذاته: على اليسار — فئات المعاملات، في الوسط — المعاملات نفسها، في الأسفل — زرّا الحفظ والإلغاء. ويُعرَض كل معامل بعنصر واجهة يتوافق مع نوع قيمته.
في الجزء العلوي من الشاشة، للإعدادات ذات العشرات من المعاملات، يوجد حقل بحث — فهو يرشّح القائمة حسب الاسم. وبجوار المعاملات التي حدّد لها مؤلف التعديل وصفاً، يظهر عند تمرير المؤشر تلميحٌ بالشرح.
إذا أُدخلت قيمة خارج النطاق المسموح به أو بصيغة غير مقبولة، يُضاء الحقل، ويصبح زر الحفظ غير فعّال حتى يُصحَّح الخطأ. وبجانب كل معامل يوجد زر إعادة ضبط — يعيد القيمة إلى ما حدّده مؤلف التعديل كقيمة قياسية.
الخلاصة
Cloth Config API هي اعتمادية بنيوية: فبدونها لن يعمل جزء من التعديلات ببساطة، لكن المود نفسه لا يقدّم في اللعبة شيئاً مرئياً بدون مودات أخرى مرتبطة. ودوره هو جمع إعدادات مختلف التعديلات في Minecraft ضمن معيار بصري مشترك بدلاً من عشرات الواجهات المتباينة. وعلى Fabric وفي الحزم متعددة المنصات يبقى Cloth Config API المعيار المشترك الأكثر انتشاراً.
التثبيت
التثبيت النموذجي يستغرق حوالي 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.
