pack.mcmeta: أرقام pack_format وتحذير "غير متوافق"
رقم خاطئ واحد يحوّل حزمتك إلى اللون الرمادي في Minecraft. إليك خريطة التنسيق إلى الإصدار، ونطاق supported_formats الذي يتجنب المشكلة بأكملها، ومكان وجود الملف.
تقريباً كل مشكلة "حزمتي تظهر كغير متوافقة" هي بسبب رقم واحد في ملف صغير واحد.
الملف
{
"pack": {
"pack_format": 46,
"description": "My pack"
}
}يجب أن يكون اسمه بالضبط pack.mcmeta وأن يكون موجوداً في الجذر لملف الـ zip — بجانب assets/ أو data/، وليس داخل مجلد داخل ملف الـ zip. ضغط المجلد المحتوي بدلاً من محتوياته هو ثاني أكثر الأخطاء شيوعاً، ويبدو مطابقاً لرقم تنسيق خاطئ.
حزم الموارد وحزم البيانات تستخدم أرقاماً مختلفة
هذا هو الجزء الذي يربك الناس: لقد تباعد العدادان منذ سنوات وليسا قابلين للتبديل. حزمة بيانات تستخدم رقم حزمة موارد تظهر باللون الرمادي على الرغم من أن الرقم "حديث".
بدلاً من حفظ جدول يصبح قديماً مع كل إصدار، اقرأ الرقم من حزمة فانيلا للإصدار الذي تستهدفه — أو دع مولداً يملأه.
supported_formats هو الحل الحقيقي
تثبيت رقم صحيح واحد يعني أن الحزمة ستتعطل في الإصدار التالي. النطاق لا يفعل ذلك:
{
"pack": {
"pack_format": 46,
"supported_formats": { "min_inclusive": 42, "max_inclusive": 99 },
"description": "My pack"
}
}pack_format يبقى كالتصريح الأساسي؛ supported_formats يوسع ما تقبله اللعبة بدون التحذير. بالنسبة لحزمة تضيف فقط الأنسجة أو الوصفات — وهو حال معظم الحزم — فإن النطاق الواسع صادق، لأنه لا يوجد شيء فيه يتعطل بالفعل بين الإصدارات.
الوصف يقبل مكونات نصية
"description": [
{ "text": "My pack ", "color": "gold" },
{ "text": "v2", "color": "gray", "italic": true }
]رموز علامة القسم (§6) لا تزال تعمل أيضاً، لكن صيغة JSON تبقى سليمة عند النسخ واللصق عبر الأدوات التي تزيل أحرف التحكم.
التراكبات (Overlays)، لدعم عدة إصدارات في وقت واحد
"overlays": { "entries": [
{ "formats": { "min_inclusive": 42, "max_inclusive": 45 }, "directory": "older" }
] }مجلد older/ في جذر الحزمة يستخدم فقط لتلك التنسيقات. هذه هي الطريقة التي يدعم بها تنزيل واحد إصدارين بتنسيقات نماذج مختلفة، بدلاً من شحن ملفي zip.
تشخيص سريع
| العرض | السبب |
|---|---|
| باللون الرمادي، "مصنوع لإصدار أقدم/أحدث" | pack_format خاطئ |
| الحزمة غير مدرجة على الإطلاق | pack.mcmeta ليس في جذر ملف الـ zip، أو JSON غير صالح |
| يتم التحميل، الأنسجة مفقودة | تنسيق الحزمة سليم؛ مسارات الأنسجة خاطئة |
| يعمل في اللعب الفردي، وليس على الخادم | حزمة البيانات في مجلد العالم الخاطئ |
الفاصلة الزائدة هي JSON غير صالح وتنتج حالة "غير مدرجة على الإطلاق"، وليس رسالة خطأ.
قم بإنشاء ملف صالح لنوع حزمتك والإصدار المستهدف — مع ملء supported_formats — باستخدام مولد pack.mcmeta.