Project Zomboid Mods installeren - Workshop Guide

Project-Zomboid-mods installeer je op een server via de server.ini: je voert de numerieke Steam-Workshop-ID's in bij WorkshopItems en de interne Mod-ID's bij Mods, sorteert afhankelijkheden correct en herstart de server. Daarna downloaden spelers de benodigde Workshop-content automatisch via Steam wanneer ze verbinden.

Vereisten

Je hebt toegang nodig tot de configuratiebestanden van je Project-Zomboid-server, idealiter met bestandseditor, herstartfunctie en serverlogs. Bij betaalde multi-game-hosting zoals game-serverhosting is vooral belangrijk dat je wijzigingen traceerbaar opslaat, de herstart gecontroleerd uitvoert en bij problemen logs kunt controleren of concrete foutmeldingen aan support kunt doorgeven.

Daarnaast heb je de modpagina's in de officiële Steam Workshop voor Project Zomboid nodig. Deze bron is leidend voor Workshop-ID's, beschrijvingen, afhankelijkheden en update-informatie van de betreffende Workshop-items. Controleer daar vóór de installatie altijd of een mod als compatibel met jouw spelversie en bestaande mods wordt beschreven.

Als je eerst de server zelf wilt instellen, past de interne guide voor een Project Zomboid Server huren en instellen. Voor vergelijkbare Workshop- en mod-workflows in andere games zijn ook de handleidingen voor ARK Mods via Steam Workshop en Factorio Mods op de server handig.

Steam-Workshop-mods installeren

1. Mods kiezen en ID's noteren

Open de gewenste mod in de Steam Workshop. De Workshop-ID is het getal in de URL van het Workshop-item. Noteer daarnaast de interne Mod-ID. Die staat vaak in de beschrijving van de mod, in installatie-instructies of in een sectie zoals Mod ID.

Belangrijk: Workshop-ID en Mod-ID zijn twee verschillende waarden. De Workshop-ID is numeriek, de Mod-ID is meestal een naam of technische aanduiding. Project Zomboid heeft beide gegevens nodig, zodat de server de Workshop-bestanden kan laden en de juiste mod kan activeren.

2. server.ini bewerken

Voer de waarden in je server.ini in. De bestaande structuur blijft daarbij hetzelfde: meerdere items worden met puntkomma's gescheiden.

WorkshopItems=2392987599;2778576730;2169435993
Mods=Arsenal(26)GunFighter;tsarslib;Brita

WorkshopItems bevat de Workshop-ID's, dus de getallen uit de Steam-Workshop-URL's. Mods bevat de interne modnamen. Beide lijsten moeten passen bij de geïnstalleerde modselectie en netjes gescheiden zijn. Als je een mod verwijdert, verwijder die dan consequent uit beide regels, zodat er geen verweesde items achterblijven.

3. Volgorde en afhankelijkheden controleren

Sommige mods vereisen andere mods. Zulke dependencies moeten mee worden geïnstalleerd. Als vuistregel geldt:

1. Libraries eerst, bijvoorbeeld tsarslib
2. Hoofdmods daarna
3. Patches en compatibility-mods als laatste

De concrete volgorde hangt af van de informatie van de betreffende mod-auteurs. Als een Workshop-pagina een bepaalde Load Order noemt, neem die instructie over. Ontbreekt een duidelijke aanwijzing, wijzig dan altijd maar een paar mods tegelijk en test daarna, in plaats van een grote modlijst ongecontroleerd over te nemen.

Mod-ID's vs. Workshop-ID's

Beide moeten correct worden bijgehouden. Een veelvoorkomende fout is alleen de Workshop-ID invoeren. Dan kan de server bestanden downloaden, maar is de eigenlijke mod niet netjes geactiveerd. Omgekeerd is een Mod-ID zonder Workshop-ID ook niet genoeg, omdat de server dan de Workshop-bron mist.

Voorbeeldmodlijst uit de uitgangssituatie

De volgende tabel bewaart de bestaande modvoorbeelden. Controleer vóór gebruik in de Steam Workshop of de items nog steeds passen bij jouw serverversie, spelversie en modcombinatie.

Server herstarten en resultaat controleren

Sla de server.ini op en herstart de server. Verbind daarna met een client die bij Steam is aangemeld. Als de modlijst correct is, vraagt Project Zomboid bij het verbinden de benodigde Workshop-content op of downloadt die automatisch.

