Panduan / Bangunan & Sumber Daya

Data model kustom: memberi satu item banyak model tanpa mengganti apa pun

Sistem model item menggantikan predikat CustomModelData yang lama. Berikut adalah tata letak folder, JSON yang memetakan nilai ke model, dan mengapa tekstur Anda tampil sebagai kubus ungu.

2026-07-11

Model item kustom memungkinkan server membagikan "tongkat sihir" yang sebenarnya adalah Wortel di Tongkat dengan model berbeda. Mekanismenya berubah, dan sebagian besar tutorial masih menjelaskan cara yang lama.

Apa yang berubah

Cara lama — blok predicate di dalam file model item dasar, yang dikunci berdasarkan custom_model_data sebagai angka:

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

Cara saat ini — definisi items/ yang memilih sebuah model:

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 adalah tampilan Wortel di Tongkat biasa yang masih belum diubah. Tanpanya, setiap Wortel di Tongkat yang belum dimodifikasi di dunia akan tampil sebagai kubus model-hilang berwarna ungu dan hitam.

Tata letak folder

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 dalam bentuk paling sederhana:

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

Perhatikan bahwa jalur tekstur tidak memiliki awalan textures/ dan tidak memiliki .png — itulah penyebab paling umum dari kubus ungu dan hitam.

Memberikan item

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

Komponen ini sekarang menerima objek dengan daftar bertipe, bukan bilangan bulat biasa. custom_model_data=1 adalah sintaks lama, dan perintah ini sekarang menolaknya sebagai tidak valid.

Mengapa tampil sebagai kubus ungu

Berdasarkan urutan kemungkinan:

1. Jalur tekstur salah — menyertakan textures/ atau .png, atau file tidak berada di tempat yang ditunjukkan jalur.
2. Huruf besar-kecil nama file — game bersifat case-sensitive bahkan ketika OS Anda tidak.
3. pack.mcmeta kedaluwarsa — 26.x menginginkan min_format dan max_format; nomor format yang sudah usang di dalam pack_format polos membuat paket tampil sebagai tidak kompatibel.
4. Cara zip salah — pack.mcmeta harus berada di root zip, bukan di dalam folder di dalam zip.

Selektor lainnya

range_dispatch pada sebuah angka hanyalah salah satu opsi. Anda juga dapat mengirim berdasarkan minecraft:display_context (model berbeda saat di tangan versus di bingkai), minecraft:using_item, atau minecraft:selected — yang merupakan cara Busur menampilkan keadaan tertarik.

Bangun JSON dispatch, file model, dan perintah give secara bersamaan di Custom Model & Item Component Tools.

Alat model dan komponen item →