Bu təlimat Legion Hosting ilə yerləşdirilmiş Project Zomboid serverləri üçün qabaqcıl mod problemlərinin həllini əhatə edir. Əgər hələ modları quraşdırmamısınızsa, əvvəlcə əsas mod quraşdırma təlimatı ilə başlayın. Bu məqalə Legion Hosting dəstək biletlərində ən çox rast gəlinən mod problemlərini əhatə edir, o cümlədən WorldDictionary pozulması, mod format xətaları, yükləmə sırası konfliktləri və server ilə müştəri arasında versiya uyğunsuzluqları.

Başlamazdan Əvvəl

• GPanel-ə daxil olun və Project Zomboid serverinizi seçin.
• Hər hansı konfiqurasiya və ya fayl dəyişikliyi etməzdən əvvəl serverinizi dayandırın.
• Hər hansı düzəlişə cəhd etməzdən əvvəl dünya saxlama qovluğunuzu (/.cache/saves/multiplayer/) SFTP və ya GPanel vasitəsilə yedəkləyin. Fayl köçürmələri ilə tanış deyilsinizsə, SFTP təlimatına baxın.
• Serverinizin .ini fayl yolunu hazır saxlayın: /.cache/server/<servername>.ini (məsələn, servertest.ini).

1. Mod Format Xətaları (B42 vs B41)

Modların yüklənməməsinin ən çox yayılmış səbəbi serverinizin .ini faylındakı Mods= sətrində yanlış formatdır. Build 42 və Build 41 fərqli sintaksis istifadə edir və onları qarışdırmaq modlarınızın səssizcə yüklənməməsinə səbəb olacaq.

B42 Formatı (Cari Standart)

Build 42 Mods= sətrindəki hər Mod ID-dən əvvəl ters xətt prefiksi tələb edir:

Mods=\ModID1;\ModID2;\ModID3;

DLMP formatı Workshop ID-ləri və Mod ID-ləri ters xətt ayırıcısı ilə birləşdirir:

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

WorkshopItems= sətri hər iki versiyada eyni nöqtəli vergüllə ayrılmış formatdan istifadə edir:

WorkshopItems=2392987841;1550458773;2786383654

B41 Formatı (Köhnə)

Build 41 ters xətt olmadan sadə nöqtəli vergüllə ayrılmış Mod ID-lərdən istifadə edir:

Mods=ModID1;ModID2;ModID3

Necə Düzəltmək Olar

1. GPanel Fayl Menecerində /.cache/server/<servername>.ini faylını açın.
2. Mods= sətrini tapın və formatı yuxarıdakı nümunələrlə müqayisə edin.
3. Əgər format versiya üçün yanlışdırsa, düzəldin. Avtomatik olaraq düzgün formatlanmış sətrlər yaratmaq üçün Legion Hosting Mod Organizer-dən istifadə edin.
4. Faylı saxlayın və serveri başladın.

2. WorldDictionary Pozulması

WorldDictionary element adlarını daxili rəqəmsal ID-lərə uyğunlaşdıran bir fayldır (WorldDictionary.bin). Modlar əlavə ediləndə və ya silindikdə, lüğət pozula bilər və serverin başlanğıcda WorldDictionaryException xətası ilə çökməsinə səbəb olur.

Simptomlar

• Konsol və ya debug.log-da WorldDictionaryException və ya WorldDictionary xətaları göstərilir.
• Server başlanğıcda, xüsusilə dünya yükləmə zamanı dərhal çökür.
• Çökmə modların əlavə edilməsi, silinməsi və ya yenilənməsindən sonra başladı.

Riskin Başa Düşülməsi

Bərpa Addımları

