Bu kılavuz, Legion Hosting ile barındırılan Project Zomboid sunucuları için gelişmiş mod sorun gidermeyi kapsar. Henüz mod yüklemediyseniz, önce temel mod kurulum kılavuzu ile başlayın. Bu makale, WorldDictionary bozulması, mod biçimi hataları, yükleme sırası çakışmaları ve sunucu ile istemci arasındaki sürüm uyumsuzlukları dahil olmak üzere Legion Hosting destek taleplerinde görülen en yaygın mod ile ilgili sorunları ele alır.

Başlamadan Önce

• GPanel'e giriş yapın ve Project Zomboid sunucunuzu seçin.
• Herhangi bir yapılandırma veya dosya değişikliği yapmadan önce sunucunuzu durdurun.
• Herhangi bir düzeltmeyi denemeden önce dünya kayıt klasörünüzü (/.cache/saves/multiplayer/) SFTP veya GPanel aracılığıyla yedekleyin. Dosya aktarımlarına aşina değilseniz SFTP kılavuzuna bakın.
• Sunucunuzun .ini dosya yolunu hazır bulundurun: /.cache/server/<servername>.ini (örn. servertest.ini).

1. Mod Biçimi Hataları (B42 vs B41)

Modların yüklenmemesinin en yaygın nedeni, sunucunuzun .ini dosyasındaki Mods= satırında yanlış bir biçimdir. Build 42 ve Build 41 farklı sözdizimi kullanır ve bunları karıştırmak modlarınızın sessizce yüklenememesine neden olur.

B42 Biçimi (Mevcut Varsayılan)

Build 42, Mods= satırındaki her Mod ID'sinden önce bir ters eğik çizgi öneki gerektirir:

Mods=\ModID1;\ModID2;\ModID3;

DLMP biçimi, Workshop ID'lerini ve Mod ID'lerini bir ters eğik çizgi ayırıcı ile birleştirir:

Mods=2392987841\ModID1;1550458773\ModID2;2786383654\ModID3;

WorkshopItems= satırı, her iki build'de de aynı noktalı virgülle ayrılmış biçimi kullanır:

WorkshopItems=2392987841;1550458773;2786383654

B41 Biçimi (Eski)

Build 41, ters eğik çizgi olmadan düz noktalı virgülle ayrılmış Mod ID'leri kullanır:

Mods=ModID1;ModID2;ModID3

Nasıl Düzeltilir

1. GPanel Dosya Yöneticisinde /.cache/server/<servername>.ini dosyasını açın.
2. Mods= satırını bulun ve biçimi yukarıdaki örneklerle karşılaştırın.
3. Biçim, build sürümünüz için yanlışsa düzeltin. Doğru biçimlendirilmiş satırları otomatik olarak oluşturmak için Legion Hosting Mod Organizer'ı kullanın.
4. Dosyayı kaydedin ve sunucuyu başlatın.

2. WorldDictionary Bozulması

WorldDictionary, öğe adlarını dahili sayısal ID'lere eşleyen bir dosyadır (WorldDictionary.bin). Modlar eklendiğinde veya kaldırıldığında, sözlük bozulabilir ve sunucunun başlangıçta bir WorldDictionaryException ile çökmesine neden olabilir.

Belirtiler

• Konsol veya debug.log, WorldDictionaryException veya WorldDictionary hatalarını gösterir.
• Sunucu, başlangıç sırasında, özellikle dünya yüklenirken hemen çöker.
• Çökme, mod ekledikten, kaldırdıktan veya güncelledikten sonra başladı.

Riski Anlamak

Kurtarma Adımları

