Mod Menu لماينكرافت 1.20.1, 1.21.1

قائمة المودات

تتيح لك قائمة المودات عرض المودات المثبتة لديك، وإذا كان المود يدعم ذلك، فإنها توفر وصولاً سريعاً وسهلاً إلى شاشات إعدادات المود.

تدعم قائمة المودات أيضاً بعض الميزات الأكثر تقدماً، مثل أسماء وأوصاف المودات القابلة للترجمة، ودعم تنسيق QuickText في أوصاف المودات بفضل Text Placeholder API من Patbox، وتصفية مودات المكتبات من المودات العادية، وفاحص تحديثات المودات للمودات المستضافة على Modrinth أو التي توفر مصادر تحديث خاصة بها، وإعدادات متعمقة لجميع الميزات التي نوفرها.

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

قائمة المودات متاحة حالياً لـ Fabric أو Quilt على Minecraft: Java Edition 1.14 أو أحدث.

المطورون

تتضمن قائمة المودات عدداً من واجهات API للمطورين لتحسين كيفية ظهور موداتهم في قائمة المودات. تأتي هذه في شكل مفاتيح لغوية، وبيانات وصفية JSON، وحتى Java API.

واجهة API للترجمة

يمكنك ترجمة اسم مودك وملخصه ووصفه كل ذلك دون لمس أي كود Java. ما عليك سوى إضافة مفاتيح الترجمة بالتنسيق المدعوم إلى أي لغة تريدها.

توثيق واجهة API للترجمة

إليك مثال على ترجمات قائمة المودات إلى Pirate Speak. لإنشاء ترجماتك الخاصة، ما عليك سوى استبدال modmenu في نهاية مفتاح الترجمة (وليس الذي في البداية) بمعرّف المود الخاص بك، على سبيل المثال modmenu.descriptionTranslation.traverse.

enpt.json

"modmenu.nameTranslation.modmenu": "Menu o' mods!", "modmenu.descriptionTranslation.modmenu": "Menu o' mods ye installed matey!", "modmenu.summaryTranslation.modmenu": "Menu o' mods ye installed matey!"

ترجمة الملخص زائدة عن الحاجة هنا ولا تحتاج إلى تضمينها لأنها نفس الوصف، لكنها ضُمنت لتوضيح أنه يمكنك ترجمة الملخص (وصف قصير من جملة واحدة للمود) بشكل منفصل عن الوصف، حتى بالإنجليزية!

واجهة API للبيانات الوصفية في Fabric

هناك عدد من الأشياء التي يمكنك إضافتها فقط بالبيانات الوصفية في ملف fabric.mod.json الخاص بك.

كل هذه تُضاف إلى كتلة مخصصة في ملف fabric.mod.json الخاص بك للبيانات الوصفية لقائمة المودات. إليك مثال على استخدام العديد من الميزات التي توفرها واجهة API هذه:

fabric.mod.json

{ ... "custom": { "modmenu": { "links": { "modmenu.discord": "https://discord.gg/jEGF5fb" }, "badges": [ "library", "deprecated" ], "parent": { "id": "example-api", "name": "Example API", "description": "Modular example library", "icon": "assets/example-api-module-v1/parenticon.png", "badges": [ "library" ] }, "updatechecker": true } } }

توثيق واجهة API للبيانات الوصفية في Fabric

الشارات ("badges": [ ])

بينما تُضاف شارة Client تلقائياً إلى المودات المعينة كخاصة بالعميل فقط (عيّن "environment": "client" في fabric.mod.json للقيام بذلك.)، فإن شارات أخرى مثل شارة Library وشارة Deprecated تتطلب تعريفاً هنا.

القيم المدعومة:

• library - يجب تعيينها للمودات التي هي مجرد تبعيات لمودات أخرى ولا ينبغي عرضها للمستخدم افتراضياً إلا إذا فعّلها.
• deprecated - يجب تعيينها للمودات الموجودة لأسباب قديمة فقط، مثل وحدة API قديمة أو ما شابه.

