Mon serveur Project Zomboid ne démarre pas / crash

Votre serveur Project Zomboid refuse de démarrer, plante au lancement ou crash en cours de partie ? Ce guide passe en revue les causes les plus fréquentes — du manque de RAM aux mods désynchronisés — dans l’ordre où il faut les vérifier.

Avec un serveur Project Zomboid chez HebergTonServ, RAM, ports et version sont gérés, ce qui élimine la majorité des causes ci-dessous.

Étape 0 — Lire les logs (toujours commencer ici)

Le fichier qui contient la réponse 9 fois sur 10 :

Zomboid/server-console.txt

Cherchez les lignes ERROR, Exception, ou le message juste avant l’arrêt. Le reste de ce guide vous aide à interpréter ce que vous y trouvez.

Cas 1 — Crash `java.lang.OutOfMemoryError`

Le plus fréquent, surtout en Build 42. Le serveur dépasse la RAM allouée par le paramètre Java -Xmx.

Solution : augmentez Xmx dans ProjectZomboid64.json :

"vmArgs": [
    "-Xms8g",
    "-Xmx8g"
]

Build 42 demande ~6 Go de base + 500 Mo par joueur. Détails et tableaux : Combien de RAM pour un serveur Project Zomboid.

Ne jamais allouer toute la RAM de la machine : gardez 2 Go pour l’OS.

Cas 2 — Crash lié aux mods

Les mods sont la première cause de serveur qui ne démarre plus.

Problème	Solution
Mod mis à jour cassé	Tester en retirant les mods récents un par un
Mauvais ordre de chargement	Un mod dépend d’un autre placé après lui — corriger l’ordre
`Mods=` et `WorkshopItems=` désynchronisés	Chaque mod a un Workshop ID (téléchargement) ET un Mod ID (activation)

Pour tester : videz temporairement Mods= et WorkshopItems= dans servertest.ini. Si le serveur démarre, c’est bien un mod. Détails : Installer des mods Project Zomboid.

Après une mise à jour Steam, un mod peut devenir incompatible du jour au lendemain. Vérifiez la page Workshop du mod (commentaires récents).

Cas 3 — servertest.ini corrompu ou mal édité

Une erreur de syntaxe ou une valeur invalide empêche le démarrage.

Restaurez votre servertest.ini.bak si vous en avez un
Vérifiez les valeurs récemment modifiées (un caractère parasite, une ligne dupliquée)
Attention au nom de fichier : si vous avez lancé avec -servername MonServeur, c’est MonServeur.ini qui compte, pas servertest.ini

Détails : Configurer servertest.ini Project Zomboid.

Piège classique : éditer servertest.ini serveur allumé. PZ réécrit le fichier à l’arrêt et écrase vos modifs. Toujours arrêter le serveur avant.

Cas 4 — Le serveur démarre mais les joueurs ne peuvent pas se connecter

Vérification	Détail
Ports ouverts	UDP 16261 et 16262
Mods côté client	Les joueurs doivent avoir les mêmes mods que le serveur
Version identique	Serveur et clients sur la même build (41 vs 42)
Serveur plein	`MaxPlayers` atteint ou `DenyLoginOnOverloadedServer` actif

Build 41 vs Build 42 : un client Build 42 ne peut pas rejoindre un serveur Build 41 et inversement. Alignez les versions.

Cas 5 — Crash au chargement d’une carte custom

Une carte additionnelle mal installée plante le démarrage. Vérifiez l’ordre dans Map= et la présence du Workshop ID. Voir : Ajouter des cartes custom à un serveur Project Zomboid.

Checklist de diagnostic rapide

✅ Lire server-console.txt
✅ OutOfMemoryError → augmenter Xmx
✅ Tester sans mods (vider Mods= / WorkshopItems=)
✅ Vérifier le bon fichier .ini (nom du serveur)
✅ Ports UDP 16261 + 16262 ouverts
✅ Version serveur = version client (B41/B42)
✅ Restaurer un .bak si config corrompue

FAQ

Le serveur crash après quelques heures, pas au démarrage

Souvent une fuite mémoire liée aux mods qui sature progressivement le Xmx. Solution : plus de RAM et/ou redémarrage automatique quotidien.

« OutOfMemoryError » alors que j’ai beaucoup de RAM

Xmx est un plafond Java : tant que vous ne l’augmentez pas dans ProjectZomboid64.json, le serveur n’utilise pas la RAM disponible. Augmentez Xmx.

Comment savoir quel mod cause le crash ?

Videz tous les mods → le serveur démarre. Réactivez-les par moitié (méthode dichotomique) jusqu’à isoler le coupable.

Mes modifs de config disparaissent

Vous éditez serveur allumé. PZ réécrit le .ini à l’arrêt. Arrêtez d’abord le serveur, puis éditez.

Le serveur ne démarre plus après passage en Build 42

Build 42 a des besoins RAM bien supérieurs et certains mods B41 sont incompatibles. Augmentez la RAM et retirez les mods non compatibles B42. Voir : Passer son serveur en Build 42.

Conclusion

Quand un serveur Project Zomboid ne démarre pas : lisez server-console.txt, traitez l’OutOfMemoryError via Xmx, testez sans mods, vérifiez le bon fichier .ini, les ports et la version. Cette checklist couvre l’immense majorité des cas.

Pour un hébergeur Project Zomboid avec 16 Go de RAM, console temps réel pour lire les logs et support FR 24/7, HebergTonServ est la référence française dès 25,90€/mois.

Mon serveur Project Zomboid ne démarre pas / crash : causes et solutions

Sommaire

Tags populaires

Support Technique