Tämä opas käsittelee Legion Hostingin isännöimien Project Zomboid -palvelinten edistynyttä modien vianmääritystä. Jos et ole vielä asentanut modeja, aloita ensin modien perusasennusoppaasta. Tämä artikkeli käsittelee yleisimmät modeihin liittyvät ongelmat, joita esiintyy Legion Hostingin tukipyynnöissä, mukaan lukien WorldDictionary-korruptio, modien muotovirheet, latausjärjestyksen ristiriidat ja versioerot palvelimen ja asiakasohjelman välillä.

Ennen kuin aloitat

• Kirjaudu GPanel-paneeliin ja valitse Project Zomboid -palvelimesi.
• Pysäytä palvelimesi ennen kuin teet mitään määritys- tai tiedostomuutoksia.
• Varmuuskopioi maailmasi tallennuskansio (/.cache/saves/multiplayer/) SFTP:n tai GPanelin kautta ennen minkään korjauksen yrittämistä. Katso SFTP-opas, jos tiedostosiirrot eivät ole sinulle tuttuja.
• Pidä palvelimesi .ini-tiedoston polku valmiina: /.cache/server/<servername>.ini (esim. servertest.ini).

1. Modien muotovirheet (B42 vs B41)

Yleisin syy modien latauksen epäonnistumiseen on virheellinen muoto palvelimesi .ini-tiedoston Mods=-rivillä. Build 42 ja Build 41 käyttävät eri syntaksia, ja niiden sekoittaminen aiheuttaa modien latauksen epäonnistumisen hiljaisesti.

B42-muoto (nykyinen oletus)

Build 42 vaatii kenoviivaetuliitteen ennen jokaista Mod ID:tä Mods=-rivillä:

Mods=\ModID1;\ModID2;\ModID3;

DLMP-muoto yhdistää Workshop ID:t ja Mod ID:t kenoviivaerottimella:

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

WorkshopItems=-rivi käyttää samaa puolipisteellä erotettua muotoa molemmissa buildeissa:

WorkshopItems=2392987841;1550458773;2786383654

B41-muoto (vanha)

Build 41 käyttää tavallisia puolipisteellä erotettuja Mod ID:itä ilman kenoviivaa:

Mods=ModID1;ModID2;ModID3

Kuinka korjata

1. Avaa /.cache/server/<servername>.ini GPanelin tiedostonhallinnassa.
2. Etsi Mods=-rivi ja tarkista muoto yllä olevia esimerkkejä vasten.
3. Jos muoto on väärä buildversiollesi, korjaa se. Käytä Legion Hosting Mod Organizeria luodaksesi oikein muotoillut rivit automaattisesti.
4. Tallenna tiedosto ja käynnistä palvelin.

2. WorldDictionary-korruptio

WorldDictionary on tiedosto (WorldDictionary.bin), joka liittää esineiden nimet sisäisiin numeerisiin ID:ihin. Kun modeja lisätään tai poistetaan, sanakirja voi korruptoitua, mikä aiheuttaa palvelimen kaatumisen käynnistyksessä virheellä WorldDictionaryException.

Oireet

• Konsoli tai debug.log näyttää WorldDictionaryException- tai WorldDictionary-virheitä.
• Palvelin kaatuu välittömästi käynnistyksen aikana, erityisesti maailman latauksen aikana.
• Kaatuminen alkoi modien lisäämisen, poistamisen tai päivittämisen jälkeen.

Riskin ymmärtäminen

Palautusvaiheet

1. Pysäytä palvelimesi GPanelissa.
2. Varmuuskopioi koko tallennuskansiosi SFTP:n kautta: lataa koko /.cache/saves/multiplayer/<YourWorldName>/-hakemisto paikalliselle koneellesi.
3. Yritä ensin yksinkertaisesti peruuttaa modimuutos, joka aiheutti virheen. Jos juuri lisäsit modin, poista se sekä Mods=- että WorkshopItems=-riveiltä .ini-tiedostossa. Jos juuri poistit modin, lisää se takaisin. Käynnistä palvelin ja katso, ratkesiko kaatuminen.
4. Jos modimuutoksen peruuttaminen ei toimi, yhdistä SFTP:n kautta ja siirry kansioon /.cache/saves/multiplayer/<YourWorldName>/.
5. Poista WorldDictionary.bin.
6. Käynnistä palvelin. Project Zomboid luo sanakirjan uudelleen käynnistyksessä.
7. Liity palvelimelle ja tarkasta maailma korruptoituneiden esineiden, kadonneiden ajoneuvojen tai rikkinäisten varastojen varalta. Jos maailma on vakavasti vaurioitunut, palauta vaiheessa 2 luomastasi varmuuskopiosta.

3. Authentic Z -modin ristiriidat

Authentic Z on yksi suosituimmista Project Zomboid -modikokoelmista, mutta se on usein toistuva tukipyyntöjen lähde, koska se sisältää useita alimodeja, jotka ovat ristiriidassa keskenään.

Sääntö

Yleiset virheet

