가이드 / 문제 해결

Bedrock 애드온은 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는 32자리 16진수를 다섯 개의 하이픈 그룹으로 표기한 128비트 값입니다. 어떤 생성기를 써도 괜찮지만, 중복은 안 됩니다. version와 min_engine_version는 문자열이 아니라 정수 세 개짜리 배열입니다. "1.0.0"는 일부 빌드에서 조용히 실패합니다.

Java에는 매니페스트가 아예 없다

이것이 에디션을 오가며 작업하는 사람들이 자주 걸리는 부분입니다. Java 리소스 팩은 pack_format 정수를 담은 pack.mcmeta를 함께 넣습니다. Bedrock은 UUID와 모듈 목록이 담긴 manifest.json를 넣습니다. 어느 파일도 다른 에디션에서 읽히지 않으며, 압축 파일 이름을 바꾼다고 팩이 이식되지도 않습니다.

가져오기 전에 확인하라

압축을 풀고 최상위를 살펴보세요. 한 단계 폴더 안에 중첩된 팩, 즉 manifest.json 대신 MyPack/manifest.json인 경우에는 오류도 없이 아무것도 가져오지 못합니다. 매니페스트는 그것이 설명하는 textures/ 또는 behavior_packs/ 콘텐츠와 같은 위치에 있어야 합니다.

블록 모델은 별개의 형식이다

Java 블록 모델 JSON은 Bedrock 지오메트리 파일이 아니며, 둘은 호환되지 않습니다:

둘 다 블록당 16단위의 큐브 그리드를 표현합니다. 그래서 생성된 모델이 한쪽에서는 제대로 보이지만 다른 쪽에서는 빈 도형으로 가져와지는 것입니다.

레지스트리 이름은 호환되지 않는다

Bedrock과 Java는 같은 콘텐츠에 대해 서로 다른 식별자를 사용합니다. 마법 부여, 효과, 생물 군계에 Java 이름을 참조하는 팩은 로드된 뒤 아무 일도 하지 않습니다. 그 이름이 어떤 항목으로도 해석되지 않기 때문입니다. 레지스트리 자체도 에디션마다 크기가 다르므로, 한 에디션의 목록을 기준으로 만든 팩이 다른 에디션에서 완전하다고 가정할 수 없습니다.

매니페스트를 검증하고, 압축 파일 구조를 확인하고, Bedrock & Pack Tools에서 블록 모델을 생성하세요.

Bedrock & Pack Tools →