Configurer un serveur Project Zomboid pas à pas

La configuration d'un serveur Project Zomboid repose sur une poignée de fichiers texte et quelques ports réseau à ouvrir correctement, rien d'insurmontable dès lors qu'on comprend la logique de Zomboid Dedicated Server. Ce guide détaille les étapes techniques pour faire tourner une instance stable, de l'installation via SteamCMD aux options de survie en passant par les sauvegardes automatiques.

Comprendre l'architecture d'un serveur Project Zomboid

Un serveur Project Zomboid fonctionne sur l'exécutable dédié fourni par The Indie Stone, distinct du client de jeu. Il tourne en 64 bits sous Linux ou Windows et s'installe via SteamCMD avec l'AppID 380870. Contrairement à d'autres titres de survie, Zomboid génère automatiquement trois fichiers de configuration la première fois qu'on lance l'instance, ce qui facilite grandement la prise en main.

Pour héberger soi-même cette instance sur une machine dédiée, l'option la plus directe reste un VPS Linux sur lequel on installe manuellement SteamCMD, ou un environnement déjà prêt à recevoir le jeu via un panel. Si tu préfères déléguer l'installation et la maintenance technique, la page hébergeur Project Zomboid de Fly-Serv propose une instance prête à configurer avec accès console et fichiers.

Côté architecture réseau, le serveur ouvre trois flux distincts : le port de jeu principal, le port de requête Steam (pour que le serveur apparaisse dans le navigateur de parties) et le port RCON pour l'administration à distance. Sans ces trois flux correctement configurés, les joueurs ne pourront ni rejoindre la partie ni la voir listée.

Configurer les ports, le pare-feu et la connexion réseau

Par défaut, un serveur Project Zomboid utilise le port UDP 16261 pour le trafic de jeu et le port UDP 16262 pour les requêtes Steam (port de jeu + 1). Le port RCON, lui, est en TCP et vaut 27015 par défaut. Ces valeurs sont modifiables dans le fichier de configuration principal.

Sur une machine Linux avec ufw, les règles de pare-feu ressemblent à ceci :

sudo ufw allow 16261/udp
sudo ufw allow 16262/udp
sudo ufw allow 27015/tcp
sudo ufw reload
sudo ufw status

Si tu passes par un routeur domestique (hébergement maison), il faudra également rediriger ces trois ports vers l'adresse IP locale de la machine. Sur une infrastructure avec anti-DDoS en amont, ces ports restent les mêmes, seule la couche de filtrage réseau change.

Installation via SteamCMD

L'installation du binaire se fait en ligne de commande, qu'on soit sur un VPS Linux ou une distribution locale :

mkdir -p ~/pzserver && cd ~/pzserver
steamcmd +force_install_dir ~/pzserver +login anonymous +app_update 380870 validate +quit

Une fois l'installation terminée, le premier lancement se fait via le script fourni :

cd ~/pzserver
chmod +x start-server.sh
./start-server.sh -servername monserveur

Ce premier démarrage génère les fichiers de configuration dans le dossier ~/Zomboid/Server/, qu'il faut ensuite arrêter proprement (commande quit dans la console) avant de les éditer.

Fichiers de configuration et options de survie

Trois fichiers principaux pilotent le comportement d'un serveur Project Zomboid : le fichier .ini général, le fichier de variables sandbox et le fichier des zones de spawn. Tous se trouvent dans ~/Zomboid/Server/ et portent le nom du serveur en préfixe.

Le fichier servertest.ini

Ce fichier contient les réglages réseau, les mots de passe et les paramètres globaux. Quelques lignes essentielles à vérifier :

DefaultPort=16261
RCONPort=27015
RCONPassword=motdepasse_solide_ici
Public=true
PublicName=Mon serveur Zomboid
MaxPlayers=16
PauseEmpty=true
PVP=false
GlobalChat=true

Le mot de passe RCON mérite autant d'attention qu'un mot de passe admin classique : c'est la porte d'entrée pour piloter le serveur à distance via des outils externes. Utilise une chaîne longue et unique, jamais la valeur par défaut.

Le fichier SandboxVars.lua

C'est ici que se joue l'identité de la partie : difficulté des zombies, vitesse de déplacement, respawn, fréquence du loot. Extrait typique :

ZombieConfig = {
  Speed = 2,
  Strength = 2,
  Toughness = 2,
  Transmission = 1,
  Mortality = 3,
  Distribution = 1,
}
VMBuildings = 1
WaterShut = 14
ElecShut = 14
LootRespawn = 2
Erosion = {1, 1}

Chaque valeur numérique correspond à un niveau prédéfini (1 pour faible, plus le chiffre augmente plus l'option est stricte). Les presets "Apocalypse" et "Survivor" du jeu de base sont une bonne référence pour calibrer tes propres réglages avant de personnaliser.

Le fichier spawnregions.lua

Il définit les villes et zones où les joueurs peuvent apparaître à la création de personnage :

function SpawnRegions()
  return {
    { name = "Muldraugh, KY", file = "media/maps/Muldraugh, KY/spawnpoints.lua" },
    { name = "Rosewood, KY", file = "media/maps/Rosewood, KY/spawnpoints.lua" },
  }
end

Pour ajouter des mods de map comme Riverside étendu ou des cartes communautaires, il faut déclarer ici le chemin correspondant en plus de la liste des Workshop ID dans le fichier .ini (Mods= et WorkshopItems=).

Tableau récapitulatif des fichiers

Fichier	Rôle	Emplacement
servertest.ini	Réseau, mots de passe, slots	~/Zomboid/Server/
servertest_SandboxVars.lua	Difficulté, loot, zombies	~/Zomboid/Server/
servertest_spawnregions.lua	Zones d'apparition, cartes	~/Zomboid/Server/

Sauvegardes, performance et administration au quotidien

Les parties en cours sont stockées dans ~/Zomboid/Saves/Multiplayer/<nomduserveur>/. C'est ce dossier qu'il faut sauvegarder régulièrement, idéalement par un script planifié plutôt qu'une copie manuelle oubliée au bout de trois semaines.

#!/bin/bash
DATE=$(date +%F_%H%M)
tar -czf ~/backups/zomboid_$DATE.tar.gz ~/Zomboid/Saves/Multiplayer/monserveur/
find ~/backups -type f -mtime +7 -delete

Ce script compresse la sauvegarde avec horodatage et supprime automatiquement les archives de plus de 7 jours. À placer en tâche cron :

crontab -e
0 */4 * * * /home/user/scripts/backup_zomboid.sh

Sur un panel Pterodactyl, cette logique de sauvegarde automatique est généralement déjà intégrée nativement, avec restauration en un clic depuis l'interface, ce qui évite d'écrire et de maintenir ce type de script soi-même.

Autostart avec systemd

Pour que le serveur redémarre automatiquement après un reboot de la machine, un service systemd est plus fiable qu'un simple nohup :

[Unit]
Description=Project Zomboid Dedicated Server
After=network.target

[Service]
User=pzuser
WorkingDirectory=/home/pzuser/pzserver
ExecStart=/home/pzuser/pzserver/start-server.sh -servername monserveur
Restart=on-failure

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now pzomboid.service
sudo systemctl status pzomboid.service

Performance et administration via RCON

Un serveur Project Zomboid est gourmand en RAM dès que le nombre de chunks explorés augmente, surtout avec plusieurs joueurs actifs sur des zones différentes de la carte. Un processeur à fréquence élevée limite les baisses de tickrate lors des pics de zombies, et du stockage NVMe réduit nettement les temps de chargement et d'écriture des sauvegardes automatiques comparé à un disque mécanique classique.

Pour administrer la partie sans redémarrer, la console RCON permet d'exécuter des commandes à chaud :

players
save
kickuser "Pseudo"
banuser "Pseudo"
quit

Pense aussi à activer une whitelist si ta communauté est fermée, et à changer régulièrement le mot de passe admin et RCON, surtout si plusieurs modérateurs y ont accès. Pour la gestion des mods Workshop, des plugins de qualité de vie et des configurations plus poussées, le Blog Fly-Serv propose d'autres guides détaillés sur les titres de survie, et la page Tous nos serveurs de jeu recense l'ensemble des jeux pris en charge.

Pour les références techniques complètes sur les commandes et paramètres sandbox, la documentation communautaire reste la source la plus à jour : Source.

FAQ

Quel port faut-il ouvrir en priorité pour qu'un serveur Project Zomboid soit visible dans le navigateur de parties ?

Il faut ouvrir le port UDP de jeu (16261 par défaut) ainsi que le port UDP de requête Steam juste au-dessus (16262 par défaut). Sans ce second port, la partie fonctionne mais n'apparaît pas dans la liste publique.

Comment modifier la difficulté des zombies sans perdre la sauvegarde existante ?

Édite le fichier SandboxVars.lua correspondant à ta partie, arrête puis relance le service. Les changements de comportement des zombies (vitesse, force, transmission) s'appliquent sans toucher aux fichiers de sauvegarde du monde.

Pourquoi mes sauvegardes automatiques ralentissent le serveur en jeu ?

Une écriture disque lente pendant la compression de la sauvegarde peut provoquer un micro-freeze perceptible par les joueurs. Un stockage NVMe limite fortement ce phénomène comparé à un disque mécanique classique, et planifier les sauvegardes aux heures creuses aide aussi.