• Sekä Authentic Z - Current- että Authentic Z - Litemode-modien lisääminen samanaikaisesti.
• Yksinpeliin suunniteltujen Authentic Z -alimodien lisääminen moninpeliversion rinnalle.
• Ei ymmärretä, että eri Authentic Z -alimodit jakavat saman Workshop ID:n mutta niillä on eri Mod ID:t, joten Workshop-lataus onnistuu mutta palvelin lataa ristiriitaisia moditiedostoja.

Kuinka korjata

1. Avaa /.cache/server/<servername>.ini GPanelin tiedostonhallinnassa.
2. Etsi Mods=-riviltä jokainen merkintä, joka sisältää Authentic tai AuthenticZ.
3. Säilytä vain yksi Authentic Z -alimodi (suositus: Authentic Z - Current). Poista kaikki muut Authentic Z -merkinnät sekä Mods=- että WorkshopItems=-riveiltä.
4. Tallenna tiedosto ja käynnistä palvelin uudelleen.

4. Linuxin kirjainkoon herkkyysongelmat

Legion Hostingin palvelimet toimivat Linuxilla, jossa tiedostojen ja kansioiden nimet ovat kirjainkokoherkkiä. Tiedostoa nimeltä MyMod.lua ja mymod.lua käsitellään kahtena täysin eri tiedostona. Tämä aiheuttaa ongelmia, kun modien tekijät kehittävät Windowsilla (kirjainkokoa erottelematon) ja heidän modinsa sisältävät yhteensopimattomia tiedostoviittauksia.

Oireet

• Modi toimii täydellisesti yksinpelissä Windows-tietokoneellasi mutta epäonnistuu palvelimella.
• Konsoli tai debug.log näyttää FileNotFoundException- tai can't find file -virheitä, jotka viittaavat modin sisällä olevaan Lua-skriptiin tai tekstuuriin.
• Virhe osoittaa tiedostoon, joka kyllä on olemassa modikansiossa, mutta eri kirjainkoolla (esim. koodi viittaa Items.txt-tiedostoon mutta varsinainen tiedosto on nimeltään items.txt).

Kuinka diagnosoida

1. Tarkista konsolista tai /.cache/Logs/-lokitiedostoista tarkka tiedostopolku, joka mainitaan virheessä.
2. Yhdistä SFTP:n kautta ja siirry modin kansioon polussa /steamapps/workshop/content/108600/<WorkshopID>/.
3. Vertaa levyllä olevia tiedostonimiä virheilmoituksessa viitattuun tiedostonimeen. Etsi kirjainkokoeroja.

Kuinka korjata

• Jos voit nimetä tiedoston uudelleen: Yhdistä SFTP:n kautta ja nimeä tiedosto uudelleen vastaamaan modin koodin odottamaa kirjainkokoa. Huomaa, että tämä korjaus ylikirjoittuu, jos modi päivittyy Steam Workshopissa.
• Jos ongelma on itse modissa: Ilmoita bugista modin tekijälle Steam Workshop -sivulla. Mainitse, että tiedostoviittauksessa on kirjainkokoristiriita ja että se epäonnistuu Linux-palvelimilla. Monet modien tekijät eivät ole tietoisia Linuxin kirjainkokoherkkyydestä.
• Kiertotapana: Tarkista modin Workshop-sivun kommentit — muut Linux-palvelinten ylläpitäjät ovat saattaneet julkaista korjauksen tai yhteensopivan modin haaran.

5. Modien latausjärjestyksen ongelmat

Project Zomboid lataa modit siinä järjestyksessä, jossa ne esiintyvät Mods=-rivillä. Jotkut modit riippuvat siitä, että muut modit ladataan ensin. Jos riippuvuus ladataan sen modin jälkeen, joka sitä vaatii, riippuvainen modi voi epäonnistua hiljaisesti tai aiheuttaa virheitä.

Oireet

• Modin ominaisuudet toimivat osittain — jotkut modin esineet tai järjestelmät ovat läsnä mutta toiset puuttuvat.
• Konsoli näyttää NullPointerException- tai attempt to index a nil value -virheitä, jotka viittaavat modin Lua-skripteihin.
• Virheitä esiintyy vain, kun tietty modiyhdistelmä on asennettuna, mutta jokainen modi toimii hyvin yksinään.

Kuinka korjata

