Les serveurs Project Zomboid peuvent crasher ou ne pas démarrer pour plusieurs raisons bien connues. Ce guide couvre les causes les plus courantes observées dans les tickets de support Legion Hosting — d'un bug de mémoire du Build 42 qui nécessite de la RAM supplémentaire au démarrage, à un débordement de sauvegarde qui remplit /tmp, en passant par des fichiers de configuration corrompus. Parcourez les sections ci-dessous dans l'ordre.

Avant de commencer — Localisez vos logs de crash

Presque chaque crash de Project Zomboid laisse des traces dans l'un des deux endroits suivants. Vérifiez les deux avant de tenter une correction, afin de savoir quelle section de ce guide s'applique à votre cas.

Sortie de la console GPanel

1. Connectez-vous à GPanel.
2. Sélectionnez votre serveur Project Zomboid dans la liste des serveurs.
3. Cliquez sur l'onglet Console.
4. Faites défiler jusqu'en bas de la sortie. Recherchez les lignes marquées ERROR, FATAL, OutOfMemoryError ou Exception. Les 20 à 30 dernières lignes avant l'arrêt du serveur sont généralement les plus pertinentes.
5. Si la console est vide, le processus du serveur s'est terminé avant de pouvoir écrire quoi que ce soit — c'est en soi un indice (voir la section mémoire B42 ci-dessous).

Le fichier debug.log du serveur

Project Zomboid écrit un log détaillé dans debug.log dans le répertoire de données du serveur. Ce fichier contient souvent une trace de pile Java complète qui pointe directement vers la cause du crash.

1. Dans GPanel, allez dans l'onglet File Manager.
2. Naviguez vers /.cache/Logs/. Vous verrez des fichiers nommés comme debug.log, DebugLog-server.txt, ou des fichiers de log datés.
3. Ouvrez le fichier de log le plus récent. Utilisez Ctrl+End ou faites défiler jusqu'en bas et lisez vers le haut à partir de là.
4. Recherchez les mots-clés OutOfMemoryError, IOException, NullPointerException ou SandboxVars. Copiez les lignes pertinentes — vous en aurez besoin si vous ouvrez un ticket de support.

Correctif 1 — Utilisation élevée de la mémoire au démarrage du Build 42 (bug connu du jeu)

Si votre serveur se ferme immédiatement au démarrage sans erreur dans la console, ou si la console affiche OutOfMemoryError ou une erreur d'espace de tas Java, le serveur manque de mémoire avant que le monde ne finisse de se charger.

Symptômes

• Le serveur démarre, la console défile pendant quelques secondes, puis s'arrête sans erreur visible pour les joueurs.
• La console affiche java.lang.OutOfMemoryError: Java heap space ou GC overhead limit exceeded.
• Le serveur fonctionne lors de certains redémarrages mais pas d'autres (la disponibilité de la mémoire varie).
• Le serveur fonctionnait correctement sur B41 mais crashe systématiquement après la mise à jour vers B42.

Étapes

1. Dans GPanel, cliquez sur votre serveur et allez dans l'onglet Console. Notez l'allocation de RAM actuelle de votre serveur affichée dans la barre de ressources ou le panneau d'informations du serveur.
2. Si votre plan inclut moins de 10 Go de RAM, le serveur peut crasher au démarrage car B42 nécessite environ 9 Go pour s'initialiser. Vous devrez mettre à niveau votre plan ou attendre que Indie Stone publie un correctif.
3. Si votre plan dispose déjà de 10 Go ou plus et que le serveur crashe toujours au démarrage, allez dans l'onglet Startup de GPanel.
4. Recherchez un champ intitulé Java Memory, Max RAM ou Xmx. Confirmez qu'il est défini à un maximum de 80 à 85 % de votre RAM totale disponible. Par exemple, sur un plan de 12 Go, définissez-le à 10240 (10 Go en mégaoctets). Ne le définissez pas égal ou supérieur à votre RAM totale — le système d'exploitation et d'autres processus ont également besoin de mémoire.
5. Cliquez sur Save dans l'onglet Startup, puis redémarrez votre serveur.
6. Surveillez la console pendant le démarrage. Si le serveur atteint la ligne SERVER STARTED ou que LuaManager: Loading lua files... se termine sans crasher, l'allocation de mémoire est désormais suffisante.

Correctif 2 — BackupsOnStart qui déborde /tmp (crash au démarrage)

Project Zomboid peut être configuré pour créer une sauvegarde complète du monde à chaque démarrage du serveur. Lorsque cette sauvegarde est écrite dans /tmp — qui est limité en taille sur la plupart des hôtes Linux — le serveur crashe en cours de démarrage avec une erreur d'écriture sur le disque une fois que /tmp est plein.

Symptômes

• Le serveur crashe systématiquement à chaque redémarrage, mais fonctionnait auparavant.
• La console ou debug.log contient des erreurs comme IOException: No space left on device ou mentionne l'écriture dans /tmp/.
• Les crashs ont tendance à s'aggraver au fil du temps à mesure que la sauvegarde du monde grossit.
• Le serveur démarre parfois si vous essayez peu après un redémarrage propre du nœud hôte (avant que /tmp ne se remplisse à nouveau).

Étapes — Désactiver BackupsOnStart

1. Dans GPanel, allez dans l'onglet File Manager.
2. Naviguez vers /.cache/server/. Recherchez votre fichier de configuration du serveur — il est généralement nommé servertest.ini ou le nom de votre serveur suivi de .ini (par exemple, MyServer.ini).
3. Ouvrez le fichier .ini pour le modifier.
4. Utilisez la fonction de recherche de votre navigateur (Ctrl+F) pour chercher BackupsOnStart.
5. Changez la valeur de true à false :

   BackupsOnStart=false

