أدلة / استكشاف الأخطاء وإصلاحها

إضافة Bedrock هي ملف zip، وملف manifest هو سبب فشلها

معظم عمليات استيراد ‎.mcaddon المرفوضة تكون ملف zip صالحًا يحتوي على سطر ترويسة خاطئ واحد، ورسالة الخطأ لا تذكر أبدًا الحقل الذي تسبب في المشكلة.

2026-09-17

ملف .mcaddon هو أرشيف zip بامتداد مختلف، واللعبة ترفضه لأسباب لا علاقة لها بملف zip نفسه. السبب المعتاد هو manifest.json — ملف صغير يحتوي على ترويسة يجب أن يكون فيها معرّفا 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 يحتوي على عدد صحيح pack_format. أما Bedrock فتأتي مع manifest.json يحتوي على معرّفات UUID وقائمة وحدات. لا يقرأ أي من الإصدارين ملف الآخر، ولا يمكن نقل الحزمة بإعادة تسمية الأرشيف.

تحقق قبل الاستيراد

فك ضغط الأرشيف وانظر إلى المستوى الأعلى. الحزمة المتداخلة داخل مجلد واحد — MyPack/manifest.json بدلًا من manifest.json — تُستورد كلا شيء على الإطلاق، دون أي خطأ. يجب أن يكون ملف manifest بجانب محتوى textures/ أو behavior_packs/ الذي يصفه.

نماذج المكعبات صيغة منفصلة

ملف JSON لنموذج مكعب في Java ليس ملف geometry في Bedrock، ولا يمكن تبادلهما:

كلاهما يعبّر عن شبكة مكعبات بواقع 16 وحدة لكل مكعب، ولهذا يبدو النموذج المولّد صحيحًا في أحدهما ويُستورد كشكل فارغ في الآخر.

أسماء السجلات غير قابلة للتبادل

يختلف Bedrock وJava حول المعرّفات الخاصة بالمحتوى نفسه. الحزمة التي تشير إلى اسم Java لتعويذة أو تأثير أو biome ستُحمَّل ثم لا تفعل شيئًا بصمت، لأن الاسم لا يؤدي إلى أي مدخل. كما تختلف السجلات نفسها في الحجم بين الإصدارين، لذا لا يمكن افتراض أن حزمة كُتبت وفق قائمة أحد الإصدارين مكتملة في الإصدار الآخر.

تحقق من ملف manifest، وافحص بنية الأرشيف، وولّد نموذج مكعب في Bedrock & Pack Tools.

Bedrock & Pack Tools →