Rehber

Plugin ile özel eşyalar nasıl yapılır

18 Ekim 2026 güncellendi

Özel kılıçlar, asalar, anahtarlar ve aletler en çok istenen plugin özellikleri arasındadır. Bir plugin oyuna gerçekten yeni bir eşya ekleyemez, ama vanilla bir eşyayı alıp ona bir ad, lore ve gizli bir etiket verebilir ve bir oyuncu onu kullandığında tepki verebilir. Oyuncular normal oyunla katılır, mod gerekmez.

Eşyaları kendi eşyalarınla değiştir.

Bunu Codexe ile oluştur

Adım adım

  1. 1.Eşyaları listele

    Her eşya için: temel malzeme, görünen ad, lore satırları ve ne yaptığı. "Sağ tıklayınca ateş topu fırlatan, 5 saniye bekleme süreli, Fire Wand adlı bir blaze çubuğu" eksiksiz bir eşyadır.

  2. 2.Onları PersistentDataContainer ile etiketle

    fire_wand gibi bir kimliği bir NamespacedKey ile eşyanın PersistentDataContainer alanına kaydet. Plugin eşyayı adından değil bu etiketten tanır, böylece örste yeniden adlandırmak bir kopya oluşturmaz.

  3. 3.Yetenekleri yaz

    Her yetenek bir olay dinleyicisidir: sağ tıklamalar için PlayerInteractEvent, vuruşlar için EntityDamageByEntityEvent, aletler için BlockBreakEvent. Oyuncu ve eşya başına bekleme süreleri ekle.

  4. 4.Oyuncuların onları nasıl alacağına karar ver

    Bir yönetici /give komutu, bir crafting tarifi, bir mağaza, mob düşürmeleri veya sandık ödülleri.

  5. 5.Her şeyi yapılandırılabilir yap

    Adlar, lore, hasar, bekleme süreleri ve tarifler config.yml içinde olsun ki eşyaları yeni bir derleme olmadan dengeleyebilesin.

  6. 6.Derle ve her eşyayı dene

    Codexe'in plugin'i derlemesine izin ver, Hemen dene ile test sunucusuna katıl, her eşyayı kendine ver ve kullan.

Neden ad değil de etiket

Görünen adı veya lore'u kontrol etmek klasik hatadır: örsü olan her oyuncu bir çubuğu "Fire Wand" olarak yeniden adlandırabilir. PersistentDataContainer (Minecraft 1.14 ve sonrası) eşyanın üzerinde oyuncuların düzenleyemeyeceği veriler saklar ve eşyanın bir parçası olduğu için yeniden başlatmalardan, sandıklardan ve takaslardan sağ çıkar.

1.8 ile 1.13 arasında PersistentDataContainer yoktur; plugin'ler bir kütüphane üzerinden NBT ya da gizli bir lore işareti kullanır. İstekte sürümü belirt, Codexe o sürümün desteklediği yöntemi yazar.

Yetenekler ve arkalarındaki olaylar

YetenekOlayNotlar
Sağ tık gücüPlayerInteractEventEli kontrol et, her el için bir kez tetiklenir
Vuruşta ek hasar veya efektEntityDamageByEntityEventHasarı verenin eşyayı tutan bir oyuncu olduğunu kontrol et
Alan kazma aletiBlockBreakEventWorldGuard gibi koruma plugin'lerine saygı göster
Elde tutulurken pasif efektTekrarlayan bir görev veya PlayerItemHeldEventEşya bırakıldığında efekti kaldır
Yay veya mermiEntityShootBowEvent, ProjectileHitEventNereden geldiğini bilmek için mermiyi etiketle

Dokular ve modeller

Bir plugin bir eşyanın ne yaptığını değiştirir, nasıl göründüğünü değil. Özel bir görünüm için oyuncuların indirdiği bir kaynak paketi gerekir: eski sürümlerde eşya, paketin bir modele eşlediği bir CustomModelData numarası taşır; 1.21.2'den itibaren bir eşya item_model bileşeniyle kendi modelini de gösterebilir. Paket olmadan eşya, özel adlı temel malzemesi gibi görünür; bu da birçok sunucu için yeterlidir.

Örnek açıklama

"MagicItems adlı bir Paper 1.21.4 plugin'i. Her biri bir PersistentDataContainer kimliğiyle etiketlenmiş üç eşya: Fire Wand (blaze çubuğu, sağ tık ateş topu fırlatır, 5 sn bekleme süresi), Frost Blade (demir kılıç, vuruşlar 3 sn boyunca Yavaşlık II verir), Miner's Pick (elmas kazma, 3x3 kırar ama oyuncunun inşa edemediği WorldGuard bölgelerinde kırmaz). magicitems.admin için /mi give <player> <item>. Her biri için şekilli tarifler. Adlar, lore, bekleme süreleri ve tarifler config.yml içinde."

Sorular

Özel eşyalar için plugin mi, mod mu?

Oyuncular normal oyunla katılacaksa plugin: eşyalar yeni davranışlı vanilla eşyalardır. Kendine özgü görünümü olan gerçekten yeni eşyalara veya bloklara ihtiyacın varsa mod; o zaman her oyuncu onu kurar. Bkz. plugin mi mod mu.

ItemsAdder veya Nexo ile kullanabilir miyim?

Plugin'in onlara bağımlı olabilir, ama bunlar ücretli plugin'lerdir: Codexe test sunucusu onları kuramaz, bu yüzden bunlardan birini gerektiren bir plugin orada etkinleşmez. plugin.yml içinde listelenen ücretsiz bağımlılıklar test sunucusuna senin için kurulur.

Eşyalar bir güncellemeden sonra çalışmayı bırakır mı?

PersistentDataContainer ile etiketlenmiş eşyalar Minecraft güncellemeleri boyunca etiketlerini korur. Yetenekler yeni API için yeniden derleme gerektirebilir; bkz. plugin güncelleme.

Özel eşyalarını yap

Bu prompt göndermeye hazır açılır:

“PersistentDataContainer ile etiketlenmiş üç eşyalı, MagicItems adlı bir Paper 1.21.4 plugin'i: Fire Wand (blaze çubuğu, sağ tık ateş topu fırlatır, 5 saniye bekleme süresi), Frost Blade (demir kılıç, vuruşta 3 saniye Yavaşlık II), Miner's Pick (3x3 kazan elmas kazma). magicitems.admin için /mi give, her biri için şekilli bir tarif, adlar, lore, bekleme süreleri ve tarifler config.yml içinde.”

Bunu Codexe ile oluştur
Minecraft plugin'i ile özel eşyalar nasıl yapılır | Codexe