Installer des mods sur un serveur Project Zomboid (Build 42)
Ajouter des mods du Steam Workshop à un serveur dédié Project Zomboid demande trois informations par mod et deux lignes dans la configuration du serveur. Ce guide détaille les étapes exactes pour un serveur multijoueur Build 42 hébergé chez DoomHosting.
Note Build 42 : Build 42 est devenu la branche stable le 29 juillet 2026 et l'ancienne branche
unstablen'existe plus sur Steam : un serveur Build 42 est donc simplement l'installation par défaut. Pour rester en Build 41, verrouillez plutôt la branchelegacy41: voir Garder votre serveur Project Zomboid en Build 41. Beaucoup de mods Build 41 ne fonctionnent pas sur Build 42, vérifiez donc toujours que la page Workshop mentionne explicitement le support "B42" avant d'ajouter un mod.
Aide-mémoire
| Champ | Où le trouver |
|---|---|
| Workshop ID | L'identifiant numérique dans l'URL Workshop (par ex. ?id=2392709985) |
| Mod ID | Dans la description Workshop, indiqué sous la forme Mod ID: ExampleMod |
| Nom du dossier de map | Indiqué uniquement pour les mods de map, par ex. Map Folder: Bedford Falls |
Étape 1 : arrêtez le serveur avant toute modification
Project Zomboid réécrit Pterodactyl.ini et Pterodactyl_SandboxVars.lua à l'extinction. Si vous modifiez ces fichiers pendant que le serveur tourne, vos changements sont écrasés. Arrêtez d'abord le serveur depuis votre panneau, puis continuez.
Étape 2 : ouvrez Pterodactyl.ini dans le gestionnaire de fichiers
Rendez-vous dans :
/home/container/.cache/Server/Pterodactyl.ini
Si vous avez renommé votre serveur, le fichier porte votre nom personnalisé (par ex. MyServer.ini). Ouvrez-le dans l'éditeur intégré du panneau ou en SFTP.
Étape 3 : renseignez les lignes WorkshopItems et Mods
Trouvez ces deux lignes (elles existent par défaut mais sont généralement vides) :
WorkshopItems=
Mods=
Ajoutez vos identifiants séparés par des points-virgules. Exemple avec trois mods (Common Sense, Brita's Weapon Pack, ModOptions) :
WorkshopItems=2685168362;2900665603;2169435993
Mods=Common Sense;Brita;ModOptions
La ligne WorkshopItems indique à SteamCMD quels mods télécharger. La ligne Mods indique au jeu quels mods charger réellement. Les deux doivent être remplies, et l'ordre dans Mods= détermine l'ordre de chargement.
Étape 4 : ajouter des mods de map
Les mods de map demandent une ligne supplémentaire. Le champ Map= décide de la map à partir de laquelle le monde est généré. La valeur par défaut (Knox County) est Muldraugh, KY. Pour utiliser Bedford Falls, par exemple :
WorkshopItems=2392709985
Mods=BedfordFalls
Map=BedfordFalls;Muldraugh, KY
Terminez toujours la chaîne Map= par Muldraugh, KY pour que les références à la map vanilla continuent de se résoudre.
Étape 5 : ordre de chargement recommandé
Les conflits entre mods sont fréquents sur Project Zomboid. Utilisez cet ordre de chargement dans votre ligne Mods= :
- Les mods de map
- Les tile packs (par ex.
Tile Pack v1) - Les frameworks (Common Sense, ModOptions, etc.)
- Les mods de véhicules
- Les mods d'armes et d'objets
- Les mods d'interface et de confort en dernier
Étape 6 : sauvegardez, redémarrez et surveillez la console
Enregistrez le fichier, puis démarrez le serveur. SteamCMD va télécharger chaque Workshop ID listé. Un premier téléchargement peut prendre 5 à 15 minutes pour une grosse liste de mods. Surveillez la console, vous devez voir des lignes du type :
LOG : General , 1234567890, Mod "BedfordFalls" loaded.
Si vous voyez Mod "X" not found, vérifiez que le Mod ID correspond exactement à celui de la description Workshop : il est sensible à la casse.
Où les mods sont téléchargés
SteamCMD garde les mods en cache dans :
/home/container/.cache/Workshop/
/home/container/.cache/steamapps/workshop/content/108600/
Si un mod refuse de se mettre à jour, supprimer ces dossiers force un téléchargement complet au prochain démarrage.
Les joueurs ont besoin des mêmes mods
Le serveur et chaque joueur qui se connecte doivent avoir les mêmes mods activés. Les joueurs qui rejoignent le serveur sont automatiquement invités à s'abonner aux mods manquants, il leur suffit ensuite de redémarrer le jeu.
Erreurs courantes et solutions
"Mod not found in PZModFileSystem" : mauvais Mod ID. Ouvrez la page Workshop et copiez l'identifiant depuis la description, pas depuis le titre.
Le serveur crashe au démarrage après l'ajout d'un mod : l'ordre de chargement est mauvais, ou deux mods entrent en conflit. Retirez le mod et regardez ses commentaires Workshop pour d'éventuels problèmes de compatibilité.
Les téléchargements Workshop restent bloqués à 0% : l'authentification SteamCMD a échoué. Redémarrez le serveur, cela se résout généralement à la deuxième tentative.
Le mod marche en solo mais pas en multijoueur : beaucoup de mods demandent une mise à jour de Pterodactyl_spawnregions.lua ou portent une mention "SP only" explicite sur le Workshop.
FAQ
Faut-il redémarrer le serveur à chaque ajout de mod ?
Oui. Le chargement des mods n'a lieu qu'au boot. Ajouter un mod à chaud avec /changeoption ne fonctionne pas pour les champs liés aux mods.
Puis-je installer des mods qui ne viennent pas du Steam Workshop ?
Oui. Déposez le dossier du mod dans /home/container/.cache/mods/ et ajoutez uniquement le Mod ID (pas le Workshop ID) à votre ligne Mods=.
Combien de mods, c'est trop ? La plupart des serveurs B42 tournent confortablement avec 20 à 60 mods. Au-delà de 80, attendez-vous à des temps de boot 2x plus longs et à une consommation de RAM plus élevée. Utilisez notre calculateur de RAM pour prévoir en conséquence.
Les mods affectent-ils les performances du serveur ? Oui. Les gros mods de gameplay (Brita's, extensions de véhicules) ajoutent 1 à 3 Go de RAM et peuvent ralentir le chargement des chunks. Les petits mods de confort sont pour ainsi dire gratuits.
