Minecraft Citizens Eklentisi Kurulumu ve NPC Sorunları

Hazır sunucu paketlerinizdeki NPC'lerin görünmesi için Citizens eklentisini bir kez indirip yüklemeniz gerekir. Eklenti ücretsizdir, kurulum beş dakika sürer ve bu rehberde her adım tek tek anlatılmıştır.

Citizens ve NPC nedir?

NPC, İngilizce Non-Player Character ifadesinin kısaltmasıdır; Türkçesi "oyuncu olmayan karakter" demektir. Sunucunuzun meydanında hareketsiz duran, başının üstünde ismi yazan, sağ tıkladığınızda mağaza penceresi açan veya size iş veren karakterler NPC'dir. Bunlar gerçek oyuncu değildir, sunucu tarafından oraya yerleştirilmiş sanal karakterlerdir.

Citizens, bu karakterleri oluşturan ve ayakta tutan ücretsiz bir eklentidir. Paketinizdeki her NPC'nin adı, kıyafeti, baktığı yön, durduğu koordinat ve tıklanınca çalıştıracağı komut plugins/Citizens/saves.yml adlı dosyada kayıtlıdır. Bu dosya paketin içinde eksiksiz gelir; hiçbir NPC bilgisi kaybolmamıştır.

Eksik olan tek şey eklentinin kendisi, yani Citizens.jar dosyasıdır. Durumu şöyle düşünebilirsiniz: elinizde tiyatro oyuncularının listesi ve sahnedeki yerleri yazılı bir kâğıt var, ama o kâğıdı okuyup oyuncuları sahneye çıkaracak yönetmen yok. Citizens'ı yüklediğiniz anda yönetmen de yerine gelir ve bütün NPC'ler kendiliğinden ortaya çıkar.

Bu önemli bir noktadır: NPC'leri elle tek tek yeniden oluşturmanız gerekmez. Sadece eklentiyi yüklemeniz ve sunucuyu yeniden başlatmanız yeterlidir.

Citizens neden pakete dahil değil?

Citizens tamamen ücretsizdir. Ne bize ne başkasına tek kuruş ödemezsiniz. Ancak eklentiyi geliştiren ekip, dosyanın yalnızca kendi resmi kanallarından dağıtılmasını istemektedir. Bu yüzden hazır sunucu paketlerini hazırlayan stüdyolar Citizens.jar dosyasını paketin içine koyamaz.

Dolayısıyla bu bir kusur veya eksik teslimat değildir; Minecraft dünyasında standart bir uygulamadır. Sizin yapmanız gereken tek şey dosyayı bir kez indirip sunucunuza yüklemektir.

Paketinizdeki NPC ayarlarının hiçbiri bu yüzden kaybolmaz. plugins/Citizens klasörü, içindeki saves.yml, config.yml ve shops.yml dosyalarıyla birlikte pakette hazır durur, sadece eklenti dosyasını bekler.

Hangi pakette Citizens gerekli, hangisinde gerekmez?

Verisunucu üzerinden alabileceğiniz altı hazır paketten dördünde Citizens'ı ayrıca kurmanız gerekir, ikisinde gerekmez. Hangi paketi aldığınızı bilmiyorsanız sipariş e-postanıza veya panelinizdeki sunucu adına bakın.

Citizens'ı ayrıca kurmanız gereken paketler:

• Elite Survival (Minecraft 1.21.11, Purpur) — pakette 151 NPC tanımlıdır. Informant, Skills Merchant, Auctioneer, Bee Keeper, Miner, Farmer ve Guard gibi görevli karakterlerin yanı sıra ortamı süsleyen arı ve tavuk NPC'leri de bu sayıya dahildir.
• Lifesteal (1.21.8, Paper) — 24 NPC. SHOP, JOBS, KITS, RANKS, VOTING, AUCTION MASTER, TEAMS, PRESTIGE gibi menü açan karakterlerdir.
• Premium SkyBlock (1.21.4, Paper) — 16 NPC. Food Shop, Block Shop, Redstone Shop, Enchanting, Fisher man, Miner, Butcher ve Farmer gibi karakterler.
• Klasik Survival (1.21.1, Paper) — 13 NPC. Jobs, Quests, Bartender, Blackjack ve Fisherman gibi karakterler.

Citizens gerekmeyen paketler:

• Modern Survival (1.21.11) — NPC'ler için Citizens yerine FancyNpcs eklentisini kullanır ve bu eklentinin dosyası plugins klasöründe hazır gelir.
• OneBlock (1.21.8) — aynı şekilde FancyNpcs kullanır, dosyası pakete dahildir.

Yani Modern Survival veya OneBlock aldıysanız bu makaledeki adımları uygulamanıza gerek yoktur. NPC'leriniz sunucuyu ilk açtığınızda zaten görünür durumda olur.

