Citizens

Oyuncu gibi görünen NPC'ler (oyuncu olmayan karakterler) oluştur; diyaloglar, hareket rotaları ve görev entegrasyonu dahil. RPG sunucularının temel taşı.

RPG ve NPC'ler SpigotPaperPurpur

Citizens hakkında

Citizens, bir Minecraft sunucusunda NPC'ler (oyuncu olmayan karakterler) oluşturmaya ve yönetmeye yarayan bir plugin. NPC'ler gerçek oyuncular gibi görünür (istediğin herhangi bir skinle), ama onları sunucu kontrol eder. Yerlerinde durabilir, belirlenen rotalarda yürüyebilir, sohbet edebilir, oyuncularla ticaret yapabilir ve görevlerde rol alabilirler. Citizens, RPG ve MMO sunucularının temelidir. NPC'lerin farklı rolleri olabilir: tüccar (eşya satar ve alır), bekçi (düşman moblara saldırır), rehber (oyuncuları bir rota boyunca götürür) ya da görev veren (görev dağıtır).

Plugin modüler bir yapıya sahip. Citizens tek başına sana NPC oluşturmayı ve hareket rotalarını sunar. Denizen (ayrı bir plugin) gelişmiş scriptler, diyaloglar ve görev mekanikleri ekler. Citizens ayrıca Sentinel (bekçi ya da savaşçı NPC'ler) ve BetonQuest (bir görev sistemi) ile entegre çalışır.

Citizens, Minecraft sunucun için değerlendirmeye değer başlıca RPG pluginlerinden biri. Minecraft 1.8.8 - 1.21.x sürümlerini destekler ve Spigot, Paper ve Purpur üzerinde çalışır.

Citizens özellikleri

Bunlar Citizens ile sunucuna gelen başlıca özellikler. Her birini pluginin yapılandırma dosyasından ayarlayabilirsin.

İstediğin skine sahip NPC'ler
Hareket rotaları (waypoint)
Denizen entegrasyonu (diyaloglar)
Farklı NPC türleri (tüccar, bekçi)
Sentinel (savaşan NPC'ler)
20'den fazla varlık türü desteği

Citizens komutları

En önemli 6 Citizens komutu aşağıda. Tam listeyi resmî dokümantasyonda bulabilirsin. Unutma, her komutu bir yetki sistemiyle (örneğin LuckPerms) engelleyebilir ya da serbest bırakabilirsin.

Komut	Açıklama	Yetki
`/npc create [isim]`	Yeni bir NPC oluşturur	`citizens.npc.create`
`/npc skin [oyuncu]`	NPC'ye bir oyuncu hesabının skinini verir	`citizens.npc.skin`
`/npc select`	Bir NPC seçer (üstüne sağ tıkla)	`citizens.npc.select`
`/npc remove`	Seçili NPC'yi siler	`citizens.npc.remove`
`/npc tphere`	NPC'yi yanına ışınlar	`citizens.npc.tphere`
`/npc lookclose`	NPC'nin en yakındaki oyuncuya bakmasını sağlar	`citizens.npc.lookclose`

İpucu: Bir komutun hangi argümanları kabul ettiğini görmek için sunucu konsolunda otomatik tamamlamayı (Tab tuşu) kullan. LuckPerms kurulu bir sunucuda yetkileri tek tek oyunculara değil, gruplara ver.

Yetkiler

Yetki sistemiyle Citizens özelliklerinin her birini kimin kullanabileceğini belirlersin. Yetkileri LuckPerms gibi bir rütbe plugini üzerinden verirsin (/lp group [grup] permission set [node] true). "Varsayılan OP" sütunu, sunucu operatörlerinin bu yetkiye hiçbir ayar yapmadan sahip olup olmadığını gösterir.

Yetki node'u	Açıklama	Varsayılan OP
`citizens.npc.create`	NPC oluşturma	Evet
`citizens.npc.edit`	NPC düzenleme	Evet
`citizens.npc.remove`	NPC silme	Evet

Citizens yapılandırması

Citizens, ilk açılışta plugins/Citizens/ klasöründe bir yapılandırma dosyası oluşturur. Aşağıda en önemli seçenekleri yorum satırlarıyla birlikte görebilirsin. Ayarların tam listesi resmî dokümantasyonda.

# Citizens config.yml
npc:
  default:
    look-close:
      enabled: false       # Varsayılan olarak NPC'ler oyunculara bakmaz
      range: 5             # Bakış mesafesi
    pathfinding:
      enabled: true
      attack-range: 1.75   # Bekçilerin saldırı menzili
  max-npcs-per-player: 10  # Oyuncu başına NPC sınırı

Yapılandırmayı değiştirdikten sonra dosyayı kaydet ve bir yeniden yükleme komutu kullan (örneğin /reload ya da pluginin kendi reload komutu). Plugin yeniden yüklemeden sonra değişiklikleri almazsa sunucuyu yeniden başlat: /stop ile durdur ve tekrar aç.

YAML hata affetmeyen bir format. Tek bir yanlış boşluk ya da sekme bütün dosyayı bozabilir. Söz dizimi vurgulaması olan bir editör kullan (VS Code, Notepad++) ve dosyayı sunucuya yüklemeden önce yamllint.com adresinde kontrol et.

Citizens nasıl kurulur

Citizens pluginini resmî siteden indir. Minecraft sürümünle uyumlu bir sürüm aldığından emin ol (1.8.8 - 1.21.x).
İndirdiğin .jar dosyasını sunucu klasöründeki plugins/ klasörüne kopyala.
Sunucuyu /stop ile durdur ve yeniden başlat. İlk kurulumda /reload kullanma.
Sunucu konsoluna bak. Citizens doğru yüklendiyse pluginin sürümünü gösteren bir mesaj görürsün. Hata varsa bütün bağımlılıkların kurulu olup olmadığını kontrol et.
Plugini plugins/Citizens/config.yml dosyasını (ya da onun yerini tutan dosyayı) düzenleyerek yapılandır. Değişiklik yaptıktan sonra yeniden yükleme komutunu kullan.

Sunucu uyumluluğu: Citizens pluginini Spigot, Paper ve Purpur üzerinde çalıştırabilirsin. Sunucu motoru olarak Paper'ı öneriyoruz: Spigot'tan daha iyi performans ve daha fazla API sunar.

Citizens alternatifleri

Citizens kendi kategorisindeki tek plugin değil. Farklı bir şey arıyorsan ya da Citizens ihtiyaçlarını karşılamıyorsa aşağıdaki alternatifler göz atmaya değer.

FancyNPCs

NPC oluşturmaya minimalist yaklaşan, daha hafif bir alternatif.

ZNPCsPlus

ProtocolLib olmadan çalışan, paket tabanlı modern bir NPC plugini.

Citizens hakkında sıkça sorulan sorular

Citizens nasıl kurulur?

Citizens'ı resmî CI sunucusundan indir. .jar dosyasını plugins/ klasörüne at ve sunucuyu yeniden başlat. NPC'leri /npc create [isim] komutuyla oluştur. Diyaloglar ve görevler için Denizen'i ya da BetonQuest'i kur. Bağımlılıklar ve yapılandırma dahil ayrıntılı talimatları yukarıdaki kurulum bölümünde bulabilirsin.

Citizens hangi sunucu motorlarında çalışır?

Citizens şu motorlarda çalışır: Spigot, Paper, Purpur. Motor olarak Paper'ı öneriyoruz: çoğu sunucu için performans ile plugin uyumluluğu arasındaki en iyi dengeyi sunar. Sunucu motorları hakkında daha fazlasını karşılaştırmamızda okuyabilirsin.

Citizens ücretsiz mi?

Citizens resmî sitesinden indirilebilir. Lisans ayrıntılarını indirme sayfasında kontrol et.

Citizens çalışmıyor. Ne yapmalıyım?

Sunucu klasöründeki logs/latest.log dosyasına bak. En yaygın hata sebepleri şunlar: (1) eksik bir bağımlılık, (2) uyumsuz bir Minecraft sürümü (sunucu sürümünün 1.8.8 - 1.21.x aralığında olup olmadığını kontrol et), (3) config.yml içinde bir hata (YAML biçimlendirmesini kontrol et), (4) aynı işi yapan başka bir pluginle çakışma.

Citizens pluginini Bedrock sunucusunda kullanabilir miyim?

Hayır. Citizens bir Java Edition plugini ve Spigot/Paper/Purpur sunucularında çalışır. Bedrock Edition farklı bir sistem kullanır (davranış paketleri). Java ve Bedrock oyuncularını aynı sunucuda buluşturmak istiyorsan Geyser projesine göz at.