Logs d’un serveur Project Zomboid : lire et configurer

Sur un serveur communautaire, les logs sont ce qui sépare « je crois qu’il a triché » de « voilà l’horodatage ». Project Zomboid en écrit beaucoup — et trois options de servertest.ini, largement ignorées, décident de ce qui est réellement tracé.

Ce guide fait le tour : où sont les fichiers, lequel ouvrir selon le problème, et comment régler ClientCommandFilter, ClientActionLogs et PerkLogs.

Sur un serveur Project Zomboid HebergTonServ, la console est accessible en direct depuis le panel et les fichiers de logs se téléchargent en SFTP.

Où se trouvent les logs

Deux emplacements, deux usages :

Emplacement	Contenu
`Zomboid/server-console.txt`	Le flux en cours : démarrage, chargement des mods, connexions, erreurs
`Zomboid/Logs/`	Les logs archivés des sessions précédentes, horodatés

Sur Windows, le dossier Zomboid se trouve dans %USERPROFILE%\Zomboid. Sous Linux, dans le dossier personnel du compte qui exécute le serveur ($HOME/Zomboid).

À chaque redémarrage, la session précédente est archivée dans Logs/ avec un horodatage en préfixe. C’est ce qui permet de revenir sur un incident de la veille.

Les fichiers et ce qu’ils racontent

Fichier	À ouvrir quand…
`server-console.txt`	Le serveur vient de planter ou refuse de démarrer
`*_DebugLog-server.txt`	Il faut la stack trace complète d’une erreur Lua ou moteur
`*_chat.txt`	Un litige porte sur ce qui a été dit (global, safehouse, faction)
`*_pvp.txt`	Un joueur accuse un autre de l’avoir tué
`*_cmd.txt`	Vous voulez savoir quelles commandes clients ont été envoyées
`ClientActionLogs.txt`	Vous tracez des actions précises de joueurs
`PerkLog.txt`	Un joueur est passé de niveau 0 à niveau 10 en une nuit

Le réflexe de base : en cas de crash, commencez toujours par server-console.txt, puis passez au DebugLog si la cause n’est pas évidente. Voir mon serveur Project Zomboid ne démarre pas.

Les trois options de log dans `servertest.ini`

1. `PerkLogs` — le détecteur de XP suspect

PerkLogs=true

Activé par défaut. Il trace les changements de niveau de compétence de chaque joueur dans PerkLog.txt.

C’est l’outil le plus simple pour repérer un tricheur : un survivant qui gagne dix niveaux de Force en une session n’a pas eu un coup de chance. Laissez-le sur true — le coût en écriture est négligeable, et c’est souvent la seule preuve exploitable.

À croiser avec les protections d’anti-triche XP : voir anti-triche sur un serveur Project Zomboid.

2. `ClientActionLogs` — les actions que vous voulez tracer

ClientActionLogs=ISEnterVehicle;ISExitVehicle;ISTakeEngineParts;

Liste d’actions, séparées par des points-virgules, qui seront écrites dans ClientActionLogs.txt. La valeur par défaut ne trace que trois actions liées aux véhicules.

Le nom de chaque action correspond au nom interne de l’action du jeu (IS...). Ajouter des entrées augmente la traçabilité — et la taille des fichiers. Sur un serveur avec beaucoup de joueurs, n’ajoutez que ce que vous allez vraiment relire.

Usage typique : enquêter sur des disparitions de pièces de véhicules ou de générateurs. Voir électricité, eau et générateurs sur un serveur PZ.

3. `ClientCommandFilter` — le filtre du journal de commandes

ClientCommandFilter=-vehicle.*;+vehicle.damageWindow;+vehicle.fixPart;+vehicle.installPart;+vehicle.uninstallPart

C’est l’option la plus mal comprise, parce qu’elle fonctionne à l’envers : elle liste les commandes qui ne seront pas écrites dans le journal cmd.txt.

La syntaxe :

Préfixe	Effet
`-`	Ne pas écrire cette commande dans le log
`+`	Écrire cette commande, malgré une exclusion plus large
`*`	Joker sur la fin du nom

La valeur par défaut se lit donc ainsi : « n’écris aucune commande vehicle. sauf les quatre qui suivent ». Elle existe parce que les commandes de véhicules sont extrêmement bavardes et noieraient le reste.

Pour tout tracer, videz simplement la valeur :

ClientCommandFilter=

Attendez-vous alors à un cmd.txt qui grossit vite sur un serveur peuplé.

Trois configurations types

Serveur communautaire modéré

L’objectif : avoir des preuves sans saturer le disque.

