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

Бедрок-аддон — это zip, и манифест — причина его провала

Большинство отклонённых импортов .mcaddon — это корректный zip с одной неверной строкой заголовка, и сообщение об ошибке никогда не называет сломавшее его поле.

2026-09-17

.mcaddon — это zip-архив с другим расширением, и игра отклоняет его по причинам, никак не связанным с zip. Обычный виновник — manifest.json: небольшой файл с заголовком, два UUID которого должны быть разными, а format_version не соответствует версии игры, на которую вы ориентируетесь.

Два UUID, и никогда одинаковых

Манифест содержит 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 манифеста нет вообще

Именно это разделение сбивает с толку людей, переходящих между изданиями. Ресурспак Java поставляется с pack.mcmeta и целочисленным pack_format. Бедрок поставляется с manifest.json, UUID и списком модулей. Ни один из этих файлов не читается другим изданием, и пак нельзя портировать, просто переименовав архив.

Проверьте перед импортом

Распакуйте архив и посмотрите на верхний уровень. Пак, вложенный на одну папку глубже — MyPack/manifest.json вместо manifest.json — импортируется как пустое место, без ошибки. Манифест должен лежать рядом с содержимым textures/ или behavior_packs/, которое он описывает.

Блочные модели — отдельный формат

JSON блочной модели Java — не файл геометрии Бедрок, и они не взаимозаменяемы:

Оба выражают кубическую сетку из 16 единиц на блок, поэтому сгенерированная модель выглядит правильно в одном и импортируется как пустая фигура в другом.

Имена в реестрах не взаимозаменяемы

Бедрок и Java расходятся в идентификаторах для одного и того же содержимого. Пак, ссылающийся на имя из Java для зачарования, эффекта или биома, загрузится и затем тихо ничего не сделает, потому что имя не соответствует ни одной записи. Сами реестры различаются по размеру между изданиями, поэтому пак, написанный под список одного издания, нельзя считать полным в другом.

Проверьте манифест, проверьте структуру архива и сгенерируйте блочную модель в Bedrock & Pack Tools.

Bedrock & Pack Tools →