Serveur Project Zomboid qui ne démarre pas ? Erreurs B42 et solutions

Si votre serveur Project Zomboid ne démarre pas, ou s'arrête aussitôt, la cause se trouve presque toujours dans l'un de ces cinq domaines : la mémoire Java, un mod pas prêt pour la Build 42, une différence de version entre le serveur et les joueurs, un téléchargement qui reste bloqué ou une sauvegarde endommagée. Le log du serveur vous dit lequel. Voici, symptôme par symptôme, ce qu'il faut faire, d'après le PZwiki et les notes de patch de The Indie Stone jusqu'à la 42.21 (unstable, 23 septembre 2026).

Commencez par le log, pas par le message de vos joueurs

Ce que voient les joueurs ne dit pas grand-chose ; le log du serveur en dit bien plus. Un serveur dédié écrit dans server-console.txt, dans le dossier Zomboid ; un serveur coop hébergé depuis le menu principal écrit dans coop-console.txt. Cherchez STACK TRACE : selon le wiki, vous trouverez ainsi la plupart des erreurs, parfois même avec le nom du mod qui les provoque.

Dans notre panel de jeu, vous lisez la même chose en direct dans la console. Le serveur y démarre avec -cachedir=/home/container/.cache : dans le gestionnaire de fichiers, .cache est donc votre dossier Zomboid. Il contient server-console.txt, vos réglages dans Server/<nomduserveur>.ini et votre monde dans Saves/Multiplayer/<nomduserveur>. Le panel n'affiche le statut en ligne que lorsque la console indique SERVER STARTED ; s'il reste sur « starting », la réponse se trouve dans les lignes au-dessus.

Le serveur s'arrête aussitôt : généralement la mémoire Java

Le serveur tourne sous Java et reçoit un maximum de mémoire fixe via -Xmx : sous Windows dans StartServer64.bat, sous Linux dans ProjectZomboid64.json. Selon le wiki, le fichier de démarrage Windows demande 16 Go par défaut ; si votre machine en a moins, le serveur ne démarre pas. Réglez alors -Xms et -Xmx sur ce dont vous disposez réellement.

L'inverse arrive aussi : le serveur démarre, mais s'arrête au bout d'un moment avec java.lang.OutOfMemoryError dans le log. La règle empirique du wiki : au moins 3 Go pour le serveur plus environ 0,5 Go par joueur, soit 5 Go pour quatre joueurs, mods non compris. Mettez aussi à jour vers la version stable actuelle : la 42.20.3 (17 août) s'est attaquée à plusieurs causes d'une fuite de mémoire qui pouvait, à la longue, provoquer des saccades et des crashs.

Dans notre panel, pas besoin de modifier du JSON. Parmi les variables de démarrage figure Geheugenlimiet (%), la limite de mémoire : grâce à elle, la commande de démarrage règle -Xmx sur un pourcentage de votre offre (champ vide = 75 %). Avec 6 Go, cela fait 4,5 Go ; le reste est laissé à Java lui-même et au système. Pousser le pourcentage au maximum ne fait que masquer un manque.

Mods : la cause la plus courante après une mise à jour

Depuis que la Build 42 est passée en stable le 29 juillet 2026, le serveur ne reconnaît que les mods dotés d'une structure Build 42 : un dossier common/ ou un dossier de version comme 42/. Un mod purement Build 41 ne se charge pas. Vérifiez aussi que chaque mod figure dans les deux listes : l'ID Workshop dans WorkshopItems=, le Mod ID dans Mods=. Tout est expliqué dans Mods sur un serveur Project Zomboid.

Vous ne savez pas quel mod est en cause ? Coupez votre liste en deux, encore et encore, jusqu'à trouver le coupable. Faites-le après une sauvegarde : selon le wiki, des objets peuvent disparaître définitivement si vous retirez des mods d'un monde en cours. La 42.20.4 (26 août) a montré à quelle vitesse un patch peut casser des mods : elle a supprimé loadstring et loadstream pour combler des failles de sécurité, et les mods qui s'en servaient ne fonctionnaient plus. Dans la 42.21 (unstable), ils sont de nouveau activés.

Bloqué sur « initializing » ou au chargement de la carte

• Le serveur coop reste sur « initializing » ou « Downloaded x of y ». Selon le wiki, c'est généralement un mod qui reste bloqué à 0/0 octet ; vous le voyez en bas de coop-console.txt. Annulez, redémarrez et recommencez jusqu'à ce que tous les mods soient téléchargés.
• Le serveur dédié reste sur « Getting server info » ou ne télécharge pas de mods. C'est un problème connu de l'outil Dedicated Server du client Steam ; installez via SteamCMD (app 380870), comme le fait déjà notre panel.
• Les mods de carte ne se chargent pas, ou à moitié. Placez Muldraugh, KY en dernier dans Map=. S'il est en tête, la carte de base écrase vos cartes moddées.
• Les joueurs restent bloqués sur « Loading Map ». L'une des causes a été corrigée dans la 42.20.3 ; mettez tout le monde sur la version stable actuelle.
• Votre serveur auto-hébergé semble bloqué au premier démarrage. Il attend alors un mot de passe pour le compte admin. Dans notre panel, vous le fournissez avec la variable Admin Password. Elle vaut password par défaut : changez-la tout de suite.

Différence de version : Build 41, 42 et unstable mélangées