PerkLogs=true
ClientActionLogs=ISEnterVehicle;ISExitVehicle;ISTakeEngineParts;
ClientCommandFilter=-vehicle.*;+vehicle.damageWindow;+vehicle.fixPart;+vehicle.installPart;+vehicle.uninstallPart

C’est la configuration par défaut, et elle est saine pour 90 % des serveurs.

Serveur en enquête (chasse au tricheur)

PerkLogs=true
ClientActionLogs=ISEnterVehicle;ISExitVehicle;ISTakeEngineParts;
ClientCommandFilter=

Tout est tracé. À utiliser temporairement, le temps de l’enquête, puis à remettre à la valeur par défaut : le journal de commandes non filtré grossit très vite.

Serveur allégé (disque limité)

PerkLogs=true
ClientActionLogs=
ClientCommandFilter=-*

On garde le journal des compétences — le plus utile — et on coupe le reste. -* exclut toutes les commandes du journal.

Bonnes pratiques d’exploitation

Téléchargez les logs avant un redémarrage prévu si un incident est en cours : les fichiers archivés restent, mais il est plus simple de récupérer server-console.txt tant qu’il est complet.
Surveillez l’espace disque. Un serveur communautaire actif avec un filtre de commandes vide peut produire des dizaines de mégaoctets par jour.
Croisez les fichiers. Les logs archivés partagent le même préfixe d’horodatage : c’est ce qui permet de recouper un message de chat, une action et une mort PvP sur la même minute.
Les logs ne remplacent pas les sauvegardes. Une preuve ne restaure pas une base rasée : voir sauvegardes automatiques avec BackupsPeriod.

Appliquer les modifications

Arrêtez le serveur — PZ réécrit servertest.ini à l’extinction et vos modifications à chaud seraient perdues.
Éditez les trois clés.
Redémarrez, puis vérifiez que les fichiers attendus apparaissent bien dans Zomboid/Logs/ après quelques minutes d’activité.

Vue d’ensemble du fichier : configurer servertest.ini Project Zomboid.

FAQ

Où sont les logs d’un serveur Project Zomboid ?

Le flux en cours est dans Zomboid/server-console.txt, à côté du dossier Server. Les sessions précédentes sont archivées, horodatées, dans Zomboid/Logs/. Sous Windows, tout cela se trouve dans %USERPROFILE%\Zomboid.

Comment savoir si un joueur a triché sur son XP ?

Activez PerkLogs=true (c’est la valeur par défaut) et lisez PerkLog.txt : chaque changement de niveau de compétence y est tracé avec son horodatage. Une progression impossible y est immédiatement visible.

À quoi sert exactement `ClientCommandFilter` ?

À exclure des commandes du journal cmd.txt. Le préfixe - retire, le préfixe + réintègre une exception, et * sert de joker. La valeur par défaut masque les commandes de véhicules, trop bavardes, sauf quatre d’entre elles.

Comment tout logger sans exception ?

Videz ClientCommandFilter= et complétez ClientActionLogs avec les actions qui vous intéressent. Surveillez alors l’espace disque : sur un serveur peuplé, les fichiers grossissent très vite.

Les logs ralentissent-ils le serveur ?

Marginalement dans une configuration standard. Le seul cas où l’écriture devient sensible, c’est un filtre de commandes vidé et une longue liste d’actions tracées sur un serveur à forte population — surtout sur un disque lent.

Comment retrouver qui a tué un joueur en PvP ?

Le fichier *_pvp.txt de la session concernée trace les dégâts joueur contre joueur. Recoupez-le avec *_chat.txt du même horodatage pour reconstituer la scène. Réglages associés : configurer le PvP sur un serveur Project Zomboid.

Les logs sont-ils conservés après un redémarrage ?

Oui, ils sont archivés dans Zomboid/Logs/ avec un horodatage. Seul server-console.txt repart à zéro, puisqu’il correspond à la session en cours.

Conclusion

Les logs de Project Zomboid tiennent en deux emplacements — server-console.txt pour la session en cours, Zomboid/Logs/ pour l’historique — et trois options de servertest.ini : PerkLogs pour détecter la triche d’XP, ClientActionLogs pour tracer des actions choisies, et ClientCommandFilter qui exclut des commandes du journal plutôt que de les inclure.

Pour un hébergeur Project Zomboid avec console en direct, accès SFTP aux logs et sauvegardes automatiques, HebergTonServ démarre à 25,90 €/mois.

Logs d'un serveur Project Zomboid : lire et configurer

Sommaire

Tags populaires

Support Technique