Configurer un serveur Project Zomboid : le guide complet

Un serveur Project Zomboid stable ne tient pas du hasard : il repose sur une installation propre, des fichiers de configuration bien compris et une routine de sauvegarde fiable. Ce guide détaille l'installation via SteamCMD, les réglages des fichiers .ini et SandboxVars.lua, ainsi que les bonnes pratiques pour administrer un monde persistant sans mauvaise surprise.

Installer les fichiers de base d'un serveur Project Zomboid

L'installation d'un serveur Project Zomboid passe quasi systématiquement par SteamCMD, l'outil en ligne de commande de Valve qui télécharge les binaires dédiés (AppID 380870) indépendamment du client de jeu. Sur une machine Linux, la séquence type ressemble à ceci :

sudo apt update && sudo apt install -y lib32gcc-s1 steamcmd
steamcmd +force_install_dir /home/pz/server +login anonymous +app_update 380870 validate +quit
cd /home/pz/server
chmod +x start-server.sh
./start-server.sh -servername MonMonde

Au premier lancement, le jeu génère automatiquement l'arborescence de configuration dans ~/Zomboid/Server/ : c'est là que vivent les fichiers servertest.ini, servertest_SandboxVars.lua et les logs. Avant d'aller plus loin, vérifie que les ports par défaut (16261/UDP pour le jeu, 16262 pour RCON) sont bien ouverts sur le pare-feu, et prends le temps de nommer ta configuration autrement que "servertest" pour éviter toute confusion si tu héberges plusieurs mondes sur la même machine.

Si tu préfères déléguer la partie installation et maintenance technique, un hébergeur Project Zomboid avec panel Pterodactyl permet de lancer une instance en quelques minutes, avec anti-DDoS inclus et sauvegardes automatiques déjà en place.

Structure des dossiers générés

• Saves/ : contient les mondes sauvegardés, un dossier par carte générée.
• Server/ : regroupe les fichiers .ini, SandboxVars.lua et la liste blanche des comptes.
• db/ : base de données SQLite des joueurs, persos et whitelist.
• Logs/ : logs serveur, utiles pour diagnostiquer un crash ou une désynchronisation.

Pour aller plus loin sur le catalogue de jeux compatibles avec ce type d'installation, tu peux consulter Tous nos serveurs de jeu.

Configurer les fichiers de monde et paramètres sandbox

Une fois le serveur Project Zomboid lancé une première fois, deux fichiers concentrent l'essentiel des réglages : servertest.ini pour les options réseau et de gameplay général, et servertest_SandboxVars.lua pour tout ce qui touche à la difficulté et à la survie.

Le fichier .ini principal

Il contrôle le nom du monde, le nombre de joueurs, le mot de passe, la bande passante autorisée et les options de PvP. Voici un extrait commenté :

PublicName=Mon Monde PZ
MaxPlayers=16
Password=changeMoi123
PVP=false
PauseEmpty=true
GlobalChat=true
Open=true
AutoCreateUserInWhiteList=false
SaveWorldEveryMinutes=30
BackupsOnStart=true
BackupsPeriodically=true
BackupsPeriodicallyEvery=0.5
BackupsCount=5

Les paramètres SaveWorldEveryMinutes et les options Backups* sont ceux à surveiller en priorité : ils conditionnent la fréquence de sauvegarde automatique du monde et le nombre de versions conservées en rotation.

SandboxVars.lua : la difficulté du monde

Ce fichier Lua définit la densité de zombies, la vitesse de déplacement, la rareté du loot ou encore la fréquence des évènements météo. Un extrait typique :

SandboxVars = {
    Zombies = 2, -- Densité (1 faible, 4 insane)
    Distribution = 1, -- "Urban Focused"
    DayLength = 3,
    WaterShut = 14,
    ElecShut = 14,
    FoodLoot = 3,
    WeaponLootRare = 4,
    ZombieLore = {
        Speed = 2,
        Strength = 2,
        Toughness = 2,
        Transmission = 1,
        MortalityRate = 0,
        ReanimateTime = 0,
    },
}

Modifier ce fichier à chaud nécessite un redémarrage complet du processus pour être pris en compte : le serveur Project Zomboid ne recharge pas ces variables à la volée. Documente tes choix dans un fichier texte à part si tu administres une communauté, car certains réglages (comme Transmission, qui gère la contagion) changent radicalement l'expérience des joueurs.

