Guides / Troubleshooting

pack.mcmeta: Số pack_format và cảnh báo "không tương thích"

Chỉ một số nguyên sai cũng đủ khiến Minecraft làm mờ gói tài nguyên của bạn. Dưới đây là bảng ánh xạ định dạng với phiên bản, phạm vi supported_formats giúp tránh hoàn toàn vấn đề này, và vị trí chính xác của tệp.

2026-07-08

Hầu hết các trường hợp "gói của tôi hiển thị là không tương thích" đều do một con số sai trong một tệp nhỏ.

Tệp

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

Tệp phải được đặt tên chính xác là pack.mcmeta và nằm ở thư mục gốc của tệp zip — cùng cấp với assets/ hoặc data/, chứ không phải bên trong một thư mục nào đó trong tệp zip. Việc nén cả thư mục chứa thay vì chỉ nén nội dung của nó là lỗi phổ biến thứ hai, và nó trông y hệt như lỗi số định dạng sai.

Gói tài nguyên và gói dữ liệu sử dụng các số khác nhau

Đây là phần khiến nhiều người mắc lỗi: hai bộ đếm này đã phân kỳ từ nhiều năm trước và không thể hoán đổi cho nhau. Một gói dữ liệu sử dụng số của gói tài nguyên sẽ bị làm mờ ngay cả khi số đó là "hiện tại".

Thay vì ghi nhớ một bảng sẽ lỗi thời sau mỗi bản phát hành, hãy đọc số từ một gói gốc (vanilla pack) cho phiên bản bạn đang nhắm đến — hoặc để một công cụ tạo tự động điền vào.

supported_formats là giải pháp thực sự

Việc ghim một số nguyên duy nhất có nghĩa là gói sẽ bị lỗi ở bản phát hành tiếp theo. Một phạm vi thì không:

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

pack_format vẫn là khai báo chính; supported_formats mở rộng những gì trò chơi chấp nhận mà không có cảnh báo. Đối với một gói chỉ thêm kết cấu hoặc công thức — phần lớn các gói — một phạm vi rộng là hợp lý, vì không có gì trong đó thực sự bị hỏng giữa các phiên bản.

Mô tả chấp nhận các thành phần văn bản

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

Các mã dấu phần (§6) vẫn hoạt động, nhưng dạng JSON tồn tại qua việc sao chép-dán qua các công cụ loại bỏ ký tự điều khiển.

Lớp phủ (Overlays), để hỗ trợ nhiều phiên bản cùng lúc

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

Thư mục older/ ở thư mục gốc của gói chỉ được sử dụng cho các định dạng đó. Đây là cách một lần tải xuống duy nhất hỗ trợ hai phiên bản với các định dạng mô hình khác nhau, thay vì phải phát hành hai tệp zip.

Chẩn đoán nhanh

Một dấu phẩy thừa là JSON không hợp lệ và dẫn đến trường hợp "không được liệt kê chút nào", chứ không phải thông báo lỗi.

Tạo một tệp hợp lệ cho loại gói và phiên bản mục tiêu của bạn — với supported_formats đã được điền vào — bằng cách sử dụng Trình tạo pack.mcmeta.

Trình tạo pack.mcmeta →