Hướng dẫn / Xây dựng & tài nguyên

Dữ liệu mô hình tùy chỉnh: cho một vật phẩm nhiều mô hình mà không thay thế bất cứ thứ gì

Hệ thống mô hình vật phẩm đã thay thế vị từ CustomModelData cũ. Đây là cách bố trí thư mục, tệp JSON ánh xạ các giá trị sang mô hình, và lý do tại sao texture của bạn hiển thị thành khối lập phương màu tím.

2026-07-11

Mô hình vật phẩm tùy chỉnh cho phép máy chủ phát ra một "cây gậy phép" thực chất là một Cần câu gắn cà rốt với mô hình khác. Cơ chế đã thay đổi, và hầu hết các hướng dẫn vẫn mô tả cách cũ.

Những gì đã thay đổi

Cách cũ — một khối predicate bên trong tệp mô hình của vật phẩm gốc, được đánh khóa theo custom_model_data dưới dạng một số:

{ "predicate": { "custom_model_data": 1 }, "model": "item/wand" }

Cách hiện tại — một định nghĩa items/ chọn một mô hình:

assets/minecraft/items/carrot_on_a_stick.json

{
  "model": {
    "type": "minecraft:range_dispatch",
    "property": "minecraft:custom_model_data",
    "fallback": { "type": "minecraft:model", "model": "minecraft:item/carrot_on_a_stick" },
    "entries": [
      { "threshold": 1, "model": { "type": "minecraft:model", "model": "minecraft:item/wand" } }
    ]
  }
}

fallback là hình dạng mà một Cần câu gắn cà rốt thông thường vẫn trông như vậy. Nếu không có nó, mọi Cần câu gắn cà rốt chưa chỉnh sửa trên thế giới đều hiển thị thành khối lập phương thiếu mô hình màu tím-đen.

Bố cục thư mục

pack.mcmeta
assets/minecraft/
├── items/carrot_on_a_stick.json      the dispatch
├── models/item/wand.json             the model
└── textures/item/wand.png            the texture

models/item/wand.json ở dạng đơn giản nhất:

{ "parent": "minecraft:item/generated", "textures": { "layer0": "minecraft:item/wand" } }

Lưu ý đường dẫn texture không có tiền tố textures/ và không có .png — đó là nguyên nhân phổ biến nhất gây ra khối lập phương màu tím-đen.

Trao vật phẩm

/give @p carrot_on_a_stick[custom_model_data={floats:[1]}]

Component giờ nhận một đối tượng với các danh sách có kiểu, không phải một số nguyên trần. custom_model_data=1 là cú pháp cũ, và lệnh hiện tại từ chối nó vì sai định dạng.

Tại sao nó hiển thị thành khối lập phương màu tím

Theo thứ tự khả năng:

1. Đường dẫn texture sai — bao gồm textures/ hoặc .png, hoặc tệp không nằm ở nơi đường dẫn chỉ đến.
2. Chữ hoa chữ thường trong tên tệp — trò chơi phân biệt chữ hoa chữ thường ngay cả khi hệ điều hành của bạn không phân biệt.
3. pack.mcmeta lỗi thời — 26.x cần min_format và max_format; một số định dạng hiện hành trong một pack_format trần khiến gói hiển thị là không tương thích.
4. Nén zip sai — pack.mcmeta phải nằm ở gốc của tệp zip, không phải bên trong một thư mục trong tệp zip.

Các bộ chọn khác

range_dispatch theo một số chỉ là một tùy chọn. Bạn cũng có thể phân phối theo minecraft:display_context (mô hình khác nhau khi cầm trên tay so với trong khung), minecraft:using_item, hoặc minecraft:selected — đó là cách một Cung hiển thị trạng thái đã kéo dây.

Hãy xây dựng tệp JSON phân phối, tệp mô hình và lệnh trao vật phẩm cùng nhau trong Công cụ Mô hình Tùy chỉnh & Component Vật phẩm.

Công cụ model và component vật phẩm →