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이 채워진)을 생성하세요.