1. GPanel-də serverinizi dayandırın.
2. Bütün saxlama qovluğunuzu SFTP vasitəsilə yedəkləyin: tam /.cache/saves/multiplayer/<YourWorldName>/ qovluğunu yerli kompüterinizə endirin.
3. Əvvəlcə xətaya səbəb olan mod dəyişikliyini sadəcə geri qaytarmağa çalışın. Əgər indicə bir mod əlavə etmisinizsə, onu həm Mods=, həm də WorkshopItems= sətirlərindən .ini faylında silin. Əgər indicə bir mod silmisinizsə, onu geri əlavə edin. Serveri başladın və çökmənin həll olunub-olunmadığını yoxlayın.
4. Mod dəyişikliyini geri qaytarmaq işləmirsə, SFTP vasitəsilə qoşulun və /.cache/saves/multiplayer/<YourWorldName>/ qovluğuna keçin.
5. WorldDictionary.bin faylını silin.
6. Serveri başladın. Project Zomboid başlanğıcda lüğəti yenidən yaradacaq.
7. Serverə qoşulun və dünyada pozulmuş elementlər, itmiş nəqliyyat vasitələri və ya xarab olmuş inventarlar üçün yoxlayın. Əgər dünya ciddi şəkildə zədələnibsə, 2-ci addımda yaratdığınız yedəkdən bərpa edin.

3. Authentic Z Mod Konfliktləri

Authentic Z ən populyar Project Zomboid mod kolleksiyalarından biridir, lakin tez-tez dəstək biletlərinə səbəb olur, çünki bir-biri ilə konflikt yaradan çoxlu alt-modlar ehtiva edir.

Qayda

Ümumi Səhvlər

• Eyni anda həm Authentic Z - Current, həm də Authentic Z - Litemode əlavə etmək.
• Multiplayer versiyası ilə birlikdə tək oyunçu üçün nəzərdə tutulmuş Authentic Z alt-modlarını əlavə etmək.
• Fərqli Authentic Z alt-modlarının eyni Workshop ID-ni paylaşdığını, lakin fərqli Mod ID-lərə sahib olduğunu bilməmək, buna görə Workshop endirmə uğurlu olur, lakin server konfliktli mod fayllarını yükləyir.

Necə Düzəltmək Olar

1. GPanel Fayl Menecerində /.cache/server/<servername>.ini faylını açın.
2. Mods= sətrində Authentic və ya AuthenticZ ehtiva edən hər girişi axtarın.
3. Yalnız bir Authentic Z alt-modunu saxlayın (tövsiyə olunan: Authentic Z - Current). Digər bütün Authentic Z girişlərini həm Mods=, həm də WorkshopItems= sətrlərindən silin.
4. Faylı saxlayın və serveri yenidən başladın.

4. Linux Böyük-Kiçik Hərf Həssaslığı Problemləri

Legion Hosting serverləri Linux üzərində işləyir, burada fayl və qovluq adları böyük-kiçik hərfə həssasdır. MyMod.lua adlı fayl ilə mymod.lua tamamilə fərqli iki fayl kimi qəbul edilir. Bu, mod müəllifləri Windows-da (böyük-kiçik hərfə həssas deyil) inkişaf etdirdikdə və modları uyğunsuz fayl istinadları ehtiva etdikdə problem yaradır.

Simptomlar

• Mod Windows kompüterinizdə tək oyunçu rejimində mükəmməl işləyir, lakin serverdə uğursuz olur.
• Konsol və ya debug.log-da mod daxilindəki Lua skripti və ya teksturaya istinad edən FileNotFoundException və ya can't find file xətaları göstərilir.
• Xəta mod qovluğunda mövcud olan bir fayla işarə edir, lakin fərqli böyük-kiçik hərf yazılışı ilə (məsələn, kod Items.txt-ə istinad edir, amma əsl fayl adı items.txt-dir).

Necə Diaqnostika Etmək Olar

1. Xəta mesajında qeyd olunan dəqiq fayl yolu üçün konsolu və ya /.cache/Logs/ log fayllarını yoxlayın.
2. SFTP vasitəsilə qoşulun və modun qovluğuna /steamapps/workshop/content/108600/<WorkshopID>/ keçin.
3. Diskdəki fayl adlarını xəta mesajında istinad edilən fayl adı ilə müqayisə edin. Böyük-kiçik hərf fərqlərinə baxın.

