fabric

واجهة برمجة التطبيقات للنسيج

خطافات أساسية للتعديل مع القماش.

Fabric API هي مكتبة للخطافات الأساسية وآليات التشغيل البيني لتعديلات Fabric. تشمل الأمثلة ما يلي:

• الكشف عن وظيفة مفيدة ولكن يصعب الوصول إليها للعديد من التعديلات مثل الجسيمات والمناطق الأحيائية والأبعاد
• إضافة أحداث وخطافات وواجهات برمجة التطبيقات لتحسين إمكانية التشغيل البيني بين التعديلات.
• الميزات الأساسية مثل مزامنة التسجيل وإضافة المعلومات إلى تقارير الأعطال.
• واجهة برمجة تطبيقات عرض متقدمة مصممة للتوافق مع تعديلات التحسين وتعديلات إصلاح الرسومات.

تحقق أيضًا من Fabric Loader، وهو مُحمل تعديل مستقل عن الإصدار (في الغالب) يعمل على تشغيل Fabric. Fabric API عبارة عن تعديل مثل أي تعديل آخر للنسيج يتطلب تثبيت Fabric Loader.

للحصول على الدعم والمناقشة لكل من المطورين والمستخدمين، قم بزيارة خادم Fabric Discord.

استخدام Fabric API للعب مع التعديلات

تأكد من أنك قمت بتثبيت محمل النسيج أولاً. يمكن العثور على مزيد من المعلومات حول تثبيت أداة تحميل النسيج هنا.

لاستخدام Fabric API، قم بتنزيله من CurseForge أو GitHub Releases أو Modrinth.

يجب وضع ملف jar الذي تم تنزيله في مجلد mods الخاص بك.

استخدام Fabric API لتطوير التعديلات

لإعداد بيئة تطوير Fabric، راجع نموذج نموذج Fabric واتبع التعليمات الموجودة هناك. يعتمد نموذج التعديل بالفعل على Fabric API.

لتضمين واجهة برمجة تطبيقات Fabric الكاملة مع جميع الوحدات النمطية في بيئة التطوير، قم بإضافة ما يلي إلى كتلة dependencies الخاصة بك في البرنامج النصي للبناء:

رائع DSL

modImplementation " net.fabricmc.fabric-api:fabric-api:FABRIC_API_VERSION "

كوتلين دي إس إل

modImplementation( " net.fabricmc.fabric-api:fabric-api:FABRIC_API_VERSION " )

وبدلاً من ذلك، يمكن تحديد الوحدات النمطية من Fabric API بشكل فردي كما هو موضح أدناه (بما في ذلك الوحدة النمطية jar إلى mod jar الخاص بك):

رائع DSL

 // Make a collection of all api modules we wish to use
Set< String > apiModules = [
    " fabric-api-base " ,
    " fabric-command-api-v1 " ,
    " fabric-lifecycle-events-v1 " ,
    " fabric-networking-api-v1 "
]

// Add each module as a dependency
apiModules . forEach {
    include(modImplementation(fabricApi . module(it, FABRIC_API_VERSION )))
}

كوتلين دي إس إل

 // Make a set of all api modules we wish to use
setOf (
    " fabric-api-base " ,
    " fabric-command-api-v1 " ,
    " fabric-lifecycle-events-v1 " ,
    " fabric-networking-api-v1 "
).forEach {
    // Add each module as a dependency
    modImplementation(fabricApi.module(it, FABRIC_API_VERSION ))
}

بدلاً من ثوابت الإصدار ذات الترميز الثابت في جميع أنحاء البرنامج النصي للإنشاء، يمكن استخدام خصائص Gradle لاستبدال هذه الثوابت. يتم تعريف الخصائص في ملف gradle.properties في جذر المشروع. مزيد من المعلومات متاحة هنا.

المساهمة

هل ترى شيئًا لا يدعمه Fabric API، أو خطأ أو شيء قد يكون مفيدًا؟ نحن نرحب بالمساهمات لتحسين Fabric API. تأكد من قراءة إرشادات التطوير.

وحدات

تم تصميم Fabric API ليكون معياريًا لسهولة التحديث. يتمتع هذا أيضًا بميزة تقسيم قاعدة التعليمات البرمجية إلى أجزاء أصغر.

تحتوي كل وحدة على README.md خاص بها * يشرح غرض الوحدة ومعلومات إضافية حول استخدام الوحدة.

* جاري العمل على الملف التمهيدي لكل وحدة؛ لا تحتوي كل وحدة على ملف README في الوقت الحالي