Руководства / Устранение неполадок

pack.mcmeta: номера pack_format и предупреждение «несовместимо»

Одна неверная цифра — и Minecraft сделает ваш пак серым. Здесь вы найдете соответствие форматов и версий, диапазон supported_formats, который решает проблему, и местоположение файла.

2026-07-08

Почти всегда причина, по которой «мой пак отображается как несовместимый», кроется в одной цифре в одном маленьком файле.

Файл

{
  "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 принимает текстовые компоненты

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

Коды символов раздела (§6) также все еще работают, но форма JSON выдерживает копирование-вставку через инструменты, которые удаляют управляющие символы.

Оверлеи для поддержки нескольких версий одновременно

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

Папка older/ в корне пака используется только для этих форматов. Таким образом, одна загрузка поддерживает две версии с разными форматами моделей, вместо того чтобы поставлять два ZIP-архива.

Быстрая диагностика

Запятая в конце является неверным JSON и приводит к случаю «вообще не отображается», а не к сообщению об ошибке.

Сгенерируйте действительный файл для вашего типа пака и целевой версии — с заполненным supported_formats — используя pack.mcmeta Generator.

Генератор pack.mcmeta →