Bu kılavuz, Legion Hosting ile barındırılan Project Zomboid sunucunuza Steam Workshop modlarını kurma sürecinde size yol gösterir. B42 ve B41 mod formatlarını, Legion Hosting Mod Organizer aracını, büyük mod paketleri için uyumluluk notlarını ve mod kaynaklı yaygın dünya bozulmalarından nasıl kurtulacağınızı kapsar.

Ön Koşullar

• gpanel.legionhosting.net adresinden erişilebilen, Legion Hosting ile aktif bir Project Zomboid sunucusu
• Mod ayarlarını düzenlemeden önce sunucunuz Offline olmalıdır — önce GPanel'de durdurun
• Kurmak istediğiniz her mod için Steam Workshop ID(leri) ve Mod ID(leri) (her modun Steam Workshop sayfasında bulunur)
• Mevcut dünya kaydınızın bir yedeği (kesinlikle önerilir — yukarıdaki uyarıya bakın)

Adım 1 — Her Mod için Workshop ID ve Mod ID'yi Bulun

Kurmak istediğiniz her mod, iki ayrı tanımlayıcı gerektirir:

• Workshop ID — Steam Workshop URL'sindeki sayısal ID, örn. https://steamcommunity.com/sharedfiles/filedetails/?id=2392987841
• Mod ID — mod yazarı tarafından tanımlanan dahili ID, Workshop sayfasındaki modun açıklamasında bulunur, genellikle "Mod ID:" olarak listelenir veya modun mod.info dosyasının içinde yer alır

Devam etmeden önce her mod için her iki ID'yi de not edin. Tek bir Workshop öğesi bazen her biri kendi Mod ID'sine sahip birden fazla alt mod içerir.

Adım 2 — Legion Hosting Mod Organizer'ı Kullanın (Önerilir)

Mod listenizi oluşturmanın en kolay yolu Legion Hosting Zomboid Mod Organizer'dır. Workshop'ta arama yapmanıza, URL veya ID ile modlar eklemenize ve GPanel'e yapıştırmanız gereken doğru biçimlendirilmiş yapılandırma satırlarını otomatik olarak oluşturmanıza olanak tanır.

1. legionhosting.net/zomboid-mod-organizer.php adresine gidin.
2. Modları ada göre arayın veya bir Steam Workshop URL'sini arama kutusuna yapıştırın.
3. Add düğmesini kullanarak her modu listenize ekleyin.
4. Listeniz tamamlandığında, Generate Config'e tıklayın. Araç, sunucunuzun build sürümü için biçimlendirilmiş, kullanıma hazır WorkshopItems ve Mods satırları çıktısı verir.
5. Oluşturulan satırları kopyalayın ve bunları sunucu ayarlarınıza yapıştırmak için Adım 4'e geçin.

ID'leri manuel olarak girmeyi tercih ederseniz, bunları build sürümünüz için doğru biçimlendirmek üzere Adım 3 ile devam edin.

Adım 3 — Mod Listesini Doğru Biçimlendirin

