Opal×Terminus

كيفية إعداد بيئة تطوير Fabric (2026)

إعداد بيئة تطوير تعديل Fabric: تثبيت JDK، استنساخ قالب التعديل النموذجي، واختيار تعيينات Yarn، ثم تشغيل gradle genSources وتشغيل runClient. دليل كامل.

Guidesby trqUpdated June 4, 2026
Key takeaways
  • الإعداد يتكون من أربع خطوات: JDK، قالب وحدة نمطية (mod) مثال، مخططاتك، ثم Gradle.
  • يقوم إضافة Fabric للبناء بتنزيل Minecraft وربط مهام التشغيل لك.
  • أنت لا تقوم بتثبيت Gradle بنفسك: يأتي القالب مع أداة تغليف.
  • عدم تطابق الإصدار في gradle.properties هو السبب الأكثر شيوعًا لفشل مشروع جديد.

إنّ إعداد بيئة تطوير Fabric يتطلب أربع خطوات: تثبيت JDK، والبدء من قالب نموذج التعديل الرسمي، واختيار الـ mappings (عادةً Yarn)، ثم تشغيل مهام Gradle التي تقوم بتنزيل Minecraft وتشغيل عميل اختبار. يتولى المكوّن الإضافي للبناء العمل الشاق. طابق إصدار JDK و Minecraft من البداية وسوف يتبع ذلك الباقي.

أين Opal يناسب

Opal هو تعديل Fabric مع "محرك JavaScript للبرمجة النصية GraalVM"، لذا يمكنك توسيعه باستخدام نصوص برمجية دون الحاجة إلى إعداد سلسلة أدوات تعديل كاملة. إذا كنت ترغب فقط في تثبيته وتشغيله، فاتبع دليل الإعداد؛ للبدء في كتابة النصوص البرمجية، راجع وثائق البرمجة النصية

ما تحتاجه أولاً

تحتاج ثلاثة أشياء قبل كتابة أي كود: Java Development Kit، و IDE، و Git.

  • JDK. تأكد من توافقه مع إصدار Minecraft الذي تستهدفه. الإصدارات الأحدث من Minecraft تتطلب JDK أحدث، لذا تحقق من المتطلبات قبل البدء.
  • IDE. كل من IntelliJ IDEA و Eclipse يعملان. معظم مطوري Fabric يستخدمون IntelliJ لأن تكامل Gradle والمترجم أكثر سلاسة.
  • Git. ستستخدمه لاستنساخ المستودع النمطي وتتبع التغييرات الخاصة بك.

لن تقوم بتثبيت Gradle بنفسك. يأتي المستودع النمطي مع برنامج نصي لـ Gradle wrapper يقوم بتنزيل الإصدار الصحيح في أول تشغيل.

خطوة بخطوة

1

قم بتثبيت JDK

قم بتثبيت JDK يتطابق مع إصدار Minecraft المستهدف، ووجه بيئة التطوير المتكاملة (IDE) الخاصة بك إليه

2

احصل على قالب التعديل النموذجي

نشرت منصة Fabric مستودعًا أوليًا رسميًا. قم باستنساخه أو استخدمه كقالب، ثم غيّر اسم الحزمة ومعرّف المود إلى اسمك الخاص

3

اختر تعييناتك

يستخدم القالب Yarn افتراضيًا. يوفر Yarn أسماءً قابلة للقراءة وموثقة لفئات وطرق Minecraft. قم بتعيين إصدار Minecraft وإصدار المحمل وإصدار تعيينات Yarn في gradle.properties

4

أنشئ المصادر وشغّل

افتح المشروع في بيئة التطوير المتكاملة لديك، ثم اترك Gradle يقوم بمزامنة الملفات، ثم قم بتشغيل genSources لفك تجميع Minecraft مقابل أسماء Yarn. شغّل المهمة runClient لإطلاق عميل تطوير مع مودك المحمّل

ما الذي يفعله إضافة البناء لك

تقوم إضافة Gradle للبناء لـ Fabric بتنزيل Minecraft، وإعادة تعيينه إلى التعيينات التي اخترتها، وربط إعدادات التشغيل. يمكنك تهيئتها من خلال كتلة صغيرة في build.gradle.

أنت تحددأينما الذي يتحكم فيه
إصدار Minecraftgradle.propertiesإصدار اللعبة الذي تقوم بتجميعه ضده
إصدار المحملgradle.propertiesمحمل Fabric الذي يعمل عليه تعديلك
إصدار Yarngradle.propertiesأسماء التعيينات المستخدمة في التعليمات البرمجية المصدر الخاصة بك
التبعياتbuild.gradleFabric API وأي مكتبات

حافظ على اتساق الإصدارات الثلاثة في gradle.properties. يعد عدم التطابق بين إصدار Minecraft وإصدار تعيينات Yarn هو السبب الأكثر شيوعًا لفشل مشروع جديد في المزامنة.

لماذا التعيينات مهمة هنا

يتم شحن Minecraft مشفرًا، لذا فإن فئاته تحمل أسماءً مثل a.a.a. يقوم Yarn بتعيين هذه الأسماء إلى أسماء قابلة للقراءة ويقع فوق الطبقة الوسيطة المستقرة. عند تشغيل genSources، تقوم إضافة البناء بإلغاء تجميع اللعبة باستخدام أسماء Yarn حتى تتمكن من قراءة التعليمات البرمجية الخاصة بـ Minecraft والإشارة إليها مباشرةً. عند تجميع تعديلك، فإنه يعيد تعيين التعليمات البرمجية الخاصة بك التي تحمل أسماء Yarn إلى وسيط حتى يعمل ملف jar النهائي على أي تثبيت مطابق بغض النظر عن إعادة تسمية التعيينات.

عندما لا يتم بناء المشروع

  • يفشل مزامنة Gradle مباشرة بعد الاستيراد: عادةً ما تكون إصدارات Minecraft و Loader و Yarn في ملف gradle.properties غير متطابقة. اضبطها على مجموعة متطابقة معروفة.
  • إصدار Java غير صحيح: يتذمر البناء بشأن إصدار ملف فئة غير مدعوم عندما يكون JDK الخاص بك أقدم من الإصدار المطلوب لـ Minecraft. قم بتثبيت JDK أحدث وأشر المشروع إليه.
  • لا توجد مصادر مُفكّكة للقراءة: قم بتشغيل genSources وأعد التحميل. تستغرق التشغيل الأول بعض الوقت لأنه يقوم بإلغاء تجميع اللعبة بأكملها.
  • runClient لا يفعل شيئًا: اترك المزامنة الأولية لـ Gradle تنتهي قبل تشغيل أي مهمة. يتم إنشاء تكوينات التشغيل أثناء المزامنة.

الأسئلة الشائعة

احصل على Opal، عميل Fabric، مقابل $8.99