Citizens Eklentisi ile NPC Nasıl Oluşturulur?

Citizens eklentisi ile NPC oluşturmak, Minecraft sunucusunda yaptığınız en görünür işlerden biridir: spawn noktasında duran, oyuncuya bakan, tıklanınca ışınlayan ya da mağaza açan karakterler tam olarak bununla yapılır. İşin özeti şudur — Citizens jar dosyasını plugins klasörüne atar, sunucuyu yeniden başlatır, oyuna girip NPC’nin durmasını istediğiniz yere geçer ve /npc create Bekci yazarsınız. O anda ayağınızın dibinde sizin skininizi taşıyan bir NPC belirir.

NPC (non-player character, yani oyuncu olmayan karakter) sunucunuza iki şey katar: yönlendirme ve atmosfer. Yeni giren oyuncu sohbete yazılan uzun kuralları okumaz, ama spawn’da duran bir bekçiye tıklayıp menüyü açar. Bu yüzden Citizens, survival’dan skyblock’a kadar hemen her sunucunun kurduğu ilk beş eklenti arasındadır ve 2026 sunucu eklenti listesinde kendine yer bulur.

Bu rehberde Citizens’ı 26.2 “Chaos Cubed” sunucusuna kurmayı, ilk NPC’nizi oluşturmayı, ona skin ve isim vermeyi, tıklanınca komut çalıştıracak hâle getirmeyi ve yüzlerce NPC’li bir sunucuda performansı korumayı adım adım göreceksiniz. Eklenti kurmanın genel mantığını hiç görmediyseniz önce Minecraft sunucusuna plugin kurulumu sayfasına göz atmanız işinizi kolaylaştırır.

Citizens Nedir ve Neyi Farklı Yapar?#

Citizens, Bukkit/Spigot/Paper tabanlı sunucularda yapay karakterler oluşturmanızı sağlayan bir eklentidir. Oluşturduğunuz NPC gerçek bir entity’dir: dünyada kalıcıdır, çarpışma kutusu vardır, sunucu yeniden başlasa bile yerinde durur. Bu yönüyle komut bloklarıyla ya da armor stand hilesiyle yapılan taklit karakterlerden ayrılır.

Citizens’ın ikinci güçlü yanı trait (özellik) mimarisidir. Bir NPC’ye eklediğiniz her yetenek — bakma, konuşma, komut çalıştırma, yürüme — ayrı bir trait olarak tutulur. Bu yüzden başka eklentiler Citizens’ın üzerine yeni trait’ler ekleyerek NPC’lerinize mağaza, görev veya banka işlevi kazandırabilir. Citizens’ı kurmak, aslında bu ekosistemin kapısını açmak demektir.

Sürüm Uyumluluğu: 26.2 İçin Hangi Citizens?#

Minecraft 26.1 “Tiny Takeover” ile Mojang obfuscated sunucu jar’ı yayınlamayı bıraktı. Bu sadece bir sürüm atlaması değil, bir ABI kırılmasıdır: 1.21.11 ve öncesi için derlenmiş, NMS (net.minecraft.server — sunucunun iç sınıfları) kullanan hiçbir eklenti yeniden derlenmeden 26.1 ve sonrasında çalışmaz. Citizens tam olarak bu tarz bir eklentidir; NPC’leri motorun iç yapılarına dokunarak oluşturur.

İndirmeniz Gerekenler#

Citizens Kurulumu Adım Adım#

1. Sunucu yazılımını ve Java sürümünü doğrulayın#

   Citizens Paper, Purpur ve Spigot üzerinde çalışır; vanilla server.jar üzerinde çalışmaz. 26.2 sunucusu Java 25 ister; konsolda java -version yazarak yüklü sürümü doğrulayabilirsiniz.

2. Jar dosyasını plugins klasörüne kopyalayın#

   İndirdiğiniz Citizens-2.0.43.jar dosyasını sunucu kök dizinindeki plugins klasörüne atın. Panel kullanıyorsanız web panelden plugin yükleme adımlarını izleyin; FTP ile yüklüyorsanız aktarımın binary modda bittiğinden emin olun.

3. Sunucuyu tamamen yeniden başlatın#

   Konsola stop yazıp sunucuyu kapatın ve yeniden açın. /reload kullanmayın — NMS’e dokunan eklentilerde reload sık sık yarım yüklenmiş sınıflar bırakır ve tuhaf hatalara yol açar.

4. Yüklendiğini doğrulayın#

   Konsolda ya da oyun içinde /plugins yazın. Listede Citizens yeşil renkte görünmeli. Kırmızıysa konsolun başlangıç kayıtlarına dönüp hatayı okuyun.

   [Server thread/INFO]: [Citizens] Enabling Citizens v2.0.43
   [Server thread/INFO]: [Citizens] Loaded 0 NPCs.

