Cara Membuat Custom Item di Minecraft Bedrock (Add-on)

Di panduan ini kita membuat item Kristal Fajar (kv:kristal_fajar): item baru dengan tekstur sendiri, nama dalam bahasa Indonesia, dan resep crafting. Setelah itu kita kembangkan menjadi makanan dan senjata.

Pastikan kamu sudah punya pasangan Behavior Pack (BP) dan Resource Pack (RP) dengan manifest.json yang benar, dan sudah membaca perbedaan BP dan RP.

Struktur file

KV_BP/
├── manifest.json
├── items/kristal_fajar.json
└── recipes/kristal_fajar.json
KV_RP/
├── manifest.json
├── textures/item_texture.json
├── textures/items/kristal_fajar.png
└── texts/
    ├── en_US.lang
    ├── id_ID.lang
    └── languages.json

1. Definisi item (Behavior Pack)

KV_BP/items/kristal_fajar.json:

{
  "format_version": "1.21.0",
  "minecraft:item": {
    "description": {
      "identifier": "kv:kristal_fajar",
      "menu_category": {
        "category": "items"
      }
    },
    "components": {
      "minecraft:icon": "kv_kristal_fajar",
      "minecraft:max_stack_size": 16,
      "minecraft:glint": true,
      "minecraft:rarity": "rare"
    }
  }
}

• identifier adalah ID item. Gunakan namespace milikmu sendiri.
• menu_category menentukan tab di Creative inventory (construction, nature, equipment, items, atau none untuk menyembunyikan).
• minecraft:icon merujuk ke nama tekstur pendek yang didaftarkan di Resource Pack (langkah berikutnya), bukan ke path file.
• minecraft:glint memberi efek berkilau seperti item ber-enchant.

2. Tekstur (Resource Pack)

Buat gambar PNG berukuran 16×16 piksel dengan latar transparan, lalu simpan sebagai KV_RP/textures/items/kristal_fajar.png. Gambar sendiri dengan aplikasi seperti Blockbench, Aseprite, atau editor piksel lain. Jangan memakai gambar milik orang lain tanpa izin.

Daftarkan tekstur di KV_RP/textures/item_texture.json:

{
  "resource_pack_name": "kv",
  "texture_name": "atlas.items",
  "texture_data": {
    "kv_kristal_fajar": {
      "textures": "textures/items/kristal_fajar"
    }
  }
}

Nama kunci kv_kristal_fajar harus sama dengan nilai minecraft:icon di file item. Path tekstur ditulis tanpa ekstensi .png.

3. Nama tampilan

Tanpa file bahasa, item akan tampil sebagai item.kv:kristal_fajar.name. Tambahkan baris berikut:

KV_RP/texts/en_US.lang:

item.kv:kristal_fajar.name=Dawn Crystal

KV_RP/texts/id_ID.lang:

item.kv:kristal_fajar.name=Kristal Fajar

KV_RP/texts/languages.json:

["en_US", "id_ID"]

Cara lain yang lebih singkat adalah menambahkan komponen "minecraft:display_name": { "value": "Kristal Fajar" } di file item, tetapi file .lang lebih baik jika pemainmu memakai bahasa berbeda.

4. Resep crafting

KV_BP/recipes/kristal_fajar.json:

{
  "format_version": "1.20.10",
  "minecraft:recipe_shaped": {
    "description": {
      "identifier": "kv:kristal_fajar_resep"
    },
    "tags": ["crafting_table"],
    "pattern": [
      " A ",
      "ADA",
      " A "
    ],
    "key": {
      "A": { "item": "minecraft:amethyst_shard" },
      "D": { "item": "minecraft:diamond" }
    },
    "unlock": [
      { "item": "minecraft:amethyst_shard" }
    ],
    "result": {
      "item": "kv:kristal_fajar",
      "count": 1
    }
  }
}

Untuk resep tanpa pola, gunakan minecraft:recipe_shapeless dengan daftar ingredients. Untuk furnace, gunakan minecraft:recipe_furnace dengan "tags": ["furnace"].

5. Uji coba

1. Letakkan kedua pack di folder development_behavior_packs dan development_resource_packs.
2. Buat dunia baru, aktifkan BP (RP ikut aktif lewat dependency).
3. Masuk ke dunia dan jalankan /give @s kv:kristal_fajar.

Jika item tampil sebagai kotak ungu-hitam, berarti tekstur tidak ditemukan. Periksa kembali nama di minecraft:icon, kunci di item_texture.json, dan path gambar.

6. Membuat item bisa dimakan

Tambahkan komponen berikut ke bagian components:

"minecraft:food": {
  "nutrition": 6,
  "saturation_modifier": 0.6,
  "can_always_eat": true
},
"minecraft:use_modifiers": {
  "use_duration": 1.6,
  "movement_modifier": 0.35
},
"minecraft:use_animation": "eat"

use_duration adalah lama memakan dalam detik.

7. Membuat item menjadi senjata

"minecraft:damage": 9,
"minecraft:hand_equipped": true,
"minecraft:durability": {
  "max_durability": 500
},
"minecraft:enchantable": {
  "slot": "sword",
  "value": 14
}

hand_equipped membuat item dipegang tegak seperti pedang. Kemampuan khusus, misalnya memberi efek saat memukul, bisa ditambahkan dengan Script API (event world.afterEvents.entityHitEntity).

Kesalahan yang sering terjadi

• Item tidak muncul di /give: BP belum aktif, identifier salah ketik, atau file JSON rusak. Cek Content Log.
• Tekstur ungu-hitam: nama tekstur tidak cocok atau path salah.
• Nama aneh seperti item.kv:…name: file .lang belum ada atau salah nama kunci.
• Komponen tidak berpengaruh: beberapa komponen butuh format_version yang lebih baru. Naikkan format_version file item sesuai versi game-mu.

Selanjutnya, coba membuat custom mob.