Peki Citizens'ı kurmazsanız ne olur? Sunucunuz normal şekilde çalışır, hiçbir şey bozulmaz, oyuncular girip oynayabilir. Ancak NPC'lerin durması gereken yerler bomboş görünür. Oyuncular mağazaya, iş sistemine, kit menüsüne ve görev sistemine NPC üzerinden ulaşamaz. Bu, oyuncuların "sunucu eksik" diye şikâyet etmesine yol açan en yaygın nedendir.

Citizens'ı resmi kaynaktan indirme

Bu bölümü sunucu panelinde değil, kendi bilgisayarınızda yapacaksınız. Dosyayı önce bilgisayarınıza indirecek, sonraki bölümde sunucuya yükleyeceksiniz.

1. Bilgisayarınızda bir internet tarayıcısı açın (Chrome, Edge, Firefox fark etmez).
2. Citizens'ın resmi dağıtım sayfası SpigotMC üzerindedir. Arama motoruna Citizens SpigotMC yazarak eklenti sayfasına ulaşabilirsiniz. Geliştiricinin kendi derleme sunucusu olan ci.citizensnpcs.co adresi de resmi kaynaktır.
3. Rastgele "eklenti indirme" sitelerinden, forum eklerinden veya video açıklamalarındaki bağlantılardan indirmeyin. Bu dosyalar değiştirilmiş olabilir ve sunucunuza zarar verebilir. Bir eklentiyi her zaman geliştiricisinin kendi sayfasından indirin.
4. İndirme düğmesine basmadan önce sayfada yazan desteklenen Minecraft sürümlerine bakın. Paketinizin sürümü bu listede geçmelidir: Elite Survival için 1.21.11, Lifesteal için 1.21.8, Premium SkyBlock için 1.21.4, Klasik Survival için 1.21.1.
5. Hangi yapıyı seçeceğinizden emin olamıyorsanız en güncel yapıyı (build) indirin. Citizens'ın güncel yapıları genellikle birden fazla 1.21 alt sürümünü aynı anda destekler; asıl risk çok eski bir yapıyı indirmektir.
6. İnen dosyanın uzantısı .jar olmalıdır. Örnek bir dosya adı şuna benzer: Citizens-2.0.39-b3800.jar. Eğer .zip uzantılı bir dosya indiyse, dosyaya sağ tıklayıp "Tümünü ayıkla" deyin; içinden çıkan .jar dosyasını kullanacaksınız.
7. Dosyayı sonradan kolayca bulabileceğiniz bir yere, örneğin Masaüstü'ne kaydedin.

Küçük bir bilgi notu: Premium SkyBlock paketinin içinde kalan eski bir önbellek kaydından, bu paketin Citizens 2.0.37 (build 3756) sürümüyle hazırlandığı anlaşılmaktadır. Bu yalnızca referans bilgisidir; daha yeni bir yapı indirmenizde hiçbir sakınca yoktur.

Citizens'ı sunucuya yükleme

Aşağıdaki adımlar oyun sunucusu kontrol panelinizden yapılır. Panel adresiniz ve giriş bilgileriniz sipariş sonrası e-posta ile tarafınıza gönderilmiştir.

1. Tarayıcınızdan oyun sunucusu panelinize giriş yapın. Karşınıza sunucularınızın listesi gelir; Minecraft sunucunuzun adına tıklayarak içine girin.
2. Sunucunuz açıksa önce durdurun. Üst kısımdaki Durdur (Stop) düğmesine basın ve konsolda sunucunun kapandığını gösteren satırların akmasını bekleyin. Dosya yüklerken sunucunun kapalı olması, dosyaların birbirinin üzerine yazmasını engeller.
3. Sol menüden Dosyalar veya Dosya Yöneticisi yazan başlığa tıklayın. Karşınıza sunucunuzun ana klasörü gelir. Burada server.properties, eula.txt gibi dosyalarla birlikte plugins ve world klasörlerini görürsünüz.
4. plugins yazısına tıklayarak klasörün içine girin. İçeride uzun bir .jar dosyası listesi ve bazı klasörler olacaktır. Listede Citizens adında bir klasör görüyorsanız doğru yerdesiniz.
5. Sağ üst köşedeki Yükle (Upload) düğmesine tıklayın. Açılan pencereden az önce indirdiğiniz Citizens-....jar dosyasını seçin. Dilerseniz dosyayı bilgisayarınızdan doğrudan tarayıcı penceresinin üstüne sürükleyip bırakabilirsiniz.
6. Yükleme çubuğunun yüzde 100'e ulaşmasını ve dosyanın listede görünmesini bekleyin. Dosya küçüktür, birkaç saniye sürer.
7. Çok önemli: jar dosyası plugins klasörünün doğrudan içinde durmalıdır. Yanlışlıkla plugins/Citizens klasörünün içine attıysanız, dosyanın yanındaki kutucuğu işaretleyip Taşı (Move) seçeneğiyle bir üst klasöre alın. Yanlış klasördeki bir eklenti dosyası hiç çalışmaz.
8. Var olan plugins/Citizens klasörünü silmeyin, adını değiştirmeyin, içindeki saves.yml dosyasına dokunmayın. Bütün NPC'leriniz o dosyanın içinde kayıtlıdır.
9. Sol menüden Konsol sekmesine dönün ve Başlat (Start) düğmesine basın.
10. Sunucunun açılmasını bekleyin. Yeni bir eklenti eklendiği için ilk açılış normalden biraz uzun sürebilir; bu normaldir.

