Panduan
Cara membuat item kustom dengan plugin
Diperbarui 18 Oktober 2026
Pedang, tongkat sihir, kunci, dan alat kustom termasuk fitur plugin yang paling banyak diminta. Plugin tidak bisa menambahkan item yang benar-benar baru ke game, tetapi bisa mengambil item vanilla, memberinya nama, lore, dan tag tersembunyi, lalu bereaksi saat pemain memakainya. Pemain bergabung dengan game biasa, tanpa mod.
Ganti item-itemnya dengan milikmu.
Buat ini dengan CodexeLangkah demi langkah
1.Daftarkan item-itemnya
Untuk setiap item: material dasar, nama tampilan, baris lore, dan fungsinya. "Blaze rod bernama Fire Wand yang menembakkan fireball saat klik kanan, cooldown 5 detik" sudah merupakan item yang lengkap.
2.Beri tag dengan PersistentDataContainer
Simpan id seperti
fire_wanddiPersistentDataContaineritem denganNamespacedKey. Plugin mengenali item dari tag itu, bukan dari namanya, jadi mengganti namanya di anvil tidak membuat salinan.3.Tulis kemampuannya
Setiap kemampuan adalah event listener:
PlayerInteractEventuntuk klik kanan,EntityDamageByEntityEventuntuk serangan,BlockBreakEventuntuk alat. Tambahkan cooldown per pemain dan per item.4.Tentukan cara pemain mendapatkannya
Perintah admin
/give, resep crafting, toko, drop mob, atau hadiah crate.5.Buat semuanya bisa dikonfigurasi
Nama, lore, damage, cooldown, dan resep di
config.yml, agar kamu bisa menyeimbangkan item tanpa build baru.6.Build dan coba setiap item
Biarkan Codexe mengompilasi plugin, bergabunglah ke server uji coba dengan Coba sekarang, berikan setiap item ke dirimu sendiri, dan pakai.
Kenapa tag dan bukan nama
Memeriksa nama tampilan atau lore adalah kesalahan klasik: pemain mana pun yang punya anvil bisa mengganti nama stick menjadi "Fire Wand". PersistentDataContainer (Minecraft 1.14 ke atas) menyimpan data pada item yang tidak bisa diubah pemain, dan tetap ada setelah restart, di dalam peti, dan saat diperdagangkan karena merupakan bagian dari item.
Di 1.8 sampai 1.13 tidak ada PersistentDataContainer; plugin memakai NBT lewat library atau penanda lore tersembunyi. Sebutkan versinya di permintaan dan Codexe menulis pendekatan yang didukung versi itu.
Kemampuan dan event di baliknya
| Kemampuan | Event | Catatan |
|---|---|---|
| Kekuatan klik kanan | PlayerInteractEvent | Periksa tangannya, event terpicu sekali per tangan |
| Damage atau efek tambahan saat menyerang | EntityDamageByEntityEvent | Periksa bahwa penyerangnya adalah pemain yang memegang item |
| Alat tambang area | BlockBreakEvent | Hormati plugin proteksi seperti WorldGuard |
| Efek pasif saat dipegang | Tugas berulang atau PlayerItemHeldEvent | Hapus efeknya saat item disimpan |
| Busur atau proyektil | EntityShootBowEvent, ProjectileHitEvent | Beri tag pada proyektil untuk mengetahui asalnya |
Tekstur dan model
Plugin mengubah apa yang dilakukan item, bukan tampilannya. Tampilan kustom butuh resource pack yang diunduh pemain: di versi lama item membawa angka CustomModelData yang dipetakan pack ke sebuah model, dan sejak 1.21.2 item juga bisa menunjuk modelnya sendiri lewat komponen item_model. Tanpa pack, item terlihat seperti material dasarnya dengan nama kustom, dan itu sudah cukup untuk banyak server.
Contoh deskripsi
"Plugin Paper 1.21.4 bernama MagicItems. Tiga item, masing-masing diberi tag id PersistentDataContainer: Fire Wand (blaze rod, klik kanan menembakkan fireball, cooldown 5 dtk), Frost Blade (pedang besi, serangan memberi Slowness II selama 3 dtk), Miner's Pick (beliung berlian, menghancurkan 3x3 tetapi tidak di region WorldGuard tempat pemain tidak boleh membangun). /mi give <player> <item> untuk magicitems.admin. Resep shaped untuk masing-masing. Nama, lore, cooldown, dan resep di config.yml."
Pertanyaan
Plugin atau mod untuk item kustom?
Plugin, jika pemain harus bergabung dengan game biasa: itemnya adalah item vanilla dengan perilaku baru. Mod, jika kamu butuh item atau blok yang benar-benar baru dengan rendering sendiri, yang kemudian harus dipasang setiap pemain. Lihat plugin vs mod.
Bisakah aku memakai ItemsAdder atau Nexo dengannya?
Plugin-mu bisa bergantung padanya, tetapi keduanya plugin berbayar: server uji coba Codexe tidak bisa memasangnya, jadi plugin yang membutuhkan salah satunya tidak akan aktif di sana. Dependensi gratis yang tercantum di plugin.yml dipasang otomatis di server uji coba.
Apakah item berhenti berfungsi setelah update?
Item yang diberi tag PersistentDataContainer tetap menyimpan tag-nya di setiap update Minecraft. Kemampuannya mungkin perlu di-build ulang untuk API baru; lihat memperbarui plugin.
Buat item kustom-mu
Prompt ini terbuka dan siap dikirim:
“Plugin Paper 1.21.4 bernama MagicItems dengan tiga item yang diberi tag PersistentDataContainer: Fire Wand (blaze rod, klik kanan menembakkan fireball, cooldown 5 detik), Frost Blade (pedang besi, Slowness II selama 3 detik saat menyerang), Miner's Pick (beliung berlian yang menambang 3x3). /mi give untuk magicitems.admin, resep shaped untuk masing-masing, nama, lore, cooldown, dan resep di config.yml.”
Buat ini dengan Codexe