Руководства / Устранение неполадок
Бедрок-аддон — это zip, и манифест — причина его провала
Большинство отклонённых импортов .mcaddon — это корректный zip с одной неверной строкой заголовка, и сообщение об ошибке никогда не называет сломавшее его поле.
.mcaddon — это zip-архив с другим расширением, и игра отклоняет его по причинам, никак не связанным с zip. Обычный виновник — manifest.json: небольшой файл с UUID заголовка и 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 манифеста нет вообще
Именно это различие сбивает с толку людей, переходящих между editions. Ресурспак Java поставляется с pack.mcmeta, объявляющим поддерживаемые форматы (min_format и max_format в текущих версиях). Бедрок поставляется с manifest.json с UUID и списком модулей. Ни один из этих файлов не читается другим edition, и пак нельзя портировать, просто переименовав архив.
Проверьте перед импортом
Распакуйте архив и посмотрите на верхний уровень. Пак, вложенный на одну папку глубже — MyPack/manifest.json вместо manifest.json — импортируется как ничто, без ошибки. Манифест должен лежать в корне каждого пака, рядом с папками, которые он описывает.
Блочные модели — отдельный формат
JSON блочной модели Java — не файл геометрии Бедрок, и они не взаимозаменяемы. Модель Java обычно представляет собой просто parent плюс карту textures — список elements из кубоидов нужен только для нестандартной формы — тогда как Бедрок описывает формы в собственном формате minecraft:geometry. Оба измеряют 16 единиц на блок, поэтому модель может выглядеть правильно в одном edition и импортироваться как ничто в другом.
Имена в реестрах не взаимозаменяемы
Бедрок и Java расходятся в идентификаторах для одного и того же контента. Пак, ссылающийся на имя Java для зачарования, эффекта или биома, загрузится и затем тихо ничего не сделает, потому что имя не соответствует ни одной записи. Сами реестры различаются по размеру между editions, поэтому пак, созданный по списку одного edition, нельзя считать полным в другом.
Проверьте манифест, проверьте структуру архива и сгенерируйте блочную модель в Bedrock & Pack Tools.