Project Zomboid·17 Eylül 2026·5 dk okuma

Project Zomboid Mod Hatası ve Mod Çakışması Nasıl Çözülür?

Sunucunuz mod yükledikten sonra hata veriyorsa suçlu modu konsol logundan bulabilirsiniz. Lua stack trace okuma, ikiye bölme yöntemi ve en sık görülen mod hatalarının çözümü.

AnkSOFT

Yayıncı

Project Zomboid Mod Hatası ve Mod Çakışması Nasıl Çözülür? — FIG. 01 — Project Zomboid

Project Zomboid sunucunuza mod yüklediniz, sunucu açıldı ama bir şeyler ters gidiyor: oyuncular bağlanamıyor, eşyalar görünmüyor, sunucu belirli bir anda donuyor ya da konsol ekranı kırmızı hata satırlarıyla doluyor. Bu tablonun neredeyse tamamı tek bir sebebe dayanır: mod çakışması veya eksik/yanlış girilmiş mod kimliği.

İyi haber şu ki Project Zomboid suçluyu size zaten söylüyor. Konsol logunu nasıl okuyacağınızı bilirseniz, hangi modun hata ürettiğini tahmin etmeden, dakikalar içinde bulabilirsiniz.

Bu rehberde mod hatalarını adım adım teşhis etmeyi anlatıyoruz. Modları sunucuya ilk kez yükleyecekseniz önce Project Zomboid Sunucuya Mod Nasıl Yüklenir rehberimizi okumanızı öneririz.

1. Önce Konsol Logunu Açın

Her teşhis buradan başlar. Panelde sunucunuzun Konsol (Console) sekmesini açın ve sunucuyu yeniden başlatın. Açılış sırasında akan satırların üç tipi vardır:

WARN — Uyarı. Çoğu zararsızdır. AnimState not found: turning180 gibi animasyon uyarıları oyunun kendi gürültüsüdür, sunucuyu çökertmez.
LOG — Bilgi satırı. Kaydetme, bağlantı, mod indirme gibi normal olaylar.
ERROR — Asıl aradığınız satır. Özellikle dumping Lua stack trace yazan bloklar.

Yüzlerce WARN satırı görmeniz normaldir; onlara takılmayın. Konsolda arama yapabiliyorsanız doğrudan ERROR veya stack trace kelimesini aratın.

2. Lua Stack Trace: Suçlu Modun Adı Burada Yazar

Bir mod hata verdiğinde oyun şöyle bir blok basar:

ERROR: General > dumping Lua stack trace
-----------------------------------------
STACK TRACE
-----------------------------------------
    Lua((MOD:BBB (Better Backpack Bottoms))).onClothingUpdated(BetterBackpackBottoms_WeightFix.lua:55)
    Lua(Vanilla).complete(ISUnequipAction.lua:132)
    Lua((MOD:The Only Cure)).complete(ProsthesisHandler.lua:175)

java.lang.RuntimeException: Object tried to call nil in onClothingUpdated

Bu bloğu okumanın kuralı basittir:

Lua((MOD:...)) ile başlayan her satır bir modun adını verir. Yukarıdaki örnekte iki mod var: Better Backpack Bottoms ve The Only Cure.
Lua(Vanilla) satırı oyunun kendi kodudur. Burada ISUnequipAction.lua yazması, hatanın kıyafet/çanta çıkarma işlemi sırasında tetiklendiğini söyler.
En üstteki MOD: satırı, hatayı fiilen fırlatan moddur. Dosya adı ve satır numarası da oradadır (BetterBackpackBottoms_WeightFix.lua:55).
Aynı blokta birden fazla mod adı görüyorsanız, bu klasik bir çakışma tablosudur: iki mod aynı oyun olayına birlikte müdahale ediyor ve biri diğerinin beklediği veriyi bozuyor.

Object tried to call nil ifadesi ise "var olmayan bir fonksiyon çağrıldı" demektir. Pratikte bu, iki modun uyumsuz sürümlerinin bir arada çalıştığının en yaygın işaretidir.

3. En Sık Karşılaşılan Mod Hataları ve Anlamları

Konsoldaki satır	Ne anlama gelir	Ne yapmalısınız
`Object tried to call nil`	İki mod çakışıyor ya da mod güncel değil	Stack trace'teki modlardan birini devre dışı bırakın
`Mod not found: XYZ`	`MOD_IDS` alanına yanlış ad yazılmış	Mod ID'yi Workshop sayfasından birebir kopyalayın
`attempt to index a nil value`	Modun beklediği başka bir mod eksik	Modun Workshop sayfasındaki "Required Items" listesini kurun
Oyuncu bağlanırken "mod uyuşmuyor"	Sunucu ile istemcideki mod sürümü farklı	Sunucuyu yeniden başlatın, oyuncular Steam'de modu güncellesin
Sunucu açılışta kapanıyor	`WORKSHOP_IDS` ile `MOD_IDS` sırası uyuşmuyor	İki listeyi aynı sırayla yeniden yazın