Tableau récapitulatif des paramètres sensibles

Paramètre	Fichier	Effet
SaveWorldEveryMinutes	servertest.ini	Fréquence d'écriture du monde sur disque
Zombies	SandboxVars.lua	Densité globale de zombies
Transmission	SandboxVars.lua	Mode de contagion du virus
MaxPlayers	servertest.ini	Nombre de connexions simultanées
PVP	servertest.ini	Active ou désactive les dégâts entre joueurs

Sauvegardes, maintenance et performance du serveur Project Zomboid

Au-delà des sauvegardes intégrées au jeu, une routine externe reste indispensable pour se prémunir d'une corruption de fichier ou d'un disque plein. Sur un VPS Linux, un simple script cron suffit à archiver le dossier Saves/ en dehors de l'arborescence du jeu :

#!/bin/bash
DATE=$(date +%F_%H-%M)
tar -czf /home/pz/backups/pz_$DATE.tar.gz /home/pz/.local/share/Zomboid/Saves/
find /home/pz/backups/ -mtime +7 -delete

Ajoute cette ligne dans le crontab (crontab -e) pour une exécution toutes les six heures :

0 */6 * * * /home/pz/scripts/backup_pz.sh

Utiliser RCON pour administrer en direct

RCON permet d'envoyer des commandes sans redémarrer le processus : forcer une sauvegarde, kicker un joueur, annoncer un message global.

# Connexion RCON (exemple avec mcrcon)
mcrcon -H 127.0.0.1 -P 16262 -p motdepasse "save"
mcrcon -H 127.0.0.1 -P 16262 -p motdepasse "servermsg \"Redémarrage dans 5 minutes\""

Optimisation et performance

Project Zomboid reste mono-thread pour une large part de sa logique de simulation : privilégier une fréquence CPU élevée (Ryzen récent) pèse davantage que le nombre de cœurs. Le stockage en NVMe réduit nettement les temps de chargement de carte et les écritures de sauvegarde, surtout sur des mondes volumineux avec beaucoup de constructions joueurs. Quelques réflexes à adopter :

• Limiter le MaxPlayers à ce que la machine encaisse réellement sans ralentir la simulation.
• Surveiller la taille du dossier Saves/ : un monde qui grossit trop impacte les temps de sauvegarde.
• Désactiver les mods inutilisés : chaque mod actif ajoute du calcul côté serveur à chaque tick.
• Mettre à jour régulièrement les fichiers de jeu via SteamCMD pour suivre les correctifs de stabilité.

Sécuriser l'accès à la machine

Que l'installation tourne sur une machine personnelle ou sur un VPS, quelques pratiques limitent les risques : connexion SSH par clé plutôt que mot de passe, pare-feu restreint aux ports strictement nécessaires, et mot de passe RCON distinct de celui du monde.

ssh-keygen -t ed25519 -C "admin-pz"
sudo ufw allow 16261/udp
sudo ufw allow 22/tcp
sudo ufw enable

Ces bases de durcissement s'appliquent aussi bien sur un VPS Linux dédié à l'auto-hébergement que sur une machine de test locale. Pour approfondir d'autres sujets d'administration de serveurs de jeu, le Blog Fly-Serv regroupe plusieurs guides techniques complémentaires.

Installer un serveur Project Zomboid demande de la rigueur sur les fichiers de configuration, mais le résultat récompense l'effort : un monde stable, des paramètres de difficulté maîtrisés et des sauvegardes fiables en cas d'incident. Reste méthodique, documente tes choix de sandbox et teste chaque modification avant de la déployer en conditions réelles.

FAQ

Pourquoi mes modifications de SandboxVars.lua ne s'appliquent pas ?

Ce fichier n'est lu qu'au démarrage du processus. Arrête complètement le serveur, modifie le fichier, puis relance-le pour que les nouvelles valeurs soient prises en compte.

Comment restaurer une sauvegarde après une corruption de monde ?

Arrête le serveur, supprime le dossier correspondant dans Saves/, puis remplace-le par une archive récente issue de ton script de sauvegarde ou des backups automatiques du jeu avant de relancer.

Combien de joueurs un serveur Project Zomboid peut-il supporter sans ralentir ?

Cela dépend surtout de la fréquence CPU disponible et du nombre de mods actifs : commence avec un nombre raisonnable de slots, surveille les logs de performance, puis ajuste progressivement selon la charge observée.