6. Pendant que vous êtes dans le fichier, vérifiez également le paramètre BackupsOnVersionChange et définissez-le sur false si l'espace disque est une préoccupation :

   BackupsOnVersionChange=false

7. Enregistrez le fichier et redémarrez votre serveur. Surveillez la console pour confirmer que le serveur atteint la ligne SERVER STARTED.

Correctif 3 — SandboxVars.lua ou configuration serveur corrompus

Project Zomboid stocke les paramètres du monde dans un fichier Lua appelé SandboxVars.lua. Si ce fichier est modifié manuellement et enregistré avec une erreur de syntaxe, ou si un transfert de fichier a été interrompu, le serveur crashera immédiatement au démarrage lorsqu'il tentera d'analyser le fichier.

Symptômes

• La console affiche ERROR: SandboxVars, LuaManager error, ou une erreur d'analyse Lua avec un numéro de ligne.
• Le crash a commencé juste après que vous ayez modifié les paramètres dans le fichier .ini ou SandboxVars.lua directement.
• Le serveur peut afficher Bad argument #1 to ou des erreurs d'exécution Lua similaires.

Étapes — Vérifier et réparer SandboxVars.lua

1. Dans GPanel, allez dans File Manager et naviguez vers /.cache/saves/multiplayer/<YourServerName>/.
2. Ouvrez SandboxVars.lua pour le modifier.
3. Vérifiez que le fichier commence par VERSION = 1, (ou similaire) à l'intérieur d'un bloc SandboxVars = {, et se termine par un } fermant. Toute virgule manquante, accolade non fermée ou caractère parasite provoquera un échec d'analyse.
4. Si vous ne pouvez pas identifier l'erreur, la solution la plus sûre est de supprimer entièrement SandboxVars.lua. Le serveur le régénérera avec les valeurs par défaut au prochain démarrage. Remarque : cela réinitialise vos paramètres de bac à sable (butin, nombre de zombies, etc.) aux valeurs par défaut — vos données de carte et de joueur ne sont pas affectées.
5. Vérifiez également le fichier .ini dans /.cache/server/ pour des problèmes similaires si vous l'avez récemment modifié à la main. Assurez-vous que chaque ligne suit le format Key=Value sans lignes vides à l'intérieur d'une valeur.
6. Enregistrez les modifications et redémarrez le serveur.

Correctif 4 — Mot de passe administrateur vide causant un crash

Project Zomboid nécessite un mot de passe administrateur non vide pour démarrer un serveur multijoueur. Si le champ du mot de passe est vide, le processus du serveur se ferme immédiatement après avoir tenté d'initialiser le compte administrateur.

Symptômes

• Un serveur tout neuf ou récemment réinitialisé échoue à chaque tentative de démarrage.
• La sortie de la console est très courte — le serveur affiche quelques lignes d'initialisation puis s'arrête.
• debug.log peut contenir une référence au compte administrateur ou à la validation du mot de passe.

Étapes

1. Dans GPanel, cliquez sur votre serveur et allez dans l'onglet Startup.
2. Recherchez un champ intitulé Admin Password ou RCON Password. Confirmez qu'il contient une valeur — il ne doit pas être vide.
3. Si le champ est vide, entrez un mot de passe. Utilisez au moins 8 caractères. Évitez les caractères spéciaux comme !, #, $ ou @ dans le mot de passe administrateur, car certaines versions de PZ ne parviennent pas à les analyser correctement dans les arguments de démarrage.
4. Cliquez sur Save et redémarrez le serveur.
5. En vérification secondaire, ouvrez le fichier .ini dans /.cache/server/ et confirmez que la ligne AdminPassword= a une valeur après le signe égal.

Correctif 5 — Réinitialiser le monde (dernier recours pour les crashs persistants)

Si une sauvegarde de monde devient corrompue — par exemple après un crash brutal du serveur, une mise à jour échouée ou des erreurs du système de fichiers — les données de sauvegarde elles-mêmes peuvent être irrécupérables. Dans ce cas, supprimer le monde et repartir à zéro est la seule option.

Étapes

1. Arrêtez votre serveur dans GPanel avant d'apporter toute modification aux fichiers de sauvegarde. Modifier des fichiers sur un serveur en cours d'exécution peut causer davantage de corruption.
2. Dans GPanel, allez dans l'onglet File Manager.
3. Naviguez vers /.cache/saves/multiplayer/.
4. Vous verrez un ou plusieurs dossiers avec le nom de votre serveur (par exemple, servertest). Avant de supprimer, téléchargez éventuellement le dossier en tant que sauvegarde en le sélectionnant et en utilisant l'option de téléchargement — même une sauvegarde corrompue peut être partiellement récupérable plus tard.
5. Supprimez le dossier correspondant au nom de votre serveur dans Multiplayer/. Ne supprimez pas le dossier Multiplayer lui-même.
6. Naviguez également vers /.cache/db/ et supprimez le fichier <YourServerName>.db. Cette base de données contient les statistiques des joueurs et peut référencer l'ancien monde — la régénérer évite les incohérences.
7. Démarrez votre serveur. Il générera un monde neuf en utilisant les paramètres de votre fichier .ini.

Référence de diagnostic rapide

Le serveur crashe toujours après toutes les étapes ?