4. Suçlu Modu Bulmanın En Hızlı Yolu: İkiye Bölme

Stack trace size mod adı vermiyorsa veya listede 30 mod varsa, tek tek denemek yerine ikiye bölme yöntemini kullanın. 32 modluk bir listede suçluyu 5 denemede bulursunuz:

Panelde Başlangıç (Startup) sekmesini açın.
Mod listesinin yarısını hem WORKSHOP_IDS hem MOD_IDS alanından çıkarın. İki alandan birden çıkarmayı unutmayın.
Sunucuyu yeniden başlatın ve hatayı tetikleyen işlemi tekrarlayın.
Hata devam ediyorsa suçlu elinizde kalan yarıdadır; hata kaybolduysa çıkardığınız yarıdadır.
Suçlu olduğunu bildiğiniz yarıyı tekrar ikiye bölün ve aynı adımı uygulayın.

Her turda aday sayısı yarıya iner. Çıkardığınız mod kimliklerini bir kenara not edin; geri eklerken sıranın bozulmaması önemlidir.

5. Çakışma Doğrulandıktan Sonra

Suçlu modu bulduğunuzda üç seçeneğiniz vardır:

Modu listede tutmayın. En hızlı çözüm. Aynı işi yapan alternatif bir mod çoğu zaman vardır.
Mod geliştiricisine bildirin. Steam Workshop sayfasındaki yorum bölümüne konsoldaki stack trace bloğunu olduğu gibi yapıştırın. Geliştiriciler için en değerli bilgi tam olarak o bloktur.
Yükleme sırasını değiştirin. Bazı çakışmalar sıra kaynaklıdır. Genel kural: temel/kütüphane modları (framework, API, "Common Sense" gibi) listenin başında, onlara bağımlı modlar sonrasında olmalıdır.

Altın kural: WORKSHOP_IDS ve MOD_IDS listelerindeki sıra birebir aynı olmalıdır. Bir moddan vazgeçtiğinizde ikisinden birden çıkarın; yalnızca birinden çıkarmak sunucunun açılışta kapanmasına yol açar.

6. Harita Modlarında Ek Kontrol

Harita modları ayrı bir çakışma sınıfıdır. İki harita modu haritanın aynı bölgesini kullanıyorsa oyuncular boş alana veya havada bir noktaya doğabilir.

Map= satırında harita klasör adları, varsayılan Muldraugh, KY girdisinden önce yer almalıdır.
İki harita modunun koordinatları çakışıyorsa (Workshop sayfalarında harita koordinatı yazar) ikisi birlikte kullanılamaz.
Harita modunu sunucuya sonradan eklediyseniz, oyuncuların o bölgeyi daha önce keşfetmiş olması bozuk arazi oluşturabilir. Bu durumda yalnızca ilgili bölge dosyalarının sıfırlanması gerekir.

7. Sorun Modda mı, Sunucuda mı?

İkisini ayırt etmek kolaydır:

Mod kaynaklıdır — konsolda Lua hatası veya MOD: adı geçen bir stack trace varsa, hata belirli bir oyun içi işlemde (kıyafet çıkarma, araç kullanma, inşa etme) tekrarlanıyorsa ve sunucu bu sırada ayakta kalıyorsa.

Sunucu kaynaklıdır — sunucu hiç açılmıyorsa, panel bağlantı hatası veriyorsa, konsol hiç çıktı üretmiyorsa ya da sunucu RAM yetersizliğinden kapanıyorsa. Bu durumlarda bizimle iletişime geçin.

Mod kurulumu ve mod uyumluluğu, oyunun ve üçüncü parti içeriğin kendi tarafındadır; bu yüzden mod seçimi ve uyumluluk testi sunucu sahibinin kontrolündedir. Sunucunun kendisiyle ilgili bir belirti gördüğünüzde destek ekibimiz yanınızdadır.

Modlu Sunucu İçin Doğru Altyapı

Her mod sunucunun RAM ve işlemci tüketimini artırır. 40-50 modluk bir listede sunucu açılışı uzar, kaydetme süreleri büyür ve yetersiz donanımda çakışma benzeri belirtiler ortaya çıkar — oysa sorun yalnızca kaynak yetersizliğidir.

Anksoft Project Zomboid Sunucu Kiralama hizmetimizde yüksek frekanslı Ryzen işlemciler, NVMe SSD diskler ve ANKARMOR Anti-DDoS koruması standarttır. Modlarınızı Türkçe web panelden tek ekrandan yönetir, konsol logunu anlık izler ve sunucunuzu tek tıkla yeniden başlatırsınız.

Modlu hayatta kalma maceranız için Project Zomboid paketlerimizi inceleyin.

İlgili Yazılar

8 Haziran 2026

Web Hosting

Sunucu Hizmetleri

Kurumsal