Controleer daarna drie dingen: de server start zonder kritieke modfouten, de client kan joinen, en de verwachte content verschijnt in het spel. Bij kaartmods moet je daarnaast controleren of de wereld- of spawnconfiguratie bij de mod past. Bij bestaande werelden kunnen kaart-, voertuig- of lootmods afhankelijk van de mod alleen zichtbaar worden in nieuwe of nog niet verkende gebieden.

Troubleshooting

De server start niet na een modwijziging

Controleer eerst de laatst gewijzigde items in WorkshopItems en Mods. Verwijder bij wijze van test de laatst toegevoegde mod, herstart en lees de serverlogs. Veelvoorkomende oorzaken zijn ontbrekende dependencies, typefouten in Mod-ID's of een mod die niet bij de gebruikte spelversie past.

Spelers blijven bij het verbinden hangen in de moddownload

Laat de speler Project Zomboid en Steam volledig sluiten en opnieuw starten. Controleer ook of de mod nog beschikbaar is in de Workshop en of de Workshop-ID correct is ingevoerd. Als meerdere spelers getroffen zijn, zit de fout eerder in de serverlijst dan op één losse client.

Een mod wordt niet actief, hoewel die wordt gedownload

Dan is vaak de interne Mod-ID verkeerd of ontbreekt die. Vergelijk het item in Mods met de informatie op de Workshop-pagina. Let op haakjes, hoofdletters en speciale tekens, omdat Mod-ID's technische aanduidingen zijn en niet altijd overeenkomen met de zichtbare modtitel.

Na het verwijderen van een mod ontstaan fouten in de wereld

Sommige mods schrijven data naar savegames. Verwijder mods daarom niet ongecontroleerd uit productieve werelden. Maak vooraf een back-up en test de wijziging op een kopie of tijdens een onderhoudsmoment. Extra riskant zijn mods die kaarten, voertuigen, items, traits of craftingsystemen uitbreiden.

Controle, grenzen en veilige terugweg

De handleiding "Project Zomboid Mods installeren - Workshop Guide" geldt voor het servertype dat in het artikel wordt beschreven en de versiestand die op het controlemoment zichtbaar was. Menunamen, beschikbare versies, mod- of plugincompatibiliteit en benodigde resources kunnen na updates afwijken. Neem daarom geen waarden ongecontroleerd over naar een andere spel-, loader- of serverversie.

Maak vóór wijzigingen aan wereld, savegame, configuratie of uitbreidingen een back-up van de betrokken bestanden. Wijzig daarna slechts één samenhangende stap en controleer die met dezelfde client- en serverversie waarmee je later wilt spelen.

Een geslaagde losse test is geen garantie voor prestaties of beschikbaarheid. Wereldgrootte, mods, plugins, spelersaantal, netwerkroute en gelijktijdige belasting kunnen het resultaat veranderen. Documenteer versie, wijziging en testresultaat, zodat je latere afwijkingen kunt herleiden.

FAQ

Moeten spelers mods handmatig installeren?

Meestal downloaden spelers de benodigde Workshop-mods automatisch bij het verbinden, zolang de serverconfiguratie klopt en Steam de Workshop-content aanbiedt. Handmatige stappen kunnen nodig zijn als lokale Workshop-bestanden beschadigd zijn of Steam de download niet netjes bijwerkt.

Is alleen de Workshop-ID genoeg?

Nee. Voor een Project-Zomboid-server heb je normaal de Workshop-ID in WorkshopItems en de interne Mod-ID in Mods nodig. De Workshop-ID beschrijft de bron, de Mod-ID activeert de concrete content in het spel.

Waar vind ik de juiste Mod-ID?

De Mod-ID staat meestal op de betreffende Steam-Workshop-pagina in de beschrijving of in de installatie-instructies van de mod-auteur. Als er meerdere Mod-ID's worden genoemd, controleer dan goed welke variant je wilt activeren.

Kan ik veel mods tegelijk installeren?

Technisch is een lange modlijst mogelijk, maar voor stabiele wijzigingen is stap voor stap werken beter. Installeer een paar mods, herstart de server, test het joinen en controleer de logs. Zo vind je conflicten duidelijk sneller.

Wat doe ik bij modconflicten?

Beperk de modlijst tot een werkende kern en voeg mods daarna afzonderlijk of in kleine groepen weer toe. Let op dependencies, Load-Order-instructies en compatibility-patches van de mod-auteurs.