pack.mcmeta: شماره‌های pack_format و هشدار «ناسازگار»

یک عدد صحیح اشتباه باعث می‌شود Minecraft پک شما را خاکستری کند. در اینجا نگاشت فرمت به نسخه، محدوده supported_formats که از کل مشکل جلوگیری می‌کند و محل قرارگیری فایل آمده است.

2026-07-08

تقریباً هر مشکل «پک من به عنوان ناسازگار نشان داده می‌شود» مربوط به یک عدد در یک فایل کوچک است.

فایل

{
  "pack": {
    "pack_format": 46,
    "description": "My pack"
  }
}

باید دقیقاً نام‌گذاری شود pack.mcmeta and sit at the ریشه فایل zip — در کنار assets/ or data/, not inside a folder inside the zip. Zipping the containing folder instead of its contents is the second most common failure, and it looks identical to a wrong format number.

Resource packها و data packها از شماره‌های متفاوتی استفاده می‌کنند

این همان بخشی است که افراد را به اشتباه می‌اندازد: این دو شمارنده سال‌ها پیش از هم جدا شدند و قابل جایگزینی با یکدیگر نیستند. یک data pack که از شماره resource pack استفاده می‌کند خاکستری می‌شود، حتی اگر آن شماره «به‌روز» باشد.

به جای حفظ کردن جدولی که با هر نسخه قدیمی می‌شود، شماره را از یک پک وانیلا برای نسخه‌ای که هدف قرار داده‌اید بخوانید — یا بگذارید یک تولیدکننده آن را پر کند.

راه حل واقعی supported_formats است

ثابت کردن یک عدد صحیح به این معنی است که پک در نسخه بعدی از کار می‌افتد. یک محدوده این‌طور نیست:

{
  "pack": {
    "pack_format": 46,
    "supported_formats": { "min_inclusive": 42, "max_inclusive": 99 },
    "description": "My pack"
  }
}

pack_format stays as the primary declaration; supported_formats widens what the game accepts without the warning. For a pack that only adds textures or recipes — which is most packs — a wide range is honest, because nothing in it actually breaks between versions.

بخش Description مولفه‌های متنی می‌پذیرد

"description": [
  { "text": "My pack ", "color": "gold" },
  { "text": "v2", "color": "gray", "italic": true }
]

کدهای علامت بخش (§6) also still work, but the JSON form survives copy-paste through tools that strip control characters.

Overlays، برای پشتیبانی از چند نسخه به طور همزمان

"overlays": { "entries": [
  { "formats": { "min_inclusive": 42, "max_inclusive": 45 }, "directory": "older" }
] }

The older/ folder at the pack root is used only on those formats. This is how a single download supports two versions with different model formats, instead of shipping two zips.

تشخیص سریع

یک کاما در انتها JSON نامعتبر است و به جای پیام خطا، حالت «اصلاً در لیست نیست» را ایجاد می‌کند.

تولید یک فایل معتبر برای نوع پک و نسخه هدف شما — با supported_formats filled in — using the تولیدکننده pack.mcmeta.