Minecraft eklentisi ItemJoin

🔌 ItemJoin Hakkında

ItemJoin, oyunculara son derece yapılandırılabilir özel eşyaları otomatik olarak vermek için kullanılan bir Minecraft eklentisidir. Eşyalar join, first-join, respawn, world-switch, region-enter ve region-leave gibi etkinliklerde verilebilir. Eklenti; esnek eşya tanımları (itemflags), tetikleyici etkinlikler ve eşyaya bağlı komutlara odaklanır, böylece sunucular özel istemci modları olmadan lobi menüleri, başlangıç kitleri veya bağlama duyarlı araçlar sunabilir.

🎯 Amaç

ItemJoin, oyunculara sunucu etkinliklerine ve dünyalara bağlı özel veya etkileşimli eşyaları güvenilir şekilde verme sorununu çözer. Hub/lobi sunucuları, minigame sunucuları, eşyaların dünya bazında sınırlandırılması gereken survival ağları ve eşya tabanlı menülere ya da komut çalıştıran eşyalara ihtiyaç duyan ağlar için kullanışlıdır.

⚙️ Özellikler

• Join, first-join, respawn, world-switch, region-enter/exit ve benzeri etkinliklerde yapılandırılabilir tetikleyicilerle eşya verin.
• Davranışı değiştiren eşya başına itemflags (slot, overwrite, stack kuralları, hareket/toplama engeli, gamemode sınırları, alma şansı, cooldown).
• ItemCommands: komutları eşyalara bağlayın ve yürütme bağlamını (console, player, server, message) ile eylem türlerini (sol/sağ tık, envanter tıklaması, fiziksel, çoklu tıklama) yapılandırın.
• Dinamik eşya adları/lore için PlaceholderAPI entegrasyonu ve placeholder desteği.
• Özel oyuncu kafaları (özel doku ve sahip), harita görüntüleri, tipped arrows, kitaplar, bayraklar, havai fişekler, deri zırh özelleştirme ve özel enchant seviyeleri desteği.
• Belirli dünyalarda eşya hareketini veya toplamasını isteğe bağlı olarak engelleyin ve eşyaları IP adresine veya first-join durumuna göre kısıtlayın.
• Eşya setleri oluşturmak için oyun içi GUI oluşturucu ve yerleşik içe aktarma/oluşturma iş akışı.
• Diğer eklentiler için API: me.RockinChaos.itemjoin.api.ItemJoinAPI altında kullanılabilir.

🧩 Kimler için

• Otomatik lobi/hub eşyalarına veya başlangıç kitlerine ihtiyaç duyan sunucu sahipleri.
• Dünya bazlı eşyalara veya menü pusulalarına ihtiyaç duyan minigame ve ağ operatörleri.
• API üzerinden kancalanabilir bir eşya sistemi isteyen geliştiriciler.

🏗️ Örnek kullanım alanları

• Oyunculara girişte tıklanınca farklı komutlar çalıştıran bir menü pusulası vermek.
• Belirli dünyalar arasında eşya aktarımını engellerken first-join için tek kullanımlık başlangıç kitleri sağlamak.
• Cooldown ve maliyetlerle ekonomi/mağaza komutları çalıştıran etkileşimli eşyalar oluşturmak.

⌨️ Komutlar

Not: Bu komutlar ve alt komutlar, eklentinin belgelenmiş komut setinden alınmıştır. Eklenti, wiki'sinde ve oluşturulan yardım çıktısında ek alt komutlar sunar.

🔐 İzinler

Eşyaya özel izin davranışı yapılandırılabilir; eşya izin kontrolleri varsayılan olarak devre dışıdır ve etkili olması için eklenti yapılandırmasında etkinleştirilmelidir.

⚙️ Kurulum

📥 Kurulum

• Resmî ItemJoin jar dosyasını indirin ve sunucunuzun plugins/ klasörüne yerleştirin.
• plugins/ içinde yinelenen ItemJoin jar dosyası olmadığından emin olun (ör. ItemJoin(1).jar).
• Eklentinin yapılandırmasını oluşturması ve sunucu sürümünüz için özellikleri kaydetmesi için sunucuyu yeniden başlatın.
• Eklentinin yüklendiğini doğrulamak için sunucu konsol kayıtlarını kontrol edin ve ayrıntılı kurulum için eklenti wiki'sine bakın.

📦 Bağımlılıklar

Eklentinin zorunlu çalışma zamanı gereksinimi yoktur, ancak birkaç yaygın soft-dependency ve entegrasyon listeler (bunlar isteğe bağlıdır ve mevcut olduklarında etkinleşir):

• Vault
• AuthMe
• BetterNick
• HeadDatabase
• PlaceholderAPI
• SkinRestorerX
• TokenEnchant
• WorldEdit
• WorldGuard

Gerektikçe entegrasyonları etkinleştirin veya yapılandırın; eklenti bunlar olmadan da çalışır, ancak placeholder'lar, özel kafa/skin ve ekonomi hook'ları gibi özellikler ilgili eklentilere dayanır.

🧠 Teknik Notlar

• Platformlar: Spigot tarzı sunucular için doğrulanmıştır (Spigot, Bukkit, Paper, Purpur, Folia).
• Desteklenen/test edilen Minecraft aralığı: 1.8 ile 1.21 arası.
• Kaynak kodu ve sürümler yayınlanmıştır ve proje, diğer eklentilerin bağlanabilmesi için me.RockinChaos.itemjoin.api.ItemJoinAPI altında bir API sunar.
• Lisans: LGPL-3.0.

🤝 Bu Eklenti Ne Zaman Kullanışlıdır

Oyunculara bağlama duyarlı ve etkileşimli eşyalar (menüler, başlangıç kitleri, dünyaya özel araçlar) sağlamak için esnek ve yapılandırılabilir bir sisteme ihtiyacınız varsa ve entegrasyonlar için bir API istiyorsanız, ItemJoin yaygın placeholder ve skin eklentilerini destekleyerek bu özellikleri sunar.