pack.mcmeta: pack_format 숫자와 "호환되지 않음" 경고
필드 하나만 잘못돼도 Minecraft가 팩을 회색으로 비활성화합니다. 26.x가 요구하는 형식, 하나의 파일로 구버전과 신버전을 모두 지원하는 방법, 그리고 파일이 있어야 할 위치를 정리했습니다.
"내 팩이 호환되지 않는다고 뜬다"는 거의 대부분 작은 파일 하나의 필드 하나 때문입니다.
파일
{
"pack": {
"min_format": 97,
"max_format": 97,
"description": "My pack"
}
}26.3 리소스 팩의 예시이고, 26.3 데이터 팩은 121을 씁니다. 1.21.9부터는 64(리소스) 또는 81(데이터)을 넘는 형식은 반드시 min_format와 max_format로 선언해야 합니다. 대부분의 튜토리얼과 대부분의 생성기가 아직도 보여주는 것처럼 그냥 "pack_format": 97만 적은 팩은 거부되어 호환되지 않음으로 표시됩니다.
파일 이름은 정확히 pack.mcmeta여야 하고, zip의 루트에 있어야 합니다. 즉 assets/이나 data/ 옆이어야 하며, zip 안의 폴더 안에 들어가면 안 됩니다. 내용물 대신 내용물을 담은 폴더를 통째로 압축하는 것이 두 번째로 흔한 실패 원인인데, 겉으로 보기에는 형식 숫자가 틀린 것과 똑같이 보입니다.
리소스 팩과 데이터 팩은 서로 다른 숫자를 씁니다
많은 분들이 여기서 걸립니다. 두 카운터는 몇 년 전에 갈라졌고 서로 호환되지 않습니다. 데이터 팩에 리소스 팩 숫자를 쓰면 그 숫자가 "최신"이더라도 회색으로 비활성화됩니다.
매번 릴리스마다 낡아버리는 표를 외우기보다는, 대상 버전의 바닐라 팩에서 숫자를 읽어오거나 생성기에게 채우게 하세요.
구버전과 신버전을 위한 하나의 파일
숫자 하나로 고정하면 다음 릴리스에서 팩이 깨집니다. 범위를 쓰면 그렇지 않습니다. 다만 26.x까지 닿는 범위는 두 세대의 게임을 동시에 고려해 작성해야 합니다.
{
"pack": {
"pack_format": 46,
"supported_formats": { "min_inclusive": 46, "max_inclusive": 64 },
"min_format": 46,
"max_format": 97,
"description": "My pack"
}
}min_format/max_format는 26.x가 읽는 범위입니다. pack_format와 supported_formats는 1.21.9보다 오래된 클라이언트만을 위한 것입니다. supported_formats는 정확히 64(데이터 팩은 81)에서 끝나야 하고, min_format는 그 하한과 같아야 하며, pack_format는 그 안에 있어야 합니다. 예전에 흔히 하던 조언, 즉 supported_formats를 99 같은 큰 숫자까지 올리는 방식은 이제 26.x가 곧바로 거부하는 유일한 형태입니다. 텍스처나 레시피만 추가하는 팩, 즉 대부분의 팩이라면 넓은 범위가 정직합니다. 버전 사이에 실제로 깨지는 것이 없기 때문입니다.
description은 텍스트 컴포넌트를 받습니다
"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/ 폴더는 해당 형식에서만 사용됩니다. 이렇게 하면 모델 형식이 다른 두 버전을 zip 두 개로 배포하는 대신 다운로드 하나로 지원할 수 있습니다.
빠른 진단
| 증상 | 원인 |
|---|---|
| 회색으로 비활성화, "구버전/신버전용으로 제작됨" | 형식 숫자가 틀림, 또는 (1.21.9 이후) min_format/max_format 없음 |
| 팩이 아예 목록에 없음 | pack.mcmeta가 zip 루트에 없음, 또는 잘못된 JSON |
| 로드는 되는데 텍스처가 없음 | 팩 형식은 정상, 텍스처 경로가 틀림 |
| 싱글플레이에서는 되는데 서버에서는 안 됨 | 데이터 팩이 잘못된 월드 폴더에 있음 |
마지막 쉼표는 잘못된 JSON이며, 오류 메시지가 아니라 "목록에 아예 없음" 상황을 만듭니다.
팩 유형과 대상 버전에 맞는 유효한 파일을 min_format/max_format와, 구버전에 필요한 레거시 필드까지 포함해 pack.mcmeta 생성기로 만들어 보세요.