Panel yerine FTP kullanmayı tercih ediyorsanız FileZilla gibi bir programla sunucuya bağlanıp aynı dosyayı /plugins dizinine kopyalamanız yeterlidir. Sonuç tamamen aynıdır.

İki uyarıyı atlamayın. Birincisi, bu paketlerin tamamı Java 21 ister. Panelde sunucunuzun Java sürümü 17 veya daha eski görünüyorsa, Citizens'ı yüklemeden önce Java sürümünü 21 yapın. İkincisi, paketler SETUP FILES gibi bir üst klasörün içinde teslim edilir; sunucuya bu klasörün içeriği yüklenir, klasörün kendisi değil. Sunucu ana dizininizde SETUP FILES adında bir klasör duruyorsa dosyalarınız yanlış yerdedir ve hiçbir eklenti çalışmaz.

Kurulumu doğrulama ve OP olma

Kurulumun gerçekten başarılı olduğunu görmek için aşağıdaki kontrolleri sırayla yapın. Komutları yazarken büyük harf küçük harf ayrımına dikkat edin.

1. Panelde Konsol sekmesinde kalın ve açılış sırasında akan satırları okuyun. Aralarda [Citizens] Enabling Citizens benzeri bir satır görmelisiniz. Bu satır eklentinin başarıyla yüklendiği anlamına gelir.
2. Minecraft oyununu açın, çok oyunculu bölümden sunucunuzun adresine bağlanın.
3. Komut kullanabilmek için sunucuda yetkili, yani OP olmanız gerekir. Kendinizi yetkilendirmek için panelin konsol satırına op oyuncuadi yazıp Enter tuşuna basın. oyuncuadi yerine kendi Minecraft kullanıcı adınızı yazacaksınız. Konsolda komutların başına eğik çizgi konulmaz.
4. Kendiniz zaten OP iseniz, başka birine yetki vermek için oyun içinde sohbet satırını açıp /op arkadasinadi yazmanız yeterlidir. Yetkiyi geri almak için /deop arkadasinadi komutunu kullanırsınız.
5. Oyun içinde sohbeti açıp /plugins yazın ve Enter'a basın. Açılan listede Citizens yazısı yeşil renkte görünmelidir. Yazı kırmızıysa eklenti yüklenmiş ama çalışamamış demektir.
6. /npc list komutunu yazın. Paketinizdeki NPC'lerin listesi ekrana gelmelidir. Elite Survival paketinde bu liste 151 karakter içerdiği için birden fazla sayfa sürer.
7. Sunucunun doğuş noktasına (spawn) gidin. NPC'lerin büyük çoğunluğu ana meydanda toplu halde durur ve isimleri havada yazılı görünür.

Bu yedi adım sorunsuz geçtiyse kurulum tamamlanmıştır ve başka bir şey yapmanıza gerek yoktur.

NPC'ler görünmüyorsa yapılacaklar

Citizens'ı yüklediniz ama NPC'ler hâlâ ortada yoksa, aşağıdaki listeyi yukarıdan aşağıya sırayla uygulayın. Sorunun nedeni neredeyse her zaman bu maddelerden biridir.