Necə Düzəltmək Olar

• Əgər faylın adını dəyişə bilirsinizsə: SFTP vasitəsilə qoşulun və faylın adını modun kodunun gözlədiyi böyük-kiçik hərflərə uyğunlaşdırın. Qeyd edək ki, bu düzəliş mod Steam Workshop-da yeniləndikdə üzərinə yazılacaq.
• Əgər problem modun özündədirsə: Steam Workshop səhifəsində mod müəllifinə xətanı bildirin. Fayl istinadının böyük-kiçik hərf uyğunsuzluğu olduğunu və bunun Linux serverlərdə uğursuz olduğunu qeyd edin. Bir çox mod müəllifi Linux böyük-kiçik hərf həssaslığından xəbərsizdir.
• Müvəqqəti həll olaraq: Modun Workshop səhifəsinin şərhlərini yoxlayın — digər Linux server operatorları düzəliş və ya modun uyğun forku paylaşmış ola bilər.

5. Mod Yükləmə Sırası Problemləri

Project Zomboid modları Mods= sətrində göründükləri sıra ilə yükləyir. Bəzi modlar digər modların əvvəlcə yüklənməsini tələb edir. Əgər asılılıq onu tələb edən moddan sonra yüklənərsə, asılı mod səssizcə uğursuz ola bilər və ya xətalara səbəb ola bilər.

Simptomlar

• Mod xüsusiyyətləri qismən işləyir — moddan bəzi elementlər və ya sistemlər mövcuddur, lakin digərləri yoxdur.
• Konsol modun Lua skriptlərinə istinad edən NullPointerException və ya attempt to index a nil value xətaları göstərir.
• Xətalar yalnız müəyyən mod kombinasiyası quraşdırıldıqda görünür, lakin hər mod ayrı-ayrılıqda yaxşı işləyir.

Necə Düzəltmək Olar