1. Tarkista jokaisen modin Steam Workshop -sivulta "Required Mods"- tai "Load Order" -osio. Monet modien tekijät määrittävät, mitkä modit on ladattava ennen heidän modiaan.
2. Avaa /.cache/server/<servername>.ini ja etsi Mods=-rivi.
3. Järjestä merkinnät uudelleen niin, että riippuvuusmodit esiintyvät ennen niitä vaativia modeja. Esimerkiksi, jos Mod B vaatii Mod A:n, rivin tulisi olla Mods=\ModA;\ModB; (B42-muoto).
4. Kehys- ja kirjastomodit (kuten ModFramework, TsarLib tai Shark's Mod Utils) tulisi aina listata ensimmäisinä Mods=-rivillä.
5. Tallenna tiedosto ja käynnistä palvelin uudelleen.

6. Palvelin kaatuu modien lisäämisen jälkeen

Jos palvelimesi toimi hyvin ja kaatuu yhden tai useamman modin lisäämisen jälkeen, uusi modi on todennäköisesti syy. Tämä osio opastaa ongelmamodin eristämisessä.

Vaiheittainen eristäminen

1. Pysäytä palvelin GPanelissa.
2. Avaa /.cache/server/<servername>.ini tiedostonhallinnassa.
3. Merkitse muistiin kaikki juuri lisäämäsi modit. Poista ne kaikki sekä Mods=- että WorkshopItems=-riveiltä.
4. Käynnistä palvelin. Jos se käynnistyy onnistuneesti, ongelma on yhdessä poistamistasi modeista.
5. Lisää modit takaisin yksi kerrallaan, käynnistäen palvelin uudelleen jokaisen lisäyksen jälkeen. Kun kaatuminen palaa, viimeisin lisäämäsi modi on syy.
6. Kun se on tunnistettu, tarkista modin Workshop-sivulta:
   • Huomautus B42-yhteensopivuudesta — monia B41-modeja ei ole päivitetty B42:lle.
   • Tunnetut ristiriidat muiden ajamiesi modien kanssa.
   • Vaaditut riippuvuusmodit, joita et ehkä ole asentanut.

Kaatumislokin lukeminen

Ennen eristysprosessin suorittamista tarkista kaatumisloki — se osoittaa usein suoraan ongelmamodiin:

1. Avaa GPanelissa Console-välilehti ja vieritä tulosteen loppuun.
2. Etsi STACK TRACE-, Exception- tai ERROR-rivejä.
3. Pinojäljen yläpuolella olevat rivit viittaavat tyypillisesti modin tiedostonimeen tai Mod ID:hen — tämä kertoo, mikä modi laukaisi kaatumisen.
4. Saadaksesi lisätietoja avaa täysi lokitiedosto SFTP:n kautta polussa /.cache/Logs/ ja tarkista uusin DebugLog-server.txt- tai debug.log-tiedosto.

7. Modien versioerot (palvelin vs asiakas)

Project Zomboid vaatii, että palvelimella ja kaikilla yhdistetyillä asiakasohjelmilla on sama versio jokaisesta modista. Jos modi päivittyy Steam Workshopissa ja palvelin lataa uuden version, mutta pelaajalla on edelleen vanha versio välimuistissa (tai päinvastoin), yhteysvirheitä tai kaatumisia tapahtuu.

Oireet

• Pelaajat saavat "Mod mismatch"- tai "Version mismatch" -virheen yrittäessään yhdistää.
• Jotkut pelaajat voivat yhdistää mutta toiset eivät — ne, jotka eivät voi yhdistää, ovat tallentaneet eri modiversion paikallisesti.
• Palvelin toimi hyvin, sitten modi päivittyi Steam Workshopissa ja yhtäkkiä jotkut pelaajat eivät voi liittyä.
• Pelaajat näkevät puuttuvia tekstuureja, esineitä tai rikkinäisiä käyttöliittymäelementtejä hiljattain päivitetyistä modeista.

Korjaus palvelinten ylläpitäjille

1. Pysäytä palvelin GPanelissa.
2. Käynnistä palvelin uudelleen. Käynnistyksessä palvelin lataa uudelleen kaikkien Workshop-modien uusimmat versiot. Tämä varmistaa, että palvelin ajaa uusinta versiota.
3. Jos palvelimella on edelleen vanha versio välimuistissa, yhdistä SFTP:n kautta ja poista tietyn modin Workshop-välimuistikansio polussa /steamapps/workshop/content/108600/<WorkshopID>/. Käynnistä palvelin uudelleen pakottaaksesi puhtaan latauksen.

Korjaus pelaajille

Pelaajien, jotka eivät voi yhdistää modien versioerojen vuoksi, tulisi:

1. Avata Steam ja siirtyä kohtaan Library → Project Zomboid.
2. Napsauttaa Project Zomboidia hiiren oikealla painikkeella, valita Properties → Local Files → Verify Integrity of Game Files.
3. Siirtyä myös Project Zomboidin Steam Workshop -kansioon paikallisella koneellaan ja poistaa välimuistissa olevat moditiedostot pakottaakseen uudelleenlatauksen.
4. Käynnistää peli ja yhdistää palvelimelle uudelleen.

8. Steam Workshop -välimuistin tyhjentäminen

Jos useita modiongelmia jatkuu ja epäilet, että Workshop-latausvälimuisti on korruptoitunut, voit pakottaa kaikkien Workshop-modien täydellisen uudelleenlatauksen.

1. Pysäytä palvelin GPanelissa.
2. Yhdistä SFTP:n kautta ja siirry kansioon /steamapps/workshop/.
3. Poista koko workshop/-kansio (tai sen sisältö).
4. Käynnistä palvelin. Steam lataa uudelleen kaikki Workshop-kohteet alusta alkaen.
5. Tarkkaile GPanelin konsolia varmistaaksesi, että kaikki modit latautuvat valmiiksi ennen kuin palvelin aloittaa maailman latauksen.

Nopea diagnostiikkaopas

Yhä modiongelmia?