Minecraft eklentisi Citizens

🔌 Citizens Hakkında

Citizens, sunucu tarafı NPC'ler oluşturmak ve yönetmek için eksiksiz bir sistem sunan bir Minecraft eklentisidir. Birçok NPC türünü (oyuncu benzeri, moblar, dükkân sahipleri, muhafızlar, heykeller) destekler ve diğer eklentilerin ve özel kodların davranışlar, trait'ler ve entegrasyonlar ekleyebilmesi için bir API sağlar.

🎯 Amaç

Citizens, bir sunucuda kalıcı ve yapılandırılabilir oyuncu olmayan karakterlere duyulan ihtiyacı çözer: NPC'ler etkileşimli dükkân sahipleri, senaryolu karakterler, waypoint'leri takip eden muhafızlar, bilgi kioskları veya dekoratif heykeller olarak kullanılabilir. Eklenti, hem sunucu sahipleri tarafından oynanış özellikleri oluşturmak için hem de geliştiriciler tarafından Citizens API aracılığıyla işlevselliği genişletmek için kullanılır.

⚙️ Özellikler

• Oyun içi komutlarla NPC oluşturup kaldırma.
• Birden fazla NPC türü (oyuncu, mob tabanlı, köylüler vb.).
• NPC'lere komut veya senaryolu eylemler atama (tıkla/çalıştır tetikleyicileri, komut ekleri).
• Hareket eden NPC'ler için waypoint'ler ve devriye davranışı.
• NPC davranışını ve görünümünü özelleştirmek için trait'ler ve düzenleyiciler.
• Şablonlar ve kalıcılık sayesinde NPC'ler yeniden başlatmalardan sonra da kalır.
• Eklentiler, trait'ler ve entegrasyonlar için geliştirici API'si.

🧩 Kimler İçin

• Mağazalar, rehberler veya dekor için etkileşimli NPC'ler isteyen sunucu sahipleri.
• Entegrasyonlar veya mini oyunlar oluşturmak için NPC API'sine ihtiyaç duyan eklenti geliştiricileri.
• Dekoratif veya işlevsel oyuncu olmayan karakterlere ihtiyaç duyan topluluk sunucuları.

🏗️ Örnek Kullanımlar

• Bir Survival sunucusu, ekonomi eklentileri olmadan eşya takası için NPC dükkân sahipleri kullanır.
• Bir RPG sunucusu, görev ve diyalog sağlamak için NPC'leri senaryolaştırır.
• Bir yönetici, kasaba çevresinde waypoint'leri takip eden devriye muhafız NPC'leri yerleştirir.
• Geliştiriciler, mini oyun etkileşimleri için NPC'lere özel trait'ler ekler.

⌨️ Komutlar

(Not: /npc, belirli özellikler için birçok alt komut ve daha ayrıntılı izin düğümü sunar; tam komut seti için eklentinin belgelerine bakın.)

🔐 İzinler

(Belirli komutlar ve trait'ler için çok sayıda ek izin düğümü vardır; eklentinin izin referansı bunları ayrıntılı olarak listeler.)

⚙️ Kurulum

📥 Kurulum

• Projenin resmi dağıtımından (eklentiler kataloğu veya projenin indirmeleri) Citizens resmi JAR dosyasını indirin.
• JAR dosyasını Spigot veya Paper uyumlu bir sunucuda sunucunuzun plugins/ dizinine koyun.
• Sunucuyu yeniden başlatın ve Citizens'in yüklendiğini ve veri dizinlerini oluşturduğunu doğrulamak için konsolu kontrol edin.

📦 Bağımlılıklar

• Varsayılan olarak gerekli harici bağımlılıklar listelenmez. Citizens genellikle isteğe bağlı eklentilerle (üçüncü taraf eklentiler veya başka eklentiler) genişletilir, ancak temel kullanım için hiçbiri zorunlu değildir.

🧠 Teknik Notlar

• Citizens, diğer eklentilerin trait'ler oluşturabilmesi, NPC'lerle etkileşime girebilmesi ve NPC olaylarına bağlanabilmesi için geliştirici odaklı bir API sağlar.
• Eklenti, NPC verilerini kalıcı olarak saklar; böylece NPC'ler yeniden başlatmalardan sonra da kalır ve çalışma anında özelleştirme için trait/düzenleyici desteği sunar.
• Resmi dokümantasyon ve topluluk wiki'si komutları, izinleri, trait'leri, düzenleyicileri ve entegrasyon noktalarını kapsar.

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

Kalıcı, senaryolaştırılabilir NPC'lere ve oyuncu olmayan karakterleri oynanışa veya sunucu sistemlerine entegre etmek için bir API'ye ihtiyacınız varsa, Citizens hem sunucu yöneticileri hem de eklenti geliştiricileri için gereken temel NPC yönetimini, kalıcılığı ve genişletme noktalarını sağlar.