أي قيم أخرى سيتم تجاهلها، ولا تدعم قائمة المودات إضافة شاراتك الخاصة. يمكنك فتح مشكلة هنا إذا كان لديك حالة استخدام مقنعة لشارة جديدة.

الروابط ("links": { })

يتيح كائن الروابط لمؤلفي المودات إضافة روابط تشعبية مخصصة إلى نهاية وصفهم. إذا حددت جهة اتصال sources في البيانات الوصفية الرسمية لـ fabric.mod.json، فسيتم تضمينها أيضاً في قسم الروابط.

أي مفتاح في كائن الروابط سيُضمَّن في قسم الروابط، مع استخدام المفتاح كمفتاح ترجمة. على سبيل المثال، هذا:

fabric.mod.json

"custom": { "modmenu": { "links": { "modmenu.discord": "https://discord.gg/jEGF5fb" } } }

سيظهر كرابط بنص "Discord"، لأن "Discord" هي الترجمة الإنجليزية لـ "modmenu.discord" التي توفرها قائمة المودات.

توفر قائمة المودات عدة ترجمات افتراضية يمكن استخدامها للروابط. يمكن رؤية القائمة الكاملة في ملف اللغة الخاص بقائمة المودات هنا. جميع مفاتيح ترجمة الروابط الافتراضية تأخذ الشكل modmenu..

يمكنك أيضاً تقديم ترجماتك الخاصة إذا أردت إضافة روابط مخصصة. تأكد من استخدام مساحة الأسماء الخاصة بك (بدلاً من modmenu) لأي مفاتيح مخصصة.

الآباء ("parent": "modid" أو { })

يُستخدم الآباء لعرض مود كابن لمود آخر. هذا مخصص للاستخدام مع المودات المقسمة إلى وحدات مختلفة. العنصر التالي في fabric.mod.json سيعرّف المود كابن للمود 'flamingo':

fabric.mod.json

"custom": { "modmenu": { "parent": "flamingo" } }

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

fabric.mod.json

"custom": { "modmenu": { "parent": { "id": "this-mod-isnt-real", "name": "Fake Mod", "description": "Do cool stuff with this fake mod", "icon": "assets/real-mod/fake-mod-icon.png", "badges": [ "library" ] } } }

مودات الأب الزائفة تدعم فقط البيانات الوصفية التالية:

• id (String)
• name (String)
• description (String)
• icon (String)
• badges (Array of Strings)

تعطيل فاحص التحديثات ("updatechecker": false)

افتراضياً، سيستخدم فاحص التحديثات في قائمة المودات تجزئة jar الخاص بمودك للبحث عن أحدث إصدار على Modrinth. إذا وجد مشروعاً مطابقاً، سيتحقق من أحدث إصدار يدعم محمّل المودات وإصدار Minecraft الخاص بك، وإذا كانت له تجزئة مختلفة عن ملفك الحالي، فسيطالب المستخدم بوجود تحديث متاح.

يمكنك تعطيل فاحص التحديثات بتعيين updatechecker إلى false في البيانات الوصفية لقائمة المودات هكذا:

fabric.mod.json

"custom": { "modmenu": { "updatechecker": false } }

واجهة API للبيانات الوصفية في Quilt

بما أن قائمة المودات تدعم Quilt أيضاً، فإن نفس واجهات API في قسم واجهة API للبيانات الوصفية في Fabric متاحة أيضاً لمودات Quilt، لكن تنسيق البيانات الوصفية المخصصة مختلف قليلاً.

بدلاً من كتلة "modmenu" داخل كتلة "custom"، تضع كتلة "modmenu" كعنصر في الكائن الجذري. لذا يجب أن تبدو هكذا:

quilt.mod.json