Le serveur et les joueurs doivent être sur la même version. La version stable est la 42.20.4 ; depuis le 23 septembre, la 42.21 est sur la branche unstable. Les sauvegardes Build 41 ne fonctionnent pas en Build 42 (la branche legacy41 existe pour cela), et les sauvegardes de l'ancienne unstable 42.19 ne fonctionnent pas en 42.20 (c'est le rôle de la branche 42.19). Un joueur sur une autre branche que le serveur ne peut pas entrer ; en 42.21 (unstable), les joueurs reçoivent un message à ce sujet.

• Steam Auto Update est réglé sur 0 par défaut dans notre panel : le serveur ne se met alors pas à jour lui-même au redémarrage. Pratique si vous voulez d'abord attendre vos mods, mais après un patch, cela crée une différence de version avec vos joueurs. Faites une sauvegarde, réglez-le sur 1 et redémarrez.
• Steam Beta Branch choisit la branche, par exemple legacy41. Changer de branche demande une réinstallation ; faites d'abord une sauvegarde.

Votre serveur auto-hébergé est passé de la Build 41 à la 42 et s'arrête avec Assertion Failed: Illegal termination of worker thread ? Selon le wiki, steam_appid.txt ne doit alors contenir que 108600, et vous supprimez l'ancien dossier Zomboid après une sauvegarde.

Ports : 16261 et 16262 UDP, ou ce qu'indique le panel

Un serveur dédié utilise par défaut deux ports UDP, 16261 et 16262. Chez vous, les deux doivent être ouverts dans votre box ou routeur et dans votre pare-feu. Sur un serveur hébergé, ce sont les ports attribués par le panel qui comptent : la commande de démarrage les transmet avec -port et -udpport, et ces paramètres priment sur DefaultPort et UDPPort dans le fichier .ini. Modifier ces deux lignes n'a donc aucun effet ; connectez-vous avec l'adresse IP et le port affichés en haut du panel.

Sauvegarde endommagée, ou soudain un monde vide

Le serveur démarre soudain avec un monde vide et les réglages par défaut ? Regardez d'abord le nom du serveur : il détermine quel fichier .ini et quel dossier de sauvegarde sont chargés. Si vous le changez (dans notre panel, la variable Server Name), le serveur commence un nouveau monde. L'ancien est toujours là, juste à côté, dans Saves/Multiplayer ; remettez l'ancien nom et il se recharge.

Si le monde est vraiment endommagé, par exemple avec le message « World Version is zero », restaurez une sauvegarde. Le serveur en crée aussi lui-même : BackupsOnStart et BackupsOnVersionChange sont activés par défaut, avec BackupsCount=5. En plus, vous faites en un clic une sauvegarde complète dans le panel, de préférence avant chaque changement de mods ou de version ; voir restaurer une sauvegarde.

Quand plus de RAM aide vraiment, et quand elle n'aide pas

Plus de mémoire règle un seul type de problème : un tas (heap) Java qui se remplit. Si vous voyez OutOfMemoryError, ou si votre groupe ou votre liste de mods s'agrandit, une offre plus grande aide. Pour un mod qui ne se charge pas, une différence de version, un port fermé ou une sauvegarde endommagée, de la RAM en plus ne change rien.

Toutes les offres Project Zomboid disposent de stockage NVMe et d'une protection DDoS, sont résiliables chaque mois et tournent à Hengelo, Francfort, Varsovie ou Beauharnois. Avec 75 % pour Java, cela donne :

• Amateur (2 Go, 3,00 €) : sous le minimum du wiki, uniquement pour tester.
• Beginner (4 Go, 6,00 €) : 3 Go pour Java, la base de la règle empirique ; juste dès qu'il y a des joueurs.
• Traveller (6 Go, 9,00 €) : 4,5 Go, assez pour trois joueurs sans mods.
• Explorer (8 Go, 12,00 €) : 6 Go, assez pour six joueurs sans mods ou quatre avec une liste de mods modeste.
• Maintainer (12 Go, 18,00 €) à Chief (16 Go, 24,00 €) : grands groupes ou gros modpacks.

Commencez plutôt une taille en dessous et montez en gamme quand le log le réclame (voir upgrader ou downgrader). Pas encore de serveur ? Lisez démarrer un serveur Project Zomboid.

Questions fréquentes

Pourquoi mon serveur Project Zomboid s'arrête-t-il juste après le démarrage ?

Le plus souvent à cause de la mémoire Java : -Xmx est plus élevé que ce dont dispose la machine, ou trop bas pour vos joueurs et vos mods. Cherchez dans server-console.txt une erreur de mémoire ou un STACK TRACE ; si un nom de mod y figure, ce mod n'est probablement pas prêt pour la Build 42.

Quels ports utilise un serveur Project Zomboid ?

Par défaut, UDP 16261 et 16262 (DefaultPort et UDPPort dans le fichier .ini). Sur un serveur hébergé, ce sont les ports attribués par le panel qui comptent ; ils sont transmis avec -port et -udpport et priment sur les valeurs du fichier .ini.

Puis-je jouer un monde Build 41 sur un serveur Build 42 ?

Non. The Indie Stone indique que les sauvegardes Build 41 ne fonctionnent pas en Build 42. Pour garder votre ancien monde, mettez le serveur et tous les joueurs sur la branche Steam legacy41.

Combien de RAM faut-il pour un serveur Project Zomboid ?

Le PZwiki compte au moins 3 Go pour le serveur plus environ 0,5 Go par joueur, et davantage avec des mods. Quatre joueurs sans mods arrivent ainsi à 5 Go ; prévoyez en plus un peu de marge pour le système.

À lire aussi

• Project Zomboid Build 42 : monter un serveur entre amis
• Mods sur un serveur Project Zomboid : Workshop ID, Mod ID et Build 42