1. Sunucuyu tam olarak yeniden başlattınız mı? Panelden Yeniden Başlat (Restart) düğmesine basın. Oyun içinde /reload komutunu kullanmayın; bu komut Citizens gibi eklentilerde ciddi sorunlara yol açar.
2. Dosya doğru klasörde mi? Dosya Yöneticisi'nde plugins klasörünü açın. Citizens-....jar dosyası bu listede, diğer jar dosyalarının yanında görünmelidir. Bir alt klasörde değil.
3. Dosya adı bozulmuş olabilir. Bazı tarayıcılar dosyayı Citizens.jar.txt gibi kaydeder. Dosya adı mutlaka .jar ile bitmelidir. Bitmiyorsa dosya adını düzenleyip uzantıyı düzeltin.
4. Sürüm uyuşmuyor olabilir. Konsolda Citizens'ın kapandığını söyleyen bir satır varsa, indirdiğiniz yapı sunucu sürümünüzü desteklemiyordur. Sunucuyu durdurun, eski dosyayı silin, doğru sürümü indirip yeniden yükleyin.
5. Yanlış dünyada olabilirsiniz. NPC'ler kaydedildikleri dünyaya bağlıdır. Örneğin Klasik Survival paketinde NPC'lerin bir kısmı Spawn adında ayrı bir dünyada durur. Paketle gelen bütün dünya klasörlerini sunucuya yüklediğinizden emin olun; sadece ana dünyayı yüklemek yetmez.
6. Dünya klasörünü sildiyseniz veya yeniden ürettiyseniz NPC'ler doğmaz. Elite Survival paketinde NPC'ler dünyanın kimlik numarasına göre kayıtlıdır; bu numara world/uid.dat dosyasında tutulur. Panelin ürettiği yepyeni bir dünyanın kimliği farklı olacağı için Citizens NPC'leri nereye koyacağını bulamaz. Çözüm, paketten gelen world klasörünü olduğu gibi yeniden yüklemektir.
7. saves.yml dosyası boş olabilir. Dosya Yöneticisi'nde plugins/Citizens/saves.yml dosyasına tıklayıp içine bakın. Dosya bomboş görünüyorsa NPC kayıtları kaybolmuştur. Paketin orijinal arşivinden bu tek dosyayı çıkarıp yeniden yükleyin.
8. Sunucu açıkken dosya yüklemeyin. Citizens çalışır durumdayken, sunucu kapanırken saves.yml dosyasını kendisi baştan yazar. Sunucu açıkken bu dosyanın üzerine yükleme yaparsanız yaptığınız işlem kapanışta silinir.
9. Görüş mesafesi. NPC'ler oyuncudan çok uzaktaysa yüklenmez. Doğuş noktasına yaklaşın ve birkaç saniye bekleyin.

Bu adımların hepsini denediyseniz ve NPC'ler hâlâ görünmüyorsa, panel konsolundaki açılış kayıtlarını baştan sona kopyalayarak destek talebi açın. Alternatif olarak Dosya Yöneticisi'nden logs/latest.log dosyasını indirip talebe ekleyebilirsiniz. Kayıt dosyası olmadan sorunun nedenini uzaktan tespit etmek mümkün olmaz.

Konsol hata mesajları ve anlamları

Panel konsolunda akan yazılar korkutucu görünebilir ama çoğu zararsızdır. Aşağıda Citizens ile ilgili karşılaşabileceğiniz satırlar ve her birinin ne anlama geldiği açıklanmıştır.

• Unknown/missing dependency: Citizens veya içinde depend Citizens geçen satırlar: Başka bir eklenti Citizens'ı arıyor ama bulamıyor. Ya Citizens henüz kurulmamıştır ya da dosya yanlış klasördedir. Bu makaledeki kurulum adımlarını uygulayın.
• UnsupportedClassVersionError veya class file version 65 geçen satırlar: Sunucunuz eski bir Java sürümüyle çalışıyor demektir. Panelden Java sürümünü 21 yapıp sunucuyu yeniden başlatın.
• İçinde hem Citizens hem not compatible veya unsupported geçen satırlar: İndirdiğiniz Citizens yapısı sunucu sürümünüzle uyumlu değildir. Doğru sürümü indirip eski dosyayı silin.
• Citizens has been disabled: Eklenti bir hata yüzünden kendini kapatmıştır ve NPC'ler doğmaz. Bu satırın hemen üstündeki birkaç satır nedeni söyler; genellikle sürüm uyuşmazlığıdır.
• Could not load 'plugins/Citizens-....jar': Dosya eksik veya bozuk inmiş olabilir. Sunucuyu durdurun, dosyayı silin, yeniden indirip yükleyin.
• Konsolda hiçbir yerde Citizens kelimesi geçmiyorsa: Sunucu dosyayı hiç görmemiş demektir. Jar dosyası büyük ihtimalle plugins klasörünün dışında bir yerde duruyordur.

Konsol penceresinde arama yapmak zorsa, Dosya Yöneticisi'nden logs klasörüne girip latest.log dosyasını açın ve içinde Citizens kelimesini arayın. Bu dosya, son açılışta ekranda akan bütün satırları saklar.

Son bir hatırlatma: Citizens kurulumunu tamamladıktan sonra paket içindeki yer tutucu adresleri de kendi adreslerinizle değiştirmeyi unutmayın. Paketlerde play.survival.net, store.yourserver.net ve discord.gg/yourserver gibi örnek adresler bulunur; bunlar size ait değildir ve oyuncularınızı yanlış yerlere yönlendirir.

Sıkça Sorulan Sorular