1. Hər modun Steam Workshop səhifəsində "Required Mods" və ya "Load Order" bölməsini yoxlayın. Bir çox mod müəllifi hansı modların onlarınkından əvvəl yüklənməli olduğunu göstərir.
2. /.cache/server/<servername>.ini faylını açın və Mods= sətrini tapın.
3. Girişləri elə yenidən sıralayın ki, asılılıq modları onları tələb edən modlardan əvvəl göstərilsin. Məsələn, əgər Mod B Mod A-nı tələb edirsə, sətir belə olmalıdır: Mods=\ModA;\ModB; (B42 formatı).
4. Framework və kitabxana modları (məsələn ModFramework, TsarLib və ya Shark's Mod Utils) həmişə Mods= sətrində birinci sıralanmalıdır.
5. Faylı saxlayın və serveri yenidən başladın.

6. Mod Əlavə Etdikdən Sonra Server Çökmələri

Əgər serveriniz yaxşı işləyirdi və bir və ya daha çox mod əlavə etdikdən sonra çökürsə, yeni mod çox güman ki, səbəbdir. Bu bölmə problem modunu təcrid etməyi izah edir.

Addım-Addım Təcrid

1. GPanel-də serveri dayandırın.
2. Fayl Menecerində /.cache/server/<servername>.ini faylını açın.
3. Indicə əlavə etdiyiniz bütün modları qeyd edin. Hamısını həm Mods=, həm də WorkshopItems= sətrlərindən silin.
4. Serveri başladın. Əgər uğurla başlayırsa, problem silinmiş modlardan birindədir.
5. Modları bir-bir geri əlavə edin, hər əlavədən sonra serveri yenidən başladın. Çökmə geri qayıtdıqda, son əlavə etdiyiniz mod səbəbdir.
6. Müəyyən edildikdən sonra, modun Workshop səhifəsini yoxlayın:
   • B42 uyğunluğu haqqında qeyd — bir çox B41 modu B42 üçün yenilənməyib.
   • İşlətdiyiniz digər modlarla məlum konfliktlər.
   • Quraşdırmamış ola biləcəyiniz tələb olunan asılılıq modları.

Çökmə Logunun Oxunması

Təcrid prosesini həyata keçirməzdən əvvəl, çökmə logunu yoxlayın — çox vaxt birbaşa problem moduna işarə edir:

1. GPanel-də Console tabını açın və çıxışın sonuna sürüşdürün.
2. STACK TRACE, Exception və ya ERROR sətirlərini axtarın.
3. Stack trace-dən dərhal əvvəlki sətirlər adətən mod fayl adına və ya Mod ID-yə istinad edir — bu sizə hansı modun çökməyə səbəb olduğunu göstərir.
4. Daha ətraflı məlumat üçün SFTP vasitəsilə /.cache/Logs/ yolundakı tam log faylını açın və ən son DebugLog-server.txt və ya debug.log faylını yoxlayın.

7. Mod Versiya Uyğunsuzluqları (Server vs Müştəri)

Project Zomboid server və bütün qoşulan müştərilərin hər modun eyni versiyasına sahib olmasını tələb edir. Əgər mod Steam Workshop-da yenilənirsə və server yeni versiyanı endirirsə, amma oyunçu hələ köhnə versiyanı keşdə saxlayırsa (və ya əksinə), qoşulma uğursuzluqları və ya çökmələr baş verəcək.

Simptomlar

• Oyunçular qoşulmağa çalışarkən "Mod mismatch" və ya "Version mismatch" xətası alırlar.
• Bəzi oyunçular qoşula bilir, lakin digərləri qoşula bilmir — qoşula bilməyənlər yerli olaraq fərqli mod versiyası keşləyiblər.
• Server yaxşı işləyirdi, sonra Steam Workshop-da mod yeniləndi və birdən bəzi oyunçular qoşula bilmir.
• Oyunçular yaxınlarda yenilənmiş modlardan itən teksturalar, elementlər və ya xarab interfeys elementləri görürlər.

Server Operatorları üçün Həll

1. GPanel-də serveri dayandırın.
2. Serveri yenidən başladın. Başlanğıcda server bütün Workshop modlarının ən son versiyalarını yenidən endirir. Bu serverin ən yeni versiyanı işlətdiyini təmin edir.
3. Əgər serverdə hələ köhnə versiya keşlənibsə, SFTP vasitəsilə qoşulun və müəyyən modun Workshop keş qovluğunu /steamapps/workshop/content/108600/<WorkshopID>/ silin. Təmiz endirmə məcbur etmək üçün serveri yenidən başladın.

Oyunçular üçün Həll

Mod versiya uyğunsuzluğuna görə qoşula bilməyən oyunçular:

1. Steam-i açın və Library → Project Zomboid-a keçin.
2. Project Zomboid-a sağ klikləyin, Properties → Local Files → Verify Integrity of Game Files seçin.
3. Həmçinin yerli kompüterlərində Project Zomboid üçün Steam Workshop qovluğuna keçin və yenidən endirməyə məcbur etmək üçün keşlənmiş mod fayllarını silin.
4. Oyunu başladın və serverə yenidən qoşulun.

8. Steam Workshop Keşinin Təmizlənməsi

Əgər bir neçə mod problemi davam edir və Workshop endirmə keşinin pozulduğundan şübhələnirsinizsə, bütün Workshop modlarının tamamilə yenidən endirilməsini məcbur edə bilərsiniz.

1. GPanel-də serveri dayandırın.
2. SFTP vasitəsilə qoşulun və /steamapps/workshop/ qovluğuna keçin.
3. Bütün workshop/ qovluğunu (və ya məzmununu) silin.
4. Serveri başladın. Steam bütün Workshop elementlərini sıfırdan yenidən endirəcək.
5. Server dünya yükləməsinə başlamazdan əvvəl bütün modların endirilməsinin bitdiyini təsdiq etmək üçün GPanel Console-u izləyin.

Sürətli Diaqnostika Arayışı

Hələ də Mod Problemləriniz Var?