Guides / Troubleshooting

pack.mcmeta: pack_format 숫자와 "호환되지 않음" 경고

정수 하나만 잘못되어도 마인크래프트에서 팩이 회색으로 표시됩니다. 여기서는 형식-버전 매핑, 문제를 피할 수 있는 supported_formats 범위, 그리고 파일이 어디에 있어야 하는지 설명합니다.

"내 팩이 호환되지 않는다고 표시돼요"라는 문제의 거의 대부분은 작은 파일 하나에 있는 숫자 하나 때문입니다.

파일

{
  "pack": {
    "pack_format": 46,
    "description": "My pack"
  }
}

이 파일은 정확히 pack.mcmeta라는 이름으로 압축 파일의 루트에 있어야 합니다. 즉, assets/ 또는 data/ 옆에 있어야 하며, 압축 파일 안의 폴더 안에 있으면 안 됩니다. 내용물 대신 포함하는 폴더를 압축하는 것이 두 번째로 흔한 실패 원인이며, 잘못된 형식 번호와 동일하게 보입니다.

리소스 팩과 데이터 팩은 다른 숫자를 사용합니다

이것이 사람들을 헷갈리게 하는 부분입니다. 두 카운터는 몇 년 전에 분기되었고 서로 호환되지 않습니다. 리소스 팩 번호를 사용하는 데이터 팩은 해당 번호가 "현재" 번호임에도 불구하고 회색으로 표시됩니다.

매 릴리스마다 변경되는 표를 외우기보다는, 목표로 하는 버전의 바닐라 팩에서 숫자를 읽어오거나 생성기가 채워주도록 하세요.

supported_formats가 진정한 해결책입니다

하나의 정수를 고정하면 다음 릴리스에서 팩이 깨집니다. 범위는 그렇지 않습니다.

{
  "pack": {
    "pack_format": 46,
    "supported_formats": { "min_inclusive": 42, "max_inclusive": 99 },
    "description": "My pack"
  }
}

pack_format는 기본 선언으로 유지됩니다. supported_formats는 경고 없이 게임이 허용하는 범위를 넓힙니다. 대부분의 팩인 텍스처나 레시피만 추가하는 팩의 경우, 버전 간에 실제로 깨지는 것이 없으므로 넓은 범위가 정직합니다.

설명은 텍스트 구성 요소를 사용합니다

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

섹션 기호 코드(§6)도 여전히 작동하지만, JSON 형식은 제어 문자를 제거하는 도구를 통해 복사-붙여넣기해도 살아남습니다.

오버레이(Overlays), 여러 버전을 동시에 지원하기 위해

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

팩 루트의 older/ 폴더는 해당 형식에서만 사용됩니다. 이것은 두 개의 압축 파일을 배포하는 대신, 하나의 다운로드로 다른 모델 형식을 가진 두 가지 버전을 지원하는 방법입니다.

빠른 진단

증상원인
회색으로 표시됨, "이전/새 버전용으로 제작됨"잘못된 pack_format
팩이 전혀 목록에 없음pack.mcmeta가 압축 파일 루트에 없거나, 유효하지 않은 JSON
로드되지만 텍스처가 없음팩 형식은 정상; 텍스처 경로가 잘못됨
싱글플레이어에서는 작동하지만 서버에서는 안 됨잘못된 월드 폴더에 있는 데이터 팩

후행 쉼표는 유효하지 않은 JSON이며, 오류 메시지 대신 "전혀 목록에 없음" 사례를 발생시킵니다.

pack.mcmeta 생성기를 사용하여 팩 유형과 대상 버전에 맞는 유효한 파일(supported_formats이 채워진)을 생성하세요.

pack.mcmeta 생성기 →

More guides

Browse all →

다른 마인크래프트 도구도 찾고 계신가요?

브라우저에서 바로 쓰는 생성기·뷰어·변환기 모음입니다. 전부 무료입니다.