Comment activer le Debug mode sur un serveur Project Zomboid
Ouvrez votre serveur dans le panneau de contrôle, allez dans l'onglet Démarrage (Startup) et activez Debug mode. Le réglage est enregistré dès que vous cliquez et prend effet au prochain redémarrage du serveur.
Ce que le Debug mode change sur le serveur
Le Debug mode lance le processus serveur de Project Zomboid avec le flag -debug du jeu. Sur un serveur, cela veut surtout dire une chose : la journalisation développeur. À chaque démarrage, Project Zomboid affiche un tableau Logs configuration: qui liste ses catégories de logs et le niveau attribué à chacune. Au démarrage normal, presque toutes sont sur Warning, donc le serveur ne note quelque chose que lorsqu'il rencontre un problème.
Avec le Debug mode activé, les 51 catégories descendent toutes sur General, le niveau détaillé. Le serveur se met à consigner l'activité ordinaire et pas seulement les avertissements et les erreurs, ce qui vous donne une image bien plus précise de ce qu'il faisait juste avant un problème. C'est l'effet que vous pouvez voir et exploiter, et c'est la raison d'aller chercher cet interrupteur quand vous traquez quelque chose que vous n'arrivez pas à atteindre autrement.
Certains mods demandent aussi le debug mode, c'est l'autre raison courante de l'activer. Lisez d'abord les instructions du mod, car "debug mode" peut désigner le serveur ou votre propre copie du jeu, et ce sont deux réglages différents. Une section plus bas explique comment les distinguer.
Pour le reste, rien ne change sur le serveur. Il démarre normalement, les joueurs se connectent comme avant, et votre monde, votre config et vos mods installés ne sont pas touchés.
Activer le Debug mode
- Ouvrez votre serveur dans le panneau et choisissez Démarrage dans la liste des sections à gauche.
- Debug mode est la première carte de l'onglet.
- Cliquez sur l'interrupteur. Il enregistre immédiatement, et la ligne en dessous indique « Prend effet au prochain redémarrage ».
- Redémarrez le serveur depuis l'onglet Console.
Une fois activé, l'interrupteur devient bleu et le reste jusqu'à ce que vous le désactiviez.
Sur un téléphone, ou dans une fenêtre de navigateur étroite, la liste des sections se replie en un sélecteur Section au-dessus du contenu. Touchez-le et choisissez Démarrage pour retrouver la même carte.
Il n'y a ici aucune commande de démarrage à modifier à la main, et c'est voulu. Le launcher de Project Zomboid n'accepte le flag que s'il est passé après un séparateur -- : donnez-lui un -debug seul et il refuse de démarrer avec unknown option "-debug". L'interrupteur construit la commande correctement, alors laissez la commande tranquille et servez-vous de l'interrupteur.
Vérifier que cela a fonctionné
Redémarrez le serveur et surveillez l'onglet Console pendant le démarrage. Faites défiler jusqu'au bloc Logs configuration:, tout au début du log. Debug mode désactivé, ces lignes se terminent par Warning. Debug mode activé, elles se terminent par General. Ce bloc est la confirmation la plus nette que vous obtiendrez, puisque c'est le serveur lui-même qui annonce le niveau de log avec lequel il a démarré.
Si le bloc affiche toujours Warning, c'est que le serveur n'a pas été redémarré depuis que vous avez basculé l'interrupteur. Enregistrer le réglage ne fait que réécrire la commande de démarrage, et cette commande n'est lue qu'au lancement.
Le menu debug en jeu est un réglage côté client
C'est la partie qui crée le plus de confusion, autant être précis. Project Zomboid a deux choses différentes appelées debug, et activer l'une n'active pas l'autre.
Le menu debug en jeu, l'icône d'insecte qui ouvre le menu développeur pour faire apparaître des objets, se téléporter et autres triches, existe uniquement côté client. Chaque joueur l'active sur sa propre copie du jeu : clic droit sur Project Zomboid dans votre bibliothèque Steam, Properties, puis ajoutez -debug aux launch options. Cela ne vaut que pour le jeu de ce joueur, sur sa machine, et personne d'autre n'est concerné.
Il y a toutefois un piège à connaître avant de faire circuler l'astuce. Sur un serveur dédié, un joueur qui se connecte avec -debug dans ses launch options est déconnecté aussitôt s'il n'est pas admin, et le jeu signale la chose par Debug connection is not allowed for non-admin. Considérez donc cette launch option côté client comme quelque chose pour vous et vos admins, pas comme une consigne à donner à tout le serveur.
L'interrupteur de votre panneau de contrôle ne fait rien de tout cela. Il place le processus serveur en debug mode, et c'est pourquoi l'effet visible apparaît dans les logs du serveur et pas dans le jeu de qui que ce soit. L'activer ne fera apparaître aucune icône d'insecte sur l'écran de vos joueurs, et un joueur qui active -debug dans Steam ne met pas votre serveur en debug mode. Les deux réglages sont indépendants et vous pouvez utiliser l'un sans l'autre.
Donc si ce que vous voulez vraiment, c'est faire apparaître des objets ou vous téléporter sur votre propre serveur, le debug mode du serveur n'est pas le réglage que vous cherchez. Il vous faut un compte admin, et la launch option côté client si vous voulez en plus le menu développeur.
Quand laisser le Debug mode désactivé
Le Debug mode est un outil pour une tâche précise, pas un réglage à laisser en permanence. Les développeurs déconseillent de faire tourner debug en multijoueur à cause du coût en performances, et le volume de logs est la face visible de la même chose : chaque catégorie passe de Warning à General, donc le serveur écrit bien plus sur le disque qu'à l'ordinaire, et continue tant qu'il tourne. Sur un serveur fréquenté avec plusieurs joueurs connectés, ces fichiers grossissent régulièrement et grignotent l'espace dont votre monde et vos backups ont besoin.
Il y a aussi un coût pratique. Un log détaillé est plus difficile à lire qu'un log calme, et l'erreur que vous cherchez vraiment finit enterrée sous des milliers de lignes de routine qui n'existent que parce que le Debug mode est activé.
Activez-le donc quand vous en avez besoin, faites ce pour quoi vous en aviez besoin, puis désactivez-le et redémarrez. Si vous avez tourné un moment avec, ouvrez l'onglet Fichiers, allez dans le dossier .cache et faites le ménage dans les anciens fichiers de log dont vous n'avez plus l'usage.
Problèmes courants
Je l'ai activé mais rien n'a changé. L'interrupteur ne fait que réécrire la commande de démarrage. Redémarrez le serveur depuis l'onglet Console, puis vérifiez le bloc Logs configuration: comme décrit plus haut.
Un mod dit qu'il lui faut le debug mode, et cela ne marche toujours pas. Déterminez de quel côté parle le mod. S'il lui faut le serveur en debug mode, c'est bien cet interrupteur. S'il lui faut votre jeu en debug mode, la launch option va sur votre propre copie de Project Zomboid dans Steam. Lire attentivement la description Workshop du mod tranche en général la question. Il vaut aussi la peine de vérifier que le mod est bien installé et chargé : voir Installer des mods sur un serveur Project Zomboid (Build 42).
Je veux faire apparaître des objets ou me téléporter, et le Debug mode ne me l'a pas donné. Ce sont des droits admin, pas le debug mode. Connectez-vous en jeu avec votre compte admin et utilisez le panneau admin : voir Comment devenir admin sur un serveur Project Zomboid.
Un joueur est déconnecté au moment même où il se connecte. Vérifiez s'il a -debug dans ses propres launch options Steam. Un serveur dédié refuse une connexion debug de quiconque n'est pas admin, la solution est donc de retirer cette launch option de son côté. Cela n'a rien à voir avec l'interrupteur du serveur, et c'est bien pour cela que le problème continue d'arriver sur des serveurs qui n'ont jamais eu le debug mode activé.
Mon utilisation disque a grimpé après l'activation. C'est l'effet secondaire attendu d'une journalisation détaillée. Désactivez le Debug mode, redémarrez et supprimez les fichiers de log dont vous n'avez plus besoin depuis l'onglet Fichiers.
Puis-je simplement le laisser activé ? Le serveur tourne avec, donc rien ne casse en soi. Cela vaut quand même la peine de le désactiver une fois terminé : les développeurs déconseillent debug en multijoueur, et les logs continuent de grossir tout le temps qu'il reste activé.
Le Debug mode est disponible sur chaque serveur Project Zomboid que nous hébergeons, depuis le même panneau de contrôle où vous gérez tout le reste. Si l'interrupteur est absent, ou si le serveur refuse de démarrer après un redémarrage, ouvrez un ticket et nous parcourrons le log de démarrage avec vous.