{ ... "modmenu": { // Here's where your links, badges, etc. stuff goes } }

Java API

لاستخدام Java API، ستحتاج إلى إضافة قائمة المودات كتبعية وقت الترجمة في مشروع gradle الخاص بك. هذا لن يجعل مودك يتطلب قائمة المودات، لكنها ستكون موجودة في بيئتك لتختبر بها.

build.gradle

// Add the Terraformers maven repo to your repositories block repositories { maven { name = "Terraformers" url = "https://maven.terraformersmc.com/" } }

// Add Mod Menu as a dependency in your environment dependencies { // Prior to Minecraft 26.x, use "modImplementation" instead implementation("com.terraformersmc:modmenu:${project.modmenuversion}") }

ثم عرّف إصدار قائمة المودات الذي تستخدمه في ملف gradle.properties. يمكنك الحصول على أحدث رقم إصدار هنا، لكن قد تحتاج إلى إصدار مختلف إذا لم تكن تستخدم أحدث إصدار من Minecraft. راجع صفحة الإصدارات للحصول على قائمة كاملة بالإصدارات.

gradle.properties

modmenuversion=VERSIONNUMBERHERE

إذا كنت لا تريدها في بيئتك للاختبار لكنك ما زلت تريد الترجمة مقابل قائمة المودات لاستخدام Java API، يمكنك استخدام modCompileOnly بدلاً من modImplementation (سيعمل هذا حتى إذا لم تكن قائمة المودات محدثة إلى إصدار Minecraft الذي تشغله).

توثيق Java API

البدء

لاستخدام واجهة API، نفّذ واجهة ModMenuApi على فئة وأضفها كنقطة دخول من النوع "modmenu" في ملف fabric.mod.json الخاص بك هكذا:

fabric.mod.json

"entrypoints": { "modmenu": [ "com.example.mod.ExampleModMenuApiImpl" ] }

شاشات إعدادات المود

يمكن للمودات توفير مصنع Screen لتوفير شاشة إعدادات مخصصة تُفتح بزر الإعدادات. نفّذ طريقة getModConfigScreenFactory في تنفيذ واجهة API الخاصة بك للقيام بذلك.

حالة الاستخدام المقصودة لهذا هي أن توفر المودات شاشات إعداداتها الخاصة. يتم تحديد معرّف المود لشاشة الإعدادات تلقائياً بواسطة حاوية المود المصدر التي نشأت منها نقطة الدخول.

شاشات الإعدادات الموفرة

يمكن للمودات توفير مصانع Screen لتوفير شاشات إعدادات مخصصة تُفتح بأزرار الإعدادات لمودات أخرى أيضاً. نفّذ طريقة getProvidedConfigScreenFactories في تنفيذ واجهة API الخاصة بك للقيام بذلك.

حالة الاستخدام المقصودة لهذا هي أن يوفر مود مثل Cloth Config شاشات إعدادات للمودات التي تستخدم واجهة API الخاصة به.

شارات حزمة المودات

يمكن للمودات منح مودات أخرى شارة Modpack من خلال تنفيذ طريقة attachModpackBadges، مثل من خلال ما يلي:

@Override public void attachModpackBadges(Consumer consumer) { consumer.accept("modmenu"); // Indicates that 'modmenu' is part of the modpack }

لاحظ أن المودات 'الداخلية' مثل Minecraft نفسه ومحمّل المودات لا يمكن منحها شارة حزمة المودات، لأنها لا تُوزَّع ضمن حزمة مودات نموذجية.

طرق المساعدة الثابتة

توفر ModMenuApi أيضاً بعض طرق المساعدة للمودات التي تريد العمل مع قائمة المودات بشكل أفضل، مثل إنشاء أزرار Mods الخاصة بها.

إنشاء نسخة من شاشة Mods

يمكنك استدعاء هذه الطريقة للحصول على نسخة من شاشة Mods:

Screen createModsScreen(Screen previous)

إنشاء نص زر Mods

يمكنك استدعاء هذه الطريقة للحصول على النص الذي سيُعرض على زر Mods في قائمة المودات:

Text createModsButtonText()