Dernière vérification : 27 septembre 2026. Le serveur dédié charge les addons Workshop de Garry’s Mod via une collection Workshop. À partir de Garry’s Mod 2026.09.22, il peut également récupérer des ID individuels depuis cfg/srcds_workshop_ids.txt. resource.AddWorkshop() distribue les fichiers nécessaires aux clients, mais n’installe lui-même aucun addon sur le serveur. Le guide actuel de Facepunch décrit les deux méthodes côté serveur.
Prérequis
Tu as besoin d’accéder au paramètre de collection Workshop de ton serveur Garry’s Mod ainsi que d’une collection publique ou non répertoriée. Dans le panel game-serverhosting, la variable WORKSHOP_ID est prévue à cet effet. Vérifie les dépendances des addons et teste les modifications par petits groupes. Le guide actuel de Facepunch n’exige pas systématiquement de clé d’API Web Steam pour cette procédure.
Créer une collection Workshop
- Rends-toi sur le Steam Workshop
- Crée une nouvelle collection
- Ajoute tous les addons souhaités
- Copie l’ID de la collection
L’ID de la collection figure dans l’URL de la collection Steam. Copie uniquement l’ID numérique, pas l’URL complète. Veille à ce que la collection soit publique ou non répertoriée ; d’après Facepunch, le serveur ne peut pas récupérer les collections privées. Si un addon est supprimé, passé en privé ou mis à jour par son auteur, cela peut avoir des conséquences sur le démarrage de ton serveur ou sur les téléchargements côté client. Après des modifications importantes, vérifie donc toujours la console du serveur.
Charger la collection sur le serveur
Dans le panel game-serverhosting, saisis l’ID numérique de la collection dans les variables de démarrage, sous Collection Workshop (WORKSHOP_ID), puis redémarre le serveur. Sur les serveurs gérés par tes soins, le paramètre de démarrage correspondant est :
+host_workshop_collection <collection_id>
Vérifie les messages Workshop dans la console du serveur. En cas d’erreur, contrôle d’abord l’ID, la visibilité et l’accessibilité des addons. Une étape -authkey systématique ne fait pas partie de la procédure actuelle de Facepunch.
ID Workshop individuels au lieu d’une collection
Avec Garry’s Mod 2026.09.22 ou plus récent, tu peux, en complément ou à la place d’une collection, créer le fichier cfg/srcds_workshop_ids.txt. Le format est décrit dans la documentation du serveur dédié. Vérifie la version installée du serveur avant d’utiliser cette méthode. Le fichier contient les ID d’addons individuels, pas l’ID d’une collection.
Les joueurs téléchargent les contenus nécessaires
resource.AddWorkshop() déclenche le téléchargement pour les clients. Il n’installe aucun addon sur le serveur. Utilise-le de façon ciblée pour des modèles, matériaux ou sons supplémentaires :
-- garrysmod/lua/autorun/server/workshop.lua
resource.AddWorkshop("TON_ID_ADDON")
Remplace TON_ID_ADDON par l’ID Workshop numérique d’un addon disponible contenant des contenus client. Les addons purement Lua n’ont pas besoin de cette entrée. La map actuelle et un mode de jeu compatible Workshop sont automatiquement marqués pour les clients à partir de la collection du serveur. Consulte la documentation de Facepunch sur resource.AddWorkshop et teste la connexion sans abonnement local à l’addon.
Catégories d’addons populaires
| Catégorie | Exemples |
|---|---|
| Maps | ttt_minecraft, ph_office |
| Armes | M9K Weapons, TFA Base |
| Playermodels | PM + Playermodel Selector |
| Outils | Wiremod, Precision Tool |
| HUD | DarkRP HUD, TTT HUD |
Ces catégories sont des exemples typiques, pas une recommandation pour chaque configuration. Les serveurs DarkRP, TTT, Prop Hunt et Sandbox ont des besoins différents. L’essentiel est que les addons correspondent au mode de jeu, soient activement maintenus et n’apportent pas de fonctions en double. Deux bases d’armes, plusieurs HUD ou plusieurs outils d’administration peuvent se gêner mutuellement.
Si tu gères aussi d’autres jeux avec des workflows de mods, les principes du guide Workshop de Project Zomboid et du guide d’installation de mods ARK t’aideront : clarifie d’abord les dépendances, saisis ensuite les ID proprement, puis vérifie avec les logs et un test client.
Vérifier le résultat
Redémarre le serveur après chaque modification importante et contrôle trois points. Premièrement : la console ne doit afficher aucune erreur Workshop concernant la collection ou les ID individuels. Deuxièmement : les addons souhaités doivent être disponibles côté serveur, par exemple les maps dans la liste des maps ou les outils dans le mode de jeu approprié. Troisièmement : un client de test doit télécharger automatiquement les contenus nécessaires lors de la connexion ou ne présenter aucun problème de texture manquante.
Dans la mesure du possible, teste avec un client qui n’est pas déjà abonné localement aux addons. Sinon, tu risques de ne pas remarquer que le téléchargement automatique ne fonctionne pas pour les nouveaux joueurs. Sur les serveurs publics, il est en outre judicieux d’ajouter une courte mention dans la description du serveur lorsque des contenus très volumineux doivent être téléchargés.
Dépannage
- L’addon ne se charge pas côté serveur : vérifie l’ID de la collection, la visibilité, la page Workshop et la console de démarrage. Pour le fichier d’ID individuels, la version 2026.09.22 ou plus récente est requise.
- Les joueurs voient des textures manquantes : vérifie les dépendances des addons et la distribution côté client. Depuis la mise à jour de juillet 2025, la plupart des contenus CS:S sont inclus ; les maps et quelques autres fichiers font exception. Ne téléverse pas de packs de contenu commerciaux tiers sur le Workshop : les règles du Workshop de Facepunch l’interdisent.
- Le téléchargement est long : retire de la collection les maps inutilisées, les modèles en double et les anciens paquets.
Vérification, limites et retour arrière sécurisé
Le guide « Installer des addons Workshop pour Garry's Mod » s’applique au type de serveur décrit dans l’article et à la version visible au moment de la vérification. Les noms de menus, les versions disponibles, la compatibilité des mods ou plugins et les ressources nécessaires peuvent différer après des mises à jour. Ne transpose donc pas des valeurs sans vérification vers un autre jeu, un autre loader ou une autre version de serveur.
Avant toute modification du monde, de la sauvegarde, de la configuration ou des extensions, fais une sauvegarde des fichiers concernés. Modifie ensuite une seule étape cohérente à la fois et vérifie-la avec la même version de client et de serveur que celle avec laquelle tu joueras plus tard.
| Point de contrôle | Résultat attendu | Abandon et retour arrière |
|---|---|---|
| Démarrage du serveur | Le serveur atteint l’état opérationnel sans nouveau message d’erreur. | En cas d’erreur au démarrage, annule la modification et restaure la dernière sauvegarde. |
| Test de connexion | Un compte de test peut se connecter via l’adresse affichée dans le panel. | En cas d’erreur de version ou de connexion, vérifie à nouveau la version, le port et les redirections. |
| Test de fonctionnement | La fonction modifiée marche, sans endommager le monde ni les données de jeu existants. | En cas d’effets secondaires, arrête le serveur et restaure les fichiers sauvegardés. |
Un test individuel réussi n’est pas une garantie de performance ou de disponibilité. La taille du monde, les mods, les plugins, le nombre de joueurs, le chemin réseau et la charge simultanée peuvent modifier le résultat. Documente la version, la modification et le résultat du test afin de pouvoir retracer les écarts ultérieurs.
FAQ
Ai-je toujours besoin d’une collection Workshop ?
Non. Une collection est pratique pour plusieurs addons. Depuis la version 2026.09.22, le serveur peut aussi charger des ID individuels depuis cfg/srcds_workshop_ids.txt. resource.AddWorkshop() ne contrôle que le téléchargement côté client.
Quelle est la différence entre l’ID de collection et l’ID Workshop ?
L’ID de collection désigne un ensemble d’addons et se place dans la variable de panel WORKSHOP_ID ou avec +host_workshop_collection. Les ID d’addons individuels peuvent figurer dans cfg/srcds_workshop_ids.txt à partir de la version 2026.09.22. resource.AddWorkshop() utilise également un ID d’addon individuel, mais uniquement pour les fichiers client.
Pourquoi les joueurs voient-ils des textures manquantes ?
Vérifie l’addon concerné, ses dépendances et le téléchargement côté client. Garry’s Mod inclut la plupart des assets CS:S depuis juillet 2025 ; les maps et quelques fichiers font exception. Un « pack de contenu CSS » générique n’est pas une solution fiable.
Dois-je redémarrer le serveur après chaque modification d’addon ?
Pour les modifications des paramètres de démarrage, de la collection Workshop ou des fichiers Lua côté serveur, tu devrais redémarrer. C’est le seul moyen de vérifier de manière fiable que le serveur charge correctement la collection et enregistre les ressources client.
Quelle taille doit faire une collection ?
Aussi petite que possible et aussi grande que nécessaire. Retire les addons que ton mode de jeu n’utilise pas activement. Cela facilite la recherche d’erreurs, garde les téléchargements raisonnables et rend les modifications en cours d’exploitation plus faciles à maîtriser.