ZNPCs: Minecraft'ta NPC oluşturmak için eklenti
Bağımlılıklar: Sunucu türü: Paper veya Spigot 1.8.8–1.21.4 Minecraft sürümü: 1.8.8–1.21.4 Bağımlı eklentiler: PlaceholderAPI (isteğe bağlı…
Bağımlılıklar: Sunucu türü: Paper veya Spigot 1.8.8–1.21.4 Minecraft sürümü: 1.8.8–1.21.4 Bağımlı eklentiler: PlaceholderAPI (isteğe bağlı, hologramlardaki değişkenler için) İndir: SpigotMC / GitHub Lobi veya dekorasyon
Bağımlılıklar:
Sunucu türü: Paper veya Spigot 1.8.8–1.21.4
Minecraft sürümü: 1.8.8–1.21.4
Bağımlı eklentiler: PlaceholderAPI (isteğe bağlı, hologramlardaki değişkenler için)
İndir: SpigotMC / GitHub
Lobi veya dekorasyon için basit NPC'ler gerekiyorsa, Citizens fazla ağır gelebilir. ZNPCs aynı görevi daha basit bir şekilde çözer: bir yığın bağımlılık olmadan tek bir .jar dosyasıdır ve kendi skinine, metnine ve tıklamaya verilen tepkiye sahip karakterler yerleştirmenize olanak tanır.
Temel özellikler
Tüm NPC'lerin benzersiz bir sayısal kimliği vardır. Takma ad veya URL ile skinli normal bir oyuncu oluşturabilir ya da ZOMBIE veya SKELETON gibi bir yaratık yerleştirebilirsiniz.
Bir oyuncu NPC'ye tıkladığında, eklenti belirlenen eylemleri gerçekleştirir. Bu bir mesaj, oyuncu veya konsol adına bir komut, hatta oyuncuyu BungeeCord aracılığıyla başka bir sunucuya gönderme olabilir. Birden fazla eylem varsa, sırayla gerçekleştirilirler. Ayrıca her eylem için bir bekleme süresi (gecikme) ayarlayabilirsiniz.
Baş üstündeki metin (Lines)
NPC'nin üzerine lines komutuyla metin ekleyebilirsiniz. Eklenti renk kodlarını destekler ve PlaceholderAPI kuruluysa %player_name% veya %server_online% gibi değişkenleri de destekler. Metnin yüksekliğini height komutuyla da değiştirebilirsiniz.
Rotalar (Paths)
Bir NPC'nin mutlaka yerinde durması gerekmez. Ona yürümeyi öğretmek için kayıt modunu açmanız (/znpcs path create <ad>) ve istenen rotayı kendiniz yürümeniz gerekir. Bittikten sonra /znpcs path exit yazmanız gerekir. Ardından bu rota belirli bir NPC'ye atanır (/znpcs path set <id> <ad>) ve o NPC sonsuza dek bu rota boyunca dolaşmaya başlar.
Önemli bir ayrıntı: hareket çok basittir. ZNPCs vanilya yol bulmayı (Pathfinder) kullanmaz, bu yüzden karakterler engellerden kaçınmaz ve diğer oyunculara tepki vermez.
Donanım ve görünüm
Karakterlere zırh giydirebilir ve ellerine eşya verebilirsiniz. İstediğiniz eşyayı elinize alıp /znpcs equip <id> <slot> yazmanız yeterlidir (mevcut slotlar: HAND, OFFHAND, HELMET, CHESTPLATE, LEGGINGS, BOOTS).
Ayrıca toggle komutuyla NPC'nin davranışını ayarlama imkânı vardır: yakındaki oyunculara bakmasını sağlamak (look), kendisine bakan oyuncunun skinini yansıtmak (mirror) veya seçilen renkte bir parlama (glow) eklemek.
Komutlar
Bu komutlar yönetici izinleri (znpcs.admin) gerektirir.
Komut | Açıklama | İzin |
| Koordinatlarınızda bir NPC oluşturur | znpcs.admin |
| Bir NPC'yi siler | znpcs.admin |
| NPC'lerin ve kimliklerinin listesini gösterir | znpcs.admin |
| NPC'yi yanınıza ışınlar | znpcs.admin |
| Sizi NPC'nin yanına ışınlar | znpcs.admin |
| Mevcut bir NPC'nin türünü değiştirir | znpcs.admin |
| Karakterin skinini değiştirir | znpcs.admin |
| Elinizdeki eşyayı NPC'ye verir | znpcs.admin |
| NPC'nin üzerindeki metni değiştirir | znpcs.admin |
| Metnin yüksekliğini değiştirir (varsayılan 1) | znpcs.admin |
| Tıklamada bir eylem ekler | znpcs.admin |
| NPC'nin eylemlerinin listesini gösterir (kimlikleriyle birlikte) | znpcs.admin |
| Bir eylemi kimliğine göre siler | znpcs.admin |
| Bir eylemin yürütülmesi için gecikme ayarlar | znpcs.admin |
| Yeni bir rota kaydeder | znpcs.admin |
| Rota kayıt modundan çıkar | znpcs.admin |
| Bir NPC'ye rota atar | znpcs.admin |
| Seçenekleri açar/kapatır (look, holo, mirror) | znpcs.admin |
| Seçilen renkte bir parlama efekti ekler | znpcs.admin |
action add için eylem türleri:
CMD (oyuncu adına bir komut yürütür)
CONSOLE (konsoldan bir komut yürütür)
CHAT (oyuncu sohbete bir mesaj yazar)
MESSAGE (oyuncuya bir mesaj gönderir)
SERVER (BungeeCord aracılığıyla başka bir sunucuya aktarır)
Erişim izinleri
Burada her şey son derece basittir. Neredeyse her şey için yalnızca tek bir düğüm gereklidir:
Düğüm | Ne sağlar |
znpcs.admin | Tüm komutlara tam erişim |
Yapılandırma
config.json
Parametre | Değer | Açıklama |
| 500 | Tek bir NPC rotası için kaydedilebilecek maksimum nokta (adım) sayısı. Rota çok uzunsa, bu sınıra ulaşıldığında kayıt otomatik olarak durur. |
| "DEFAULT" | NPC'ler için dahili adlar oluşturma algoritması. Varsayılan değer, kimliğin doğru şekilde bağlanmasını sağlar. |
| TRUE | NPC'yi oluşturulurken otomatik olarak bloğun tam ortasına hizalar. Modelin bloğun kenarına kaymasını önler. |
| "-" | Eklentinin komut metnindeki boşlukları değiştirmek veya tanımlayıcılar oluştururken kullandığı simge. |
| 600 | Oluşturulan karakterlerin npcs.json dosyasına otomatik kaydedilme aralığı (600 saniye = 10 dakika). Sunucunun ani çökmesi durumunda veri kaybına karşı korur. |
| TRUE | Hata ayıklama modunun etkinleştirilmesi. Eklenti, ayrıntılı teknik bilgileri ve hata günlüklerini sunucu konsoluna yazdırmaya başlar. Konsolun temiz kalması için kararlı sunucularda kapatılması (false) önerilir. |
| 0.3 | NPC'nin başının üzerindeki hologramın (metnin) satırları arasındaki mesafe. Daha küçük bir değer metni daha sıkışık yapar. |
| 32 | Sunucunun NPC modelini çizmek için oyuncuya paket göndermeye başladığı yarıçap (blok cinsinden). Değeri düşürmek sunucu ve istemci kaynaklarından tasarruf sağlar. |
| FALSE | Hologram metni için dinamik renk değişimi (RGB geçişi) desteği. Etkinleştirmek istemcide ek yük oluşturabilir. |
npcs.json
Oluşturulan tüm NPC'ler npcs.json dosyasına yazılır. Eklenti onu otomatik olarak oluşturur, bu yüzden elle düzenlememek daha iyidir. Bu dosyaya girmenin tek mazereti, yapılandırılmış NPC'leri başka bir sunucuya taşımanız gerektiğinde ortaya çıkar.
conversations.json
Tüm diyaloglar burada saklanır.
paths
Kaydedilen tüm rotaların saklandığı klasör.
data.json
Oluşturulan NPC'lerle ilgili tüm ayrıntılı bilgiler burada saklanır.
Entegrasyonlar
Sunucuda PlaceholderAPI kuruluysa, ZNPCs onu özel eklentiler olmadan otomatik olarak algılar. Bu, örneğin bir NPC'nin üzerinde dinamik bir çevrimiçi sayacı göstermek istediğinizde işe yarar.
Uyumluluk
Orijinal ZNPCs yalnızca 1.21.1 sürümüne kadar normal şekilde çalışır. Daha yeni sunucular için (1.21.1 ve üzeri) ZNPC Plus forkunu kurmanız gerekir.
Ayrıca eklenti, varlıklarla çalışma şeklindeki özellikleri nedeniyle Folia'da çalışmaz.
ZNPCs ne zaman kullanılmalı
Spawn noktasına yalnızca bir menü açan, başlangıç seti veren veya oyuncuları diğer mini oyun sunucularına aktaran bir NPC yerleştirmeniz gerekiyorsa, ZNPCs mükemmel bir seçimdir. Tam olarak vaat ettiği şeyi yapar ve sunucuyu gereksiz işlevsellikle yormaz.
Ancak dallanan diyaloglar veya karmaşık görevler yapmayı planlıyorsanız, Citizens + Denizen ekosistemine ihtiyacınız var. ZNPCs bunun için tasarlanmamıştır.
Kurulum
Tipik bir kurulum yaklaşık 5 dakika sürer. Akış aynıdır; yalnızca loader ve uygun build değişir.
- 1Stop your Minecraft server.
- 2Drop the plugin .jar into the server /plugins folder.
- 3Start the server once so the plugin generates its config files.
- 4Edit /plugins/<name>/config.yml as needed, then run /reload confirm or restart.