1. GPanel'de sunucunuzu durdurun.
2. SFTP aracılığıyla tüm kayıt klasörünüzü yedekleyin: tüm /.cache/saves/multiplayer/<YourWorldName>/ dizinini yerel makinenize indirin.
3. Önce, hataya neden olan mod değişikliğini geri almayı deneyin. Az önce bir mod eklediyseniz, onu .ini dosyasındaki hem Mods= hem de WorkshopItems= satırlarından kaldırın. Az önce bir mod kaldırdıysanız, onu geri ekleyin. Sunucuyu başlatın ve çökmenin çözülüp çözülmediğine bakın.
4. Mod değişikliğini geri almak işe yaramazsa, SFTP aracılığıyla bağlanın ve /.cache/saves/multiplayer/<YourWorldName>/ dizinine gidin.
5. WorldDictionary.bin dosyasını silin.
6. Sunucuyu başlatın. Project Zomboid başlangıçta sözlüğü yeniden oluşturacaktır.
7. Sunucuya katılın ve dünyayı bozuk öğeler, eksik araçlar veya bozuk envanterler için inceleyin. Dünya ciddi şekilde hasarlıysa, 2. adımda oluşturduğunuz yedekten geri yükleyin.

3. Authentic Z Mod Çakışmaları

Authentic Z, en popüler Project Zomboid mod koleksiyonlarından biridir, ancak birbiriyle çakışan birden çok alt mod içerdiğinden sık sık destek taleplerine neden olur.

Kural

Yaygın Hatalar

• Hem Authentic Z - Current hem de Authentic Z - Litemode'u aynı anda eklemek.
• Tek oyunculu için tasarlanmış Authentic Z alt modlarını çok oyunculu sürümle birlikte eklemek.
• Farklı Authentic Z alt modlarının aynı Workshop ID'sini paylaştığını ancak farklı Mod ID'lerine sahip olduğunu fark etmemek; bu nedenle Workshop indirmesi başarılı olur ancak sunucu çakışan mod dosyalarını yükler.

Nasıl Düzeltilir

1. GPanel Dosya Yöneticisinde /.cache/server/<servername>.ini dosyasını açın.
2. Mods= satırında Authentic veya AuthenticZ içeren her girişi arayın.
3. Yalnızca bir Authentic Z alt modunu tutun (önerilen: Authentic Z - Current). Diğer tüm Authentic Z girişlerini hem Mods= hem de WorkshopItems= satırlarından kaldırın.
4. Dosyayı kaydedin ve sunucuyu yeniden başlatın.

4. Linux Büyük/Küçük Harf Duyarlılığı Sorunları

Legion Hosting sunucuları, dosya ve klasör adlarının büyük/küçük harfe duyarlı olduğu Linux üzerinde çalışır. MyMod.lua ve mymod.lua adlı bir dosya, tamamen farklı iki dosya olarak ele alınır. Bu, mod yazarları Windows'ta (büyük/küçük harfe duyarsız) geliştirme yaptığında ve modları uyuşmayan dosya referansları içerdiğinde sorunlara neden olur.

Belirtiler

• Bir mod, Windows PC'nizde tek oyunculu modda mükemmel çalışır ancak sunucuda başarısız olur.
• Konsol veya debug.log, bir mod içindeki bir Lua betiğine veya dokuya başvuran FileNotFoundException veya can't find file hatalarını gösterir.
• Hata, mod klasöründe var olan ancak farklı bir büyük harf kullanımına sahip bir dosyaya işaret eder (örn. kod Items.txt'e başvurur ancak gerçek dosyanın adı items.txt'tir).

Nasıl Teşhis Edilir

1. Hatada belirtilen tam dosya yolu için konsolu veya /.cache/Logs/ günlük dosyalarını kontrol edin.
2. SFTP aracılığıyla bağlanın ve modun klasörüne /steamapps/workshop/content/108600/<WorkshopID>/ konumunda gidin.
3. Diskteki dosya adlarını hata mesajında başvurulan dosya adıyla karşılaştırın. Büyük harf farklılıklarını arayın.

Nasıl Düzeltilir

• Dosyayı yeniden adlandırabiliyorsanız: SFTP aracılığıyla bağlanın ve dosyayı modun kodunun beklediği büyük harf kullanımına uyacak şekilde yeniden adlandırın. Mod Steam Workshop'ta güncellenirse bu düzeltmenin üzerine yazılacağını unutmayın.
• Sorun modun kendisindeyse: Hatayı Steam Workshop sayfasında mod yazarına bildirin. Dosya referansının bir büyük harf uyuşmazlığına sahip olduğunu ve Linux sunucularında başarısız olduğunu belirtin. Birçok mod yazarı Linux büyük/küçük harf duyarlılığından haberdar değildir.
• Geçici bir çözüm olarak: Modun Workshop sayfası yorumlarını kontrol edin — diğer Linux sunucu operatörleri bir düzeltme veya modun uyumlu bir çatalını yayınlamış olabilir.

5. Mod Yükleme Sırası Sorunları

Project Zomboid, modları Mods= satırında göründükleri sırayla yükler. Bazı modlar diğer modların önce yüklenmesine bağımlıdır. Bir bağımlılık, onu gerektiren moddan sonra yüklenirse, bağımlı mod sessizce başarısız olabilir veya hatalara neden olabilir.

Belirtiler

• Mod özellikleri kısmen çalışır — bir moddan bazı öğeler veya sistemler mevcuttur ancak diğerleri eksiktir.
• Konsol, bir modun Lua betiklerine başvuran NullPointerException veya attempt to index a nil value hatalarını gösterir.
• Hatalar yalnızca belirli bir mod kombinasyonu yüklendiğinde görünür, ancak her mod ayrı ayrı iyi çalışır.

Nasıl Düzeltilir

1. Her modun Steam Workshop sayfasını bir "Required Mods" veya "Load Order" bölümü için kontrol edin. Birçok mod yazarı, kendilerinden önce hangi modların yüklenmesi gerektiğini belirtir.
2. /.cache/server/<servername>.ini dosyasını açın ve Mods= satırını bulun.
3. Girişleri, bağımlılık modları onları gerektiren modlardan önce görünecek şekilde yeniden sıralayın. Örneğin, Mod B Mod A'yı gerektiriyorsa, satır Mods=\ModA;\ModB; (B42 biçimi) şeklinde okunmalıdır.
4. Çerçeve ve kitaplık modları (ModFramework, TsarLib veya Shark's Mod Utils gibi) her zaman Mods= satırında ilk sırada listelenmelidir.
5. Dosyayı kaydedin ve sunucuyu yeniden başlatın.

6. Mod Ekledikten Sonra Sunucu Çökmeleri

Sunucunuz sorunsuz çalışıyordu ve bir veya daha fazla mod ekledikten sonra çöküyorsa, neden büyük olasılıkla yeni moddur. Bu bölüm, sorunlu modu izole etme adımlarını gösterir.

Adım Adım İzolasyon

1. GPanel'de sunucuyu durdurun.
2. Dosya Yöneticisinde /.cache/server/<servername>.ini dosyasını açın.
3. Az önce eklediğiniz tüm modları not edin. Hepsini hem Mods= hem de WorkshopItems= satırlarından kaldırın.
4. Sunucuyu başlatın. Başarıyla başlarsa, sorun kaldırdığınız modlardan birindedir.
5. Modları birer birer geri ekleyin ve her eklemeden sonra sunucuyu yeniden başlatın. Çökme geri döndüğünde, eklediğiniz son mod nedendir.
6. Tanımlandıktan sonra, modun Workshop sayfasını şunlar için kontrol edin:
   • B42 uyumluluğu hakkında bir not — birçok B41 modu B42 için güncellenmemiştir.
   • Çalıştırdığınız diğer modlarla bilinen çakışmalar.
   • Yüklememiş olabileceğiniz gerekli bağımlılık modları.

Çökme Günlüğünü Okuma

İzolasyon işlemini gerçekleştirmeden önce çökme günlüğünü kontrol edin — genellikle doğrudan sorunlu moda işaret eder:

1. GPanel'de Console sekmesini açın ve çıktının sonuna kaydırın.
2. STACK TRACE, Exception veya ERROR satırlarını arayın.
3. Yığın izlemenin hemen üzerindeki satırlar genellikle bir mod dosya adına veya Mod ID'sine başvurur — bu, çökmeyi hangi modun tetiklediğini söyler.
4. Daha fazla ayrıntı için, SFTP aracılığıyla /.cache/Logs/ konumunda tam günlük dosyasını açın ve en son DebugLog-server.txt veya debug.log dosyasını kontrol edin.

7. Mod Sürüm Uyumsuzlukları (Sunucu vs İstemci)

Project Zomboid, sunucunun ve bağlı tüm istemcilerin her modun aynı sürümüne sahip olmasını gerektirir. Bir mod Steam Workshop'ta güncellenir ve sunucu yeni sürümü indirirse ancak bir oyuncu hâlâ eski sürümü önbelleğe alınmış halde tutarsa (veya tam tersi), bağlantı hataları veya çökmeler meydana gelir.

Belirtiler

• Oyuncular bağlanmaya çalışırken bir "Mod mismatch" veya "Version mismatch" hatası alır.
• Bazı oyuncular bağlanabilir ancak diğerleri bağlanamaz — bağlanamayanlar yerel olarak farklı bir mod sürümünü önbelleğe almıştır.
• Sunucu sorunsuz çalışıyordu, ardından bir mod Steam Workshop'ta güncellendi ve aniden bazı oyuncular katılamadı.
• Oyuncular, yakın zamanda güncellenen modlardan eksik dokular, öğeler veya bozuk arayüz öğeleri görür.

Sunucu Operatörleri için Düzeltme

1. GPanel'de sunucuyu durdurun.
2. Sunucuyu tekrar başlatın. Başlangıçta sunucu, tüm Workshop modlarının en son sürümlerini yeniden indirir. Bu, sunucunun en yeni sürümü çalıştırdığını garanti eder.
3. Sunucu hâlâ eski bir sürümü önbelleğe alıyorsa, SFTP aracılığıyla bağlanın ve belirli modun Workshop önbellek klasörünü /steamapps/workshop/content/108600/<WorkshopID>/ konumunda silin. Temiz bir indirmeyi zorlamak için sunucuyu yeniden başlatın.

Oyuncular için Düzeltme

Mod sürüm uyumsuzlukları nedeniyle bağlanamayan oyuncular şunları yapmalıdır:

1. Steam'i açın ve Library → Project Zomboid'a gidin.
2. Project Zomboid'a sağ tıklayın, Properties → Local Files → Verify Integrity of Game Files'ı seçin.
3. Ayrıca yerel makinelerindeki Project Zomboid Steam Workshop klasörüne gidin ve yeniden indirmeyi zorlamak için önbelleğe alınmış mod dosyalarını silin.
4. Oyunu başlatın ve sunucuya tekrar bağlanın.

8. Steam Workshop Önbelleğini Temizleme

Birden çok mod sorunu devam ediyorsa ve Workshop indirme önbelleğinin bozuk olduğundan şüpheleniyorsanız, tüm Workshop modlarının tam bir yeniden indirilmesini zorlayabilirsiniz.

1. GPanel'de sunucuyu durdurun.
2. SFTP aracılığıyla bağlanın ve /steamapps/workshop/ dizinine gidin.
3. Tüm workshop/ klasörünü (veya içeriğini) silin.
4. Sunucuyu başlatın. Steam tüm Workshop öğelerini sıfırdan yeniden indirecektir.
5. Sunucu dünya yüklemeye başlamadan önce tüm modların indirmeyi bitirdiğini doğrulamak için GPanel Konsolunu izleyin.

Hızlı Teşhis Referansı

Hâlâ Mod Sorunları mı Yaşıyorsunuz?