Bu noktada plugins/Citizens/ klasörü oluşmuştur. İçinde iki dosya sizi ilgilendirir: genel ayarların bulunduğu config.yml ve oluşturduğunuz tüm NPC’lerin saklandığı saves.yml. İkincisi sunucunuzun NPC veritabanıdır; düzenli yedekleme planınıza mutlaka dahil edin.

İlk NPC’nizi Oluşturma#

Oyuna girin, OP yetkiniz olduğundan emin olun ve NPC’nin durmasını istediğiniz yere geçin. NPC tam olarak sizin durduğunuz koordinatta ve sizin baktığınız yöne dönük olarak doğar.

/npc create Bekci

Bu kadar. Ayağınızın dibinde sizin skininizi taşıyan bir karakter belirir ve otomatik olarak “seçili” duruma geçer. Seçili olması önemlidir: bundan sonra yazacağınız her /npc komutu bu NPC’ye uygulanır.

Komutun tam sözdizimi şu bayrakları kabul eder: -b bebek boyutunda oluşturur, -u oluşturur ama spawn etmez, -s sessiz oluşturur (sohbete mesaj basmaz), -t geçici NPC yapar, -c NPC’yi bloğun merkezine hizalar, -p paket tabanlı NPC oluşturur. Ayrıca --at [x,y,z,world] ile başka bir koordinatta, --type [type] ile başka bir varlık türünde NPC üretebilirsiniz.

/npc create Koylu --type VILLAGER
/npc create Bebek_Zombi --type ZOMBIE -b
/npc create Kule_Bekcisi --at 128,72,-340,world -c
/npc create Gizli --nameplate false

NPC Seçme, Yeniden Adlandırma ve Silme#

Bir NPC üzerinde çalışmadan önce onu seçmeniz gerekir. En kolay yolu NPC’ye sol tıklamaktır; komutla yapmak isterseniz kimlik numarası veya ismiyle seçersiniz.

/npc select 3
/npc select Bekci
/npc select --range 10
/npc rename &6Bekci
/npc remove

/npc rename komutunda & ile başlayan renk kodları çalışır: &6 altın sarısı, &a açık yeşil, &c kırmızı, &l kalın yazı. /npc remove yalnızca seçili NPC’yi siler ve bu işlem geri alınamaz — yanlış NPC’yi silmemek için önce ismini kontrol edin.

Görünüm: Skin, Bakış ve Poz#

Varsayılan olarak NPC sizin skininizi alır. Başka bir görünüm istiyorsanız oyuncu adı vererek skini değiştirirsiniz.

/npc skin Notch
/npc lookclose --range 5

/npc skin komutu Mojang’ın skin servisinden ilgili hesabın derisini çeker; bu yüzden var olan bir Minecraft hesabının adını vermeniz gerekir. Sunucunuz çevrimdışı (cracked) modda çalışsa bile skin çekme işlemi internet bağlantısı ister.

/npc lookclose ise NPC’yi canlandıran ayardır: yakınından geçen oyuncuya kafasını çevirir. --range 5 değeri, kaç blok mesafedeki oyuncuya bakacağını belirler. Küçük değerler hem daha doğal görünür hem de daha az işlem yükü getirir; spawn meydanında 4-6 blok fazlasıyla yeterlidir.

NPC’yi Etkileşimli Yapma: Komut Atama#

Citizens’ın en çok kullanılan özelliği budur. NPC’ye tıklayan oyuncu adına bir komut çalıştırırsınız; böylece ışınlanma noktası, menü açıcı veya bilgi panosu elde edersiniz.

/npc select Bekci
/npc command add spawn

Bu iki satırdan sonra NPC’ye tıklayan her oyuncu /spawn komutunu çalıştırmış olur. Komutu başına eğik çizgi koymadan yazdığınıza dikkat edin. Aynı NPC’ye birden fazla komut ekleyebilirsiniz; hepsi tıklama anında sırayla işlenir.

Sık kullanılan üç senaryo şöyle kurulur:

Ekonomiye bağlı bir tüccar NPC’si kuracaksanız, bakiyenin eklentiler arasında paylaşılabilmesi için köprü katmanına ihtiyacınız olur. Bunun nasıl kurulduğunu Vault ve PlaceholderAPI sayfasında bulabilirsiniz.

Yetkilendirme: Kim NPC Oluşturabilsin?#

Citizens komutları varsayılan olarak OP’lere açıktır. Ancak inşaat ekibinize OP vermek istemezsiniz — doğru yöntem izin düğümlerini bir izin eklentisiyle dağıtmaktır. Aşağıdaki örnek, builder grubuna yalnızca NPC oluşturma ve düzenleme hakkı verir.

groups:
  builder:
    permissions:
      - citizens.npc.create
      - citizens.npc.select
      - citizens.npc.rename
      - citizens.npc.skin
      - citizens.npc.lookclose

Grup ve izin yönetimini hiç kurmadıysanız LuckPerms ile yetki sistemi kurma rehberi bu dosyanın nasıl oluşturulduğunu adım adım anlatır. citizens.npc.remove iznini yalnızca yönetici grubunda bırakın; silinen NPC geri gelmez.

Performans ve Donanım: Kaç NPC Fazla?#

NPC’ler gerçek entity oldukları için sunucunun ana tick döngüsünde işlenirler ve Minecraft’ın ana döngüsü tek çekirdekte çalışır. Bu yüzden NPC yükünü karşılayan şey çekirdek sayısı değil işlemcinin saat hızıdır. Batihost’un Minecraft sunucu paketleri bu nedenle Ryzen 9 7900X / 7950X sınıfı yüksek frekanslı işlemciler ve NVMe SSD üzerine kuruludur.

Sayı büyüdükçe uygulayabileceğiniz üç somut önlem var: dekoratif NPC’lerde lookclose özelliğini kapatmak, yoğun bölgelerde -p bayrağıyla paket tabanlı NPC kullanmak ve NPC’leri tek bir hub dünyasında toplayıp diğer dünyaları temiz tutmak. TPS’in nereye gittiğini ölçmek için spark ile performans analizi yapmanız, tahminle uğraşmaktan çok daha hızlı sonuç verir.

Sık Karşılaşılan Sorunlar#

NPC oluşturuluyor ama hemen kayboluyor#

Genellikle chunk yükleme sorunudur. NPC’nin bulunduğu chunk oyuncu yokken boşaltılırsa NPC de dünyadan kalkar, oyuncu geldiğinde geri gelir. Kalıcı görünmesini istiyorsanız NPC’yi spawn chunk’ları içinde tutun ya da o bölgeyi yüklü kalacak biçimde işaretleyin.

Konsolda NoSuchMethodError düşüyor#

Bu, Citizens sürümünüzün sunucu sürümünüzle eşleşmediğinin klasik işaretidir. 26.2 sunucusunda 1.21.11 için derlenmiş jar bu hatayı verir. Çözüm tek: doğru yapıyı indirin ve eski jar’ı klasörden tamamen silin — yeniden adlandırmak yetmez, Bukkit klasördeki tüm jar’ları tarar.

Skin komutu “skin bulunamadı” diyor#

Verdiğiniz oyuncu adı Mojang tarafında yoksa ya da sunucunun dış dünyaya HTTPS çıkışı engellenmişse skin çekilemez. Güvenlik duvarında giden bağlantıları kısıtladıysanız Mojang oturum sunucularına erişimi açın.

NPC’ye tıklıyorum, komut çalışmıyor#

Üç şeyi kontrol edin: komutu /npc command add ile doğru NPC’ye eklediniz mi (yanlış NPC seçili olabilir), komutu başına eğik çizgi koymadan mı yazdınız, ve oyuncunun o komutu çalıştırma izni var mı? Üçüncü madde en sık gözden kaçandır; komut oyuncu adına çalıştığı için oyuncunun izni yoksa sessizce başarısız olur.

NPC’leri Hologramla Birleştirmek#

NPC’nin başının üstünde iki satırlık açıklama görmek isteyenler için Citizens tek başına yeterli değildir; isim etiketi tek satırdır. Çözüm, NPC’nin üzerine ayrı bir hologram yerleştirmektir. Bu sayede “Sunucu Mağazası” yazan bir başlık ve altında “Tıkla ve aç” satırı gösterebilirsiniz. Kurulumu Minecraft’ta hologram nasıl eklenir sayfasında anlatılıyor; ikisini birlikte kullanmak spawn tasarımını gözle görülür biçimde profesyonelleştirir.

Özetle#

Citizens ile NPC oluşturmanın çekirdeği dört komuttan ibarettir: /npc create ile oluşturur, /npc skin ile görünüm verir, /npc lookclose ile canlandırır, /npc command add ile işlevsel hâle getirirsiniz. 26.2 sunucusunda mutlaka Citizens 2.0.43 kullanın; NMS bağımlılığı yüzünden yanlış sürüm sessizce yüklenip çalışma anında hata verir. NPC verileriniz plugins/Citizens/saves.yml dosyasındadır, yedeklemeyi unutmayın. Sayı arttıkça lookclose özelliğini seçici kullanın ve sunucunuzu yüksek saat hızlı bir işlemci ile NVMe disk üzerinde çalıştırın — NPC yükünü kaldıran şey budur.