نبذة عن الشرح
إنشاء Add-on لـMinecraft Bedrock يربط بين شكل الكائن وسلوكه داخل اللعبة. يوضح هذا الدليل استخدام Blockbench للنموذج والخامة والحركات، ثم bridge. لتنظيم الحزم وربط ملفات العرض والسلوك واختبارها على إصدار Bedrock المقصود.
يفيد الفصل بين Resource Pack وBehavior Pack في تشخيص الأخطاء: قد ينجح استيراد الإضافة بينما لا يظهر النموذج الصحيح، أو يظهر الكائن دون السلوك المطلوب. لذلك نبدأ بكائن بسيط ونختبر جزءًا واحدًا في كل مرة قبل إضافة حركات وتفاعلات كثيرة. المقصود هنا إضافات Bedrock، وهي تختلف عن مودات Java وطريقة تشغيلها.
الموارد المستخدمة
تحتاج الإضافة إلى موارد عرض وملفات سلوك متوافقة. جهّز الأصول وبيئة الاختبار التالية قبل ربط الحزم داخل المشروع.
• Blockbench مع نوع مشروع مناسب لكائن Bedrock، وخامة واضحة وأسماء منظمة لأجزاء النموذج.
• bridge. v2 لإدارة ملفات Resource Pack وBehavior Pack وربط المعرّفات.
• Minecraft Bedrock بإصدار تستهدفه في إعدادات الإضافة، مع عالم اختبار منفصل.
• نموذج وخامات وحركات تملكها أو لديك إذن باستخدامها.
• نسخة احتياطية من المشروع، وإمكانية قراءة Content Log عند ظهور مشكلة في الاستيراد أو التشغيل.
خطوات سريعة
ابنِ الكائن على مراحل من النموذج إلى الحزمة، وافحص كل مرحلة داخل اللعبة. بهذه الطريقة يمكن ربط العطل بآخر تغيير بدل إعادة المشروع كاملًا.
1. صمم النموذج في Blockbench.
اختر مشروع Bedrock Entity، وقسم الجسم إلى أجزاء مناسبة للحركة. اضبط نقاط الارتكاز قبل تحريك الأطراف؛ تصحيحها لاحقًا قد يغير الحركات التي بنيتها عليها.
2. جهّز الخامة والحركات.
لون النموذج ثم جرّب الوقوف والمشي أو الحركة التي تحتاجها. صدّر الملفات بالأسماء التي ستربطها في مشروع الإضافة، واحتفظ بنسخة قابلة للتعديل.
3. أنشئ المشروع في bridge.
حدد إصدار Bedrock المستهدف، ونظم ملفات العرض ضمن Resource Pack وملفات السلوك ضمن Behavior Pack. لا تنقل كل الملفات إلى حزمة واحدة لمجرد أنها تخص الكائن نفسه.
4. اربط المعرّفات.
راجع اسم الكائن ومعرّف النموذج والخامة والحركات في المواضع التي تشير إليها. إذا لم يظهر النموذج، افحص هذه الروابط قبل إعادة تصميمه من الصفر.
5. أضف السلوك بالتدرج.
ابدأ بظهور الكائن وحركة واحدة، ثم جرّب الانتقال إلى بقية الحركات وشروطه. اختبر كل إضافة منفصلة حتى تعرف سبب أي خلل جديد.
6. صدّر واستورد.
صدّر الحزمة المناسبة مثل .mcaddon واستوردها إلى Bedrock، ثم فعّل الحزمتين في عالم اختبار. راجع متطلبات أي تجربة أو API يستخدمها المشروع قبل تفعيلها.
7. شخّص النتيجة.
افحص ظهور الخامة والأطراف والحركة والسلوك، ثم اقرأ Content Log عند التعثر. عدّل خطأ واحدًا واختبر مجددًا قبل توسيع الإضافة.
ملاحظات مهمة
نجاح الاستيراد لا يثبت صحة كل مكوّن. انتبه لاختلاف النسخ وتحديث الحزم وحقوق الأصول عند تجربة الإضافة أو توزيعها.
• لا تنقل ملف Add-on إلى مجلد mods الخاص بـJava؛ النسختان تستخدمان بنيتين مختلفتين للتخصيص.
• لا تحتاج كل حركة إلى Beta APIs أو جميع الميزات التجريبية؛ تفعيلها يتبع المكونات المستخدمة وإصدار اللعبة.
• نجاح شاشة الاستيراد لا يثبت أن كل المعرّفات والحركات تعمل، لذلك افحص الكائن داخل العالم فعلًا.
• حافظ على هوية الحزمة وتنظيم إصدارات المشروع عند تحديثه، واختبر التحديث في عالم منفصل قبل استعماله مع تقدمك الأساسي.
• راجع حقوق النماذج والخامات قبل النشر، ولا تعتبر إمكانية فتح ملف دليلًا على السماح بإعادة توزيعه.


