أدلة / استكشاف الأخطاء وإصلاحها
إضافة Bedrock هي ملف zip، وملف manifest هو سبب فشلها
معظم عمليات استيراد ملفات .mcaddon المرفوضة هي ملفات zip صالحة تحتوي على سطر ترويسة خاطئ واحد، ورسالة الخطأ لا تذكر أبدًا الحقل الذي تسبب في المشكلة.
ملف .mcaddon هو أرشيف zip بامتداد مختلف، وترفضه اللعبة لأسباب لا علاقة لها بملف zip نفسه. السبب المعتاد هو manifest.json — ملف صغير يحتوي على UUID للترويسة وUUID للوحدة يجب أن يكونا مختلفين، بالإضافة إلى format_version لا يطابق إصدار اللعبة الذي تستهدفه.
معرّفان UUID، لا يتطابقان أبدًا
يحمل ملف manifest حقل header ومصفوفة modules. يحتاج كل منهما إلى uuid خاص به، وإعادة استخدام معرّف واحد في كليهما هي السبب الأكثر شيوعًا للرفض:
{
"format_version": 2,
"header": {
"name": "My Pack",
"description": "Example",
"uuid": "aaaaaaaa-0000-0000-0000-000000000000",
"version": [1, 0, 0],
"min_engine_version": [1, 21, 0]
},
"modules": [
{
"type": "data",
"uuid": "bbbbbbbb-0000-0000-0000-000000000001",
"version": [1, 0, 0]
}
]
}معرّفات UUID هي قيم 128-بت تُكتب كـ 32 رقمًا سداسيًا عشريًا في خمس مجموعات مفصولة بشرطات. أي مولّد معرّفات يفي بالغرض؛ لكن التكرار لا. حقلَا version وmin_engine_version هما مصفوفتان من ثلاثة أعداد صحيحة، وليسا نصوصًا — لذلك يُرفض "1.0.0".
Java لا تحتوي على manifest إطلاقًا
هذا هو الفرق الذي يربك من ينتقلون بين الإصدارين. حزمة موارد Java تأتي مع pack.mcmeta يعلن عن الصيغ التي يدعمها (min_format و max_format في الإصدارات الحالية). أما Bedrock فتأتي مع manifest.json يحتوي على معرّفات UUID وقائمة وحدات. لا يقرأ أي من الإصدارين ملف الآخر، ولا يمكن نقل حزمة بإعادة تسمية الأرشيف.
تحقق قبل الاستيراد
فك ضغط الأرشيف وانظر إلى المستوى الأعلى. الحزمة المتداخلة داخل مجلد واحد — MyPack/manifest.json بدلًا من manifest.json — تُستورد كلا شيء على الإطلاق، دون أي خطأ. يجب أن يكون ملف manifest في جذر كل حزمة، بجانب المجلدات التي يصفها.
نماذج الكتل صيغة منفصلة
ملف JSON لنموذج كتلة Java ليس ملف geometry خاصًا بـ Bedrock، ولا يمكن التبادل بينهما. نموذج Java عادةً ما يكون مجرد parent بالإضافة إلى خريطة textures — ولا تكون قائمة elements من المجسمات الصندوقية مطلوبة إلا لشكل مخصص — بينما تصف Bedrock الأشكال بصيغة minecraft:geometry الخاصة بها. كلا الصيغتين تقيسان 16 وحدة لكل كتلة، ولهذا قد يبدو النموذج صحيحًا في أحد الإصدارين ويُستورد كلا شيء في الآخر.
أسماء السجلات غير قابلة للتبادل
تختلف Bedrock وJava في المعرّفات الخاصة بالمحتوى نفسه. الحزمة التي تشير إلى اسم Java لتعويذة أو تأثير أو منطقة حيوية ستُحمَّل ثم لا تفعل شيئًا بصمت، لأن الاسم لا يحل إلى أي مدخل. كما تختلف السجلات نفسها في الحجم بين الإصدارين، لذا لا يمكن افتراض أن حزمة كُتبت وفق قائمة أحد الإصدارين مكتملة في الإصدار الآخر.
تحقق من صحة ملف manifest، وافحص تخطيط الأرشيف، وأنشئ نموذج كتلة في Bedrock & Pack Tools.