pack.mcmeta: номери pack_format і попередження «несумісний»
Одне неправильне ціле число робить ваш пакет неактивним у Minecraft. Ось зіставлення форматів і версій, діапазон supported_formats, який уникає всієї проблеми, та де має лежати файл.
Майже кожне «мій пакет відображається як несумісний» — це одне число в одному маленькому файлі.
Файл
{
"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.
Пакети ресурсів і пакети даних використовують різні номери
Ось на чому часто помиляються: ці два лічильники розійшлися роки тому й не є взаємозамінними. Пакет даних із номером для пакета ресурсів стає сірим, навіть якщо номер «актуальний».
Замість того, щоб запам'ятовувати таблицю, яка застаріває з кожним релізом, подивіться номер у ванільному пакеті потрібної версії — або дозвольте генератору заповнити його.
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" }
] }
Параметр 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.
Швидка діагностика
| Симптом | Причина |
|---|---|
| Сірий, «створено для старішої/новішої версії» | неправильний pack_format |
| Пакет взагалі відсутній у списку | pack.mcmeta not at zip root, or invalid JSON |
| Завантажується, текстури відсутні | формат пакета в нормі; текстурні шляхи неправильні |
| Працює в одиночній грі, але не на сервері | пакет даних у неправильній папці світу |
Зайва кома в кінці є неприпустимою в JSON і спричиняє ситуацію «взагалі відсутній у списку», а не повідомлення про помилку.
Згенеруйте коректний файл для вашого типу пакета та цільової версії — з supported_formats filled in — using the Генератор pack.mcmeta.