WorkshopItems (tüm build'ler için aynı)

WorkshopItems satırı, Workshop ID'lerini ayırmak için bir noktalı virgül kullanır. Bu format hem B41 hem de B42 için aynıdır:

Mods — Build 42 (B42) Formatı

B42, her Mod ID'sinin önünde bir ters eğik çizgi öneki (\) kullanır:

DLMP Formatı (B42)

Bazı yapılandırmalar, Workshop ID'lerini ve Mod ID'lerini tek bir alanda ters eğik çizgiyle birleştiren DLMP formatını kullanır:

Mods — Build 41 (B41) Formatı

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

Adım 4 — Mod Listesini Sunucu Ayarları Dosyanızda Uygulayın

1. GPanel'e giriş yapın ve Project Zomboid sunucunuzu seçin.
2. Sunucunun Offline olduğundan emin olun. Gerekirse durdurun.
3. File Manager'ı açın ve /.cache/server/ dizinine gidin.
4. Sunucu ayarları dosyanızı açın — adı <servername>.ini şeklindedir (örn. servertest.ini).
5. Dosyadaki WorkshopItems= ve Mods= satırlarını bulun. Adım 2'de oluşturduğunuz veya Adım 3'te biçimlendirdiğiniz değerleri yapıştırın.
6. Dosyayı kaydedin.
7. Sunucuyu başlatın. Steam Workshop indirmeleri başlangıçta otomatik olarak başlayacaktır.

Adım 5 — Modları Kademeli Olarak Ekleyin ve Test Edin

Özellikle aktif bir sunucuda veya büyük bir koleksiyonla çalışırken, istediğiniz tüm mod listesini tek seferde eklemeyin. Bunun yerine:

1. Bir seferde en fazla 3–5 mod ekleyin.
2. Sunucuyu başlatın ve Running durumuna ulaştığını ve bağlanıp oynayabildiğinizi onaylayın.
3. Bir sonraki grubu eklemeden önce GPanel Konsolunu herhangi bir hata mesajı veya yığın izi (stack trace) açısından kontrol edin.
4. Tüm modlar yüklenip kararlı hale gelene kadar tekrarlayın.

Bu yaklaşım, bir şeyler ters giderse hangi modun soruna neden olduğunu belirlemeyi çok daha kolay hale getirir.

Workshop Dışı Modları Kurma

Steam Workshop'ta olmayan (bir klasör veya ZIP dosyası olarak indirilen) bir modunuz varsa, bunu SFTP aracılığıyla sunucunuzdaki aşağıdaki yola yükleyin:

Modun klasörünü (bir mod.info dosyası içermelidir) doğrudan /.cache/mods/ içine yerleştirin. Bu dizine, GPanel'de SFTP sekmesinde gösterilen SFTP kimlik bilgilerini kullanarak erişebilirsiniz. Yükledikten sonra, Adım 4'te açıklandığı gibi Mod ID'yi (modun mod.info dosyasından) sunucu yapılandırmanızdaki Mods= satırına ekleyin. Workshop dışı modlar için Workshop ID gerekmez.

Authentic Z Uyumluluk Notu

Authentic Z, en popüler Project Zomboid mod paketlerinden biridir, ancak birçok alt moddan oluşur. Bir seferde yalnızca bir alt mod kurun ve çok oyunculu sunucular için önerilen alt mod şudur:

Aynı sunucuda birden fazla Authentic Z alt modunu aynı anda etkinleştirmeyin. Bu koleksiyondan birden fazla alt mod çalıştırmak, sunucuyu çökertebilecek veya ganimet (loot) tablolarını bozabilecek çakışmalara neden olur. Hangi alt modun aktif olduğundan emin değilseniz, yapılandırmanızdaki Mods= satırını kontrol edin ve yalnızca Authentic Z - Current (veya seçtiğiniz tek alt mod) listelendiğinden emin olun.

Doğrulama

Sunucuyu yeni modlarınızla başlattıktan sonra, başarıyla yüklendiklerini onaylayın:

1. GPanel'de Console sekmesini açın ve başlangıç günlüğünü izleyin. Yüklenen her moda atıfta bulunan satırları arayın — kurulu her mod için [ModLoader] Loading mod: ModID gibi bir şey görmelisiniz.
2. Oyun içinde sunucuya bağlanın ve ana menüden Mods menüsünü açın (Esc → Mods). Kurulu modlar listede görünmelidir.
3. Konsol günlüğünde STACK TRACE ifadesini arayın. Hiçbiri görünmüyorsa, sunucu temiz bir şekilde başlamıştır. Bir tane görürseniz, izin üst kısmına yakın bahsedilen modu not edin — o mod sorunun olası nedenidir.
4. Oyun içinde dolaşın ve mod tarafından eklenen içeriğin (eşyalar, binalar, zombiler) beklendiği gibi göründüğünü onaylayın.

Sorun Giderme

Modlar yüklenmiyor / sunucu başlıyor ancak modlar etkin değil gibi görünüyor

• Mods satırının build'iniz için doğru formatı kullandığını doğrulayın — B42 için ters eğik çizgi öneki (\ModID), B41 için düz Mod ID'leri. WorkshopItems formatı her iki build için de aynıdır.
• Mods= satırındaki Mod ID'nin, modun Workshop açıklamasında veya mod.info dosyasında gösterilen ID ile tam olarak eşleştiğini onaylayın. Mod ID'leri büyük/küçük harfe duyarlıdır.
• Hem WorkshopItems hem de Mods alanlarının kaydedildiğini kontrol edin — değerlerin kalıcı olduğunu doğrulamak için GPanel'de başka bir yere gidip geri dönün.

Steam Workshop indirmesi başarısız oluyor / modlar başlangıçta indirilmiyor

Sunucu başlıyor ancak Workshop modları indirilmiyor gibi görünüyorsa, Steam önbellek klasörü bozulmuş olabilir. Bunu düzeltmek için:

1. Sunucuyu GPanel'de 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 tekrar başlatın. Steam, tüm Workshop öğelerini sıfırdan yeniden indirecektir.

WorldDictionaryException / dünya sözlüğü bozulması

Konsol günlüğü bir WorldDictionaryException hatası gösteriyorsa, dünya sözlüğü bozulmuştur — bu, yeni eşyalar veya döşemeler ekleyen modlar eklerken veya kaldırırken olabilir.

Kurtarmayı denemeniz gerekiyorsa:

1. Sunucuyu GPanel'de durdurun.
2. Tüm kayıt klasörünüzü SFTP veya GPanel Yedeklemeleri aracılığıyla yedekleyin.
3. SFTP aracılığıyla bağlanın ve /.cache/saves/multiplayer/<YourWorldName>/ dizinine gidin.
4. WorldDictionary.bin dosyasını silin.
5. Sunucuyu başlatın. Project Zomboid, başlangıçta sözlüğü yeniden oluşturacaktır.
6. Bozuk eşyalar veya araçlar için oyun içinde kontrol edin. Dünya ciddi şekilde bozulduysa, 2. adımda oluşturduğunuz yedekten geri yükleyin.

Sunucu, konsol günlüğünde STACK TRACE ile başlangıçta çöküyor

Başlatmanın hemen ardından gelen bir yığın izi (stack trace), genellikle bir mod çakışmasını veya mevcut build sürümünüzle uyumsuz bir modu gösterir. Teşhis etmek için:

1. GPanel'de Console günlüğünü açın ve STACK TRACE arayın.
2. Bahsedilen mod dosya adı veya Mod ID için izin üzerindeki satırları okuyun — bu genellikle sorunlu moddur.
3. O modu hem WorkshopItems hem de Mods satırlarından kaldırın, kaydedin ve sunucuyu yeniden başlatın.
4. Kaldırma işleminden sonra sunucu temiz bir şekilde başlarsa, modun Workshop sayfasını B42 uyumlu bir güncelleme veya yorumlarda bilinen bir çakışma notu açısından kontrol edin.

GPanel konsolunun gösterdiğinden daha fazla ayrıntı için tam debug.log dosyasını SFTP aracılığıyla /.cache/Logs/<date>_DebugLog-server.txt konumunda da açabilirsiniz.

Belirli modlara sahip oyuncular bağlandığında sunucu çöküyor

Sunucu temiz bir şekilde çalışıyor ancak bir oyuncu katıldığında çöküyorsa, oyuncunun sunucuyla çakışan istemci tarafı modları olabilir. Oyuncudan oyun içi Mods menüsünden tüm yerel Project Zomboid modlarını devre dışı bırakmasını ve tekrar bağlanmayı denemesini isteyin. Çökme durursa, oyuncu çakışan modu bulmak için modları birer birer yeniden etkinleştirmelidir.

Mod kaldırıldı ancak sunucu hâlâ onu yüklemeye çalışıyor

Bir modun ID'sini yapılandırmadan kaldırdıysanız ancak sunucu başlangıçta hâlâ ona başvuruyorsa, Workshop öğesi hâlâ önbelleğe alınmış olabilir. Belirli Workshop öğesi klasörünü SFTP aracılığıyla /steamapps/workshop/content/108600/<workshopID>/ konumundan silin, ardından sunucuyu yeniden başlatın.