Comment ajouter des mods à un serveur Project Zomboid

Comment fonctionnent les mods sur un serveur Project Zomboid : Workshop ID et Mod ID

• Workshop ID — le nombre à la fin de l'adresse Steam Workshop du mod, par exemple 2169435993. Il indique au serveur quoi télécharger.
• Mod ID — le nom que le mod utilise dans le jeu, indiqué sur la page Workshop (généralement vers le bas, sous la forme Mod ID:) et dans le fichier mod.info du mod. Il indique au serveur quoi charger.

Un même élément du Workshop peut contenir plusieurs mods, chacun avec son propre Mod ID. N'ajoutez que les Mod ID que vous voulez — la page indique souvent lequel choisir.

Ajouter des mods dans servertest.ini

Le fichier de paramètres du serveur est Zomboid/Server/servertest.ini (il porte le nom de votre serveur). Arrêtez le serveur, puis remplissez deux lignes :

WorkshopItems=2169435993;2392709985
Mods=ModA;ModB

• WorkshopItems — les Workshop ID, séparés par des points-virgules, sans espaces.
• Mods — les Mod ID de ces éléments, séparés eux aussi par des points-virgules.

Démarrez le serveur. Il télécharge les éléments du Workshop et charge les mods, et les joueurs les reçoivent automatiquement en se connectant.

Build 42 ou Build 41 : ce qui change pour les mods

Build 42 est la version stable actuelle (42.21) ; Build 41 reste disponible en branche legacy pour les anciennes listes de mods.

• Les mods sont faits pour l'un ou l'autre build. Un mod Build 42 a ses fichiers dans un dossier common ou 42 ; un mod Build 41 non. Certains éléments du Workshop contiennent les deux. Un mod qui n'est pas fait pour le build de votre serveur est ignoré.
• L'antislash. Build 42 affiche les Mod ID précédés d'un antislash, comme \ModA. Sur un serveur Build 42, vous pouvez les écrire avec ou sans — le serveur le retire. Sur un serveur Build 41, n'en ajoutez jamais : il y devient une partie du nom et le mod est introuvable.
• Vérifiez sur la page Workshop quel build un mod prend en charge avant de l'ajouter, et gardez toute la liste sur un seul build.

Mods de cartes et ordre de chargement

Les cartes demandent une troisième ligne. En plus du Workshop ID et du Mod ID, ajoutez le nom du dossier de la carte dans Map=, en gardant la carte de base dans la liste :

Map=MyMapFolder;Muldraugh, KY

La page Workshop de la carte donne le nom du dossier et sa place dans la liste — suivez-la, surtout si vous combinez plusieurs cartes.

L'ordre de chargement suit l'ordre de Mods=. Si un mod en requiert un autre, le serveur charge d'abord cette dépendance de lui-même — mais seulement si elle est installée, donc son Workshop ID doit aussi figurer dans WorkshopItems. Un mod dont la dépendance manque est ignoré.

Garder ses mods à jour

Quand un mod du Workshop est mis à jour, les joueurs téléchargent la nouvelle version, mais le serveur garde l'ancienne jusqu'à son redémarrage — et un joueur dont la copie ne correspond plus peut avoir du mal à se connecter.

• Redémarrez pour mettre à jour. À chaque démarrage, le serveur télécharge tout élément du Workshop manquant ou obsolète.
• Vérifier sans redémarrer : la commande admin checkModsNeedUpdate demande à Steam si l'un de vos éléments a changé et écrit la réponse dans le chat et le log. Elle se contente de signaler ; elle ne met rien à jour.
• Prévenez les joueurs et redémarrez quand elle signale une mise à jour, idéalement selon un planning.

Quand un mod ne se charge pas

• Mauvais ID dans la mauvaise ligne — les Workshop ID (des nombres) vont dans WorkshopItems, les Mod ID dans Mods.
• Des espaces ou un point-virgule manquant dans l'une des listes.
• Le mod est fait pour l'autre build — vérifiez la page Workshop ; sur Build 41, retirez tout antislash.
• Une dépendance manque — ajoutez aussi le Workshop ID et le Mod ID du mod requis.
• Lisez le log — le serveur indique quels mods il a chargés, lesquels il a ignorés, et pourquoi.

Les mods sur un serveur Project Zomboid HytHost

1. Saisissez les ID dans l'onglet Startup. Il contient un champ pour les éléments Workshop et un autre pour Mods. Le panel les écrit dans servertest.ini à chaque démarrage, alors ajoutez vos mods là — les mods saisis directement dans le fichier sont remplacés au démarrage suivant.
2. Les cartes font exception : modifiez la ligne Map= de servertest.ini avec le gestionnaire de fichiers.
3. Redémarrez depuis le panel. Le serveur télécharge les mods au démarrage, et le jeu lui-même est aussi mis à jour avant chaque démarrage.
4. Choisissez le build à la commande : Build 42 ou la branche legacy Build 41. En changer plus tard implique une réinstallation, alors faites d'abord une sauvegarde.

Les autres paramètres du serveur sont expliqués dans Paramètres du serveur Project Zomboid, et les offres sont sur Hébergement Project Zomboid.