Installer des mods Steam Workshop sur un serveur Project Zomboid : Mods= et WorkshopItems= expliqués

Vous voulez ajouter Brita’s Weapon Pack, ORGM, Better Sorting ou tout autre mod Workshop à votre serveur Project Zomboid Build 42 ? Ce guide détaille la procédure complète : trouver le Mod ID et le Workshop ID, les ajouter dans servertest.ini, gérer le load order et synchroniser les clients. Toutes les infos sont vérifiées contre la documentation officielle, Nodecraft, Akliz, Shockbyte et PineHosting.

Pour un serveur Project Zomboid chez HebergTonServ, 16 Go de RAM sont dimensionnés pour les setups modés lourds (Brita + ORGM + Hydrocraft + autonomic).

Comment fonctionnent les mods PZ

Project Zomboid Workshop = système automatique côté serveur. Vous listez les Workshop IDs dans servertest.ini, et le serveur télécharge tout au démarrage suivant — pas besoin d’uploader manuellement les fichiers (contrairement à Conan Exiles).

Côté client : tous les joueurs doivent avoir les mêmes mods. PZ vérifie au login — un joueur sans le mod sera disconnecté avec “Unknown Mod ID”.

Les 2 IDs à connaître

Les deux sont différents et obligatoires. WorkshopItems= télécharge, Mods= active.

Étape 1 — Trouver les mods sur Workshop

1. Allez sur https://steamcommunity.com/app/108600/workshop/
2. Filtrez par tag ou cherchez par nom
3. Cliquez sur le mod qui vous intéresse

Récupérer le Workshop ID

Le Workshop ID est dans l’URL du mod :

https://steamcommunity.com/sharedfiles/filedetails/?id=2392709985
                                                       ^^^^^^^^^^
                                                       Workshop ID

Récupérer le Mod ID

Plus délicat. 3 méthodes :

Méthode 1 — Description Workshop : la plupart des moddeurs affichent le Mod ID dans la description du mod, parfois sous forme :

Workshop ID: 2392709985
Mod ID: tsarslib

Méthode 2 — Inspecter localement : abonnez-vous au mod sur Steam, lancez PZ une fois, puis allez dans :

C:\Program Files (x86)\Steam\steamapps\workshop\content\108600\<Workshop ID>\mods\<Mod ID>\mod.info

Le nom du dossier <Mod ID> est ce qu’il faut.

Méthode 3 — Hubs communautaires : sites comme pzmods.net listent les Mod IDs.

Étape 2 — Trouver vos mods sur le client

Si vous êtes déjà abonné côté client et que vous avez lancé PZ une fois :

Windows

C:\Program Files (x86)\Steam\steamapps\workshop\content\108600\

Linux

~/.steam/steam/steamapps/workshop/content/108600/

Chaque sous-dossier numéroté = 1 mod. À l’intérieur, mods/<ModID>/mod.info contient les détails.

Astuce : créez une collection Workshop privée avec tous vos mods serveur. Vous l’utiliserez pour partager aux joueurs (étape 5).

Étape 3 — Éditer servertest.ini

Arrêtez le serveur. Ouvrez :

Zomboid/Server/servertest.ini

Cherchez les 2 lignes :

Mods=
WorkshopItems=

Syntaxe — séparateur point-virgule

Mods=tsarslib;Brita;ORGM
WorkshopItems=2392709985;2818847163;2189311312

Important : pas d’espaces, séparateur point-virgule ; entre chaque entrée.

Ordre = priorité de chargement

Les mods sont chargés dans l’ordre listé. Le dernier prend priorité en cas de conflit. Règle d’or :

1. Frameworks/libraries en premier (tsarslib, BetterSortPlus)
2. Total conversions / overhauls ensuite (AuthenticZ, ORGM)
3. Tweaks et UI en dernier (HydrocraftBananas, BetterSortAlt)

Étape 4 — Démarrer le serveur

Sauvegardez servertest.ini. Démarrez le serveur :

./start-server.sh
# ou
StartServer64.bat

Au premier démarrage avec mods, PZ télécharge les Workshop items :

LOG  : Workshop : Downloading 2392709985
LOG  : Workshop : Downloaded 2392709985 (45 MB)
LOG  : Mods : Loading mod tsarslib
LOG  : Mods : Loading mod Brita

Patientez — gros mods (Brita = 1+ Go) peuvent prendre plusieurs minutes.

Si un mod échoue à se charger, le serveur logge l’erreur dans server-console.txt et démarre quand même sans ce mod. Vérifiez les logs.

Étape 5 — Distribuer aux joueurs

Vos joueurs doivent avoir les mêmes mods activés.

Solution 1 — Collection Workshop (recommandée)

1. Steam Workshop → Créer une collection
2. Ajoutez tous vos mods serveur
3. Rendez-la publique ou unlisted (avec lien)
4. Partagez aux joueurs : ils cliquent S’abonner à tous
5. Au login serveur, PZ active automatiquement les mods côté client

Solution 2 — Liste manuelle

Donnez aux joueurs la liste des Workshop IDs. Ils s’abonnent un par un, lancent PZ, et c’est PZ qui active les mods automatiquement à la première connexion serveur.

Étape 6 — Mettre à jour les mods

Quand un mod publie une MAJ :

1. Arrêtez le serveur
2. Le serveur re-télécharge automatiquement la dernière version au prochain démarrage (workshop sync)
3. Demandez aux joueurs de MAJ leurs mods Steam côté client
4. Démarrez le serveur

Mismatch fréquent : un joueur sans la MAJ ne pourra pas se co. Annoncez les MAJ sur Discord à l’avance.

Workflow concret — exemple Brita + ORGM

Objectif : ajouter Brita’s Weapon Pack + ORGM Rechambered.

Récupérer les IDs

Éditer servertest.ini

Mods=Brita;Brita_2;ORGMRechambered
WorkshopItems=2200148440;2487022075;2349356023

Redémarrer

PZ télécharge les 3 mods (~2 Go total), puis charge le monde modé.

Joueurs

Créez une collection Workshop avec ces 3 mods et partagez-la. Les joueurs s’abonnent, PZ sync, ils peuvent se co.

Mods serveur populaires (2026)

⚠️ Vérifiez toujours la compatibilité Build 41 vs Build 42 sur la page Workshop avant d’ajouter.

Troubleshooting

”Unknown Mod ID” au login client

Le client n’a pas tous les mods, ou pas activés. Solutions :

1. Vérifier que le client est abonné à TOUS les mods de votre collection
2. Lancer PZ → menu Mods → activer manuellement les mods listés
3. Vérifier que la version PZ est la même (Build 42 client vs 41 serveur = échec)

Le serveur ne télécharge pas les mods

Causes :

• Erreur dans WorkshopItems= (espace, virgule au lieu du ;, ID incomplet)
• Mod retiré du Workshop par l’auteur
• Steam down (rare)

Logs à consulter : server-console.txt.

Conflit entre mods (crashes)

Cherchez dans server-console.txt la stack Lua. Le mod fautif est mentionné. Solutions :

1. Tester en désactivant un par un (commenter dans Mods=)
2. Changer l’ordre dans Mods=
3. Reporter le bug à l’auteur du mod

Le serveur charge des mods que je n’ai pas listés

PZ peut charger des dépendances cachées (mods enfants). Vérifiez la page Workshop des mods listés — souvent la description précise les dépendances. Ajoutez-les explicitement.

FAQ

Combien de mods maximum sur un serveur PZ ?

Pas de limite stricte. Pratiquement, au-delà de 30 mods, vous aurez du chargement lent et des conflits possibles. Beaucoup de serveurs FR tournent avec 8-15 mods bien choisis.

Les mods consomment beaucoup de RAM ?

Variable. Brita seul ajoute ~500 Mo. Hydrocraft ~1 Go. Avec 5+ mods lourds, comptez 8-12 Go RAM minimum côté serveur. C’est précisément pour ça que HebergTonServ propose 16 Go par défaut.

Faut-il acheter PZ pour héberger ?

Non — le serveur dédié (App ID 380870) est gratuit. Mais pour télécharger les mods Workshop côté client et les tester, il vous faut une copie du jeu (App ID 108600).

Le serveur télécharge à chaque démarrage ?

Non — Steam ne re-télécharge que si une MAJ est dispo. La cache reste dans ~/.steam/steam/steamapps/workshop/content/108600/ (ou équivalent Windows).

Build 41 et Build 42 partagent les mods ?

Non. Beaucoup de mods Build 41 ne sont pas compatibles Build 42 sans port. Filtrez vos mods sur Workshop par tag “Build 42” pour ne voir que les compatibles.

Comment forcer un mod à recharger sa config ?

/reloadlua en console admin recharge les fichiers Lua sans redémarrer le serveur. Utile pour les mods qui exposent des configs modifiables à chaud. Voir : commandes admin PZ.

Conclusion

Installer des mods Steam Workshop sur votre serveur Project Zomboid est plus simple que sur la plupart des autres jeux : pas d’upload manuel de fichiers, juste 2 lignes dans servertest.ini. La difficulté est dans le bon Mod ID + bon load order + sync clients via collection Workshop.

Pour un hébergeur Project Zomboid avec 16 Go de RAM dimensionnée pour les setups modés Build 42 et installation auto, HebergTonServ est la référence française dès 25,90€/mois.

Pour aller plus loin

• Installer un serveur Project Zomboid via SteamCMD
• Configurer servertest.ini Project Zomboid
• Régler Sandbox.lua Project Zomboid
• Liste commandes admin Project Zomboid
• Hébergeur Project Zomboid dès 25,90€/mois