Aller au contenu
+90 850 303 07 52 [email protected]
Assistance Espace client
Sur une sélection d'offres d'hébergement annuelles et de VDS sur 3 mois, nom de domaine .com / .com.tr offert la première année · Voir les offres

Guides

Des guides pas à pas pour installer et gérer votre propre serveur, serveur de jeu ou site web, rédigés par l'équipe qui exploite notre infrastructure à Istanbul.

Garry's Mod

Comment ajouter des addons Workshop (Atelier) à un serveur GMod ?

26 août 2026 14 min de lecture Mis à jour :
Partager cet article

Dans ce guide, vous apprendrez à ajouter des addons du Steam Workshop (Atelier) à votre serveur Garry's Mod (GMod) : relier une collection au serveur, lister les identifiants des addons dans le fichier srcds_workshop_ids.txt et faire en sorte que les modèles, textures et sons soient aussi téléchargés par les joueurs grâce à resource.AddWorkshop. Vous verrez aussi étape par étape comment installer des addons de type dossier absents du Workshop et résoudre le problème le plus fréquent, celui des modèles ERROR.

Avant de commencer

Ce guide suppose que le serveur est installé et qu'il démarre. Si SteamCMD, le GSLT (Game Server Login Token, jeton de connexion du serveur de jeu) et la commande de lancement ne sont pas encore prêts, suivez d'abord le guide d'installation d'un serveur Garry's Mod de zéro. Les chemins ci-dessous reprennent les dossiers de ce guide : C:\GModServer sous Windows, /home/steam/gmod sous Linux. Les autres sujets sont regroupés sur la page Guides Garry's Mod.

  • Compte Steam : il est nécessaire pour créer la collection et y ajouter les addons.
  • Accès au serveur : vous vous connectez au VDS Windows en RDP (Bureau à distance) et au VDS Linux en SSH ; sous Linux, vous pouvez utiliser SFTP pour envoyer des fichiers. Si la connexion échoue, la console VNC de l'Espace client affiche l'écran du serveur dans votre navigateur.
  • Marge de ressources : les gros packs de maps et de modèles remplissent vite le disque, et chaque addon qui exécute du code Lua ajoute de la charge au processeur. Au fur et à mesure que vous ajoutez des addons, surveillez l'utilisation du disque, de la RAM et du CPU dans les graphiques d'utilisation en direct de l'Espace client. La vitesse d'un seul cœur étant déterminante, la gamme VDS AMD Ryzen 9 9950X est recommandée pour les serveurs de jeu.
  • Sauvegarde : la sauvegarde automatique n'est pas incluse dans les VDS. Avant toute modification, copiez les dossiers garrysmod/addons, garrysmod/cfg, garrysmod/data et garrysmod/lua en dehors du serveur.

Il existe trois façons d'installer un addon sur le serveur :

MéthodeArrivée sur le serveurTéléchargement du contenu par les joueursQuand l'utiliser
Collection WorkshopTéléchargée et mise à jour au démarrage avec +host_workshop_collectionresource.AddWorkshop (map et mode de jeu automatiques)Si la plupart des addons sont sur le Workshop ; méthode recommandée
srcds_workshop_ids.txtLes identifiants du fichier sont téléchargés au démarrageresource.AddWorkshopSi vous préférez garder la liste sur le serveur plutôt que sur Steam
Addon de type dossier (legacy, ancien format)Envoyé manuellement dans garrysmod/addonsFastDL (téléchargement rapide), ou publication du contenu sur le Workshop puis resource.AddWorkshopSi l'addon n'est pas sur le Workshop

1. Créer une collection sur Steam

Dans Steam, ouvrez l'Atelier de Garry's Mod et créez une nouvelle collection depuis la section des collections. Ajoutez ensuite à cette collection chaque addon que vous voulez sur le serveur, avec le bouton d'ajout à une collection de sa page. Faites attention à trois points :

  • Visibilité : la collection doit être publique (public) ou non répertoriée (unlisted). D'après la page Workshop for Dedicated Servers de Facepunch, le serveur (srcds) ne peut pas accéder à la collection dans le cas contraire. Si vous ne voulez pas que la collection apparaisse dans les recherches, l'option non répertoriée suffit.
  • Identifiant : l'identifiant de la collection est la valeur ?id= de l'adresse de la page de la collection ; dans l'adresse https://steamcommunity.com/sharedfiles/filedetails/?id=123456789, cette valeur est 123456789. Le numéro situé au même endroit sur la page d'un addon est l'identifiant de cet addon ; ne confondez pas les deux.
  • Collections imbriquées : le serveur télécharge aussi les sous-collections contenues dans la collection. Si vous gérez des collections distinctes pour les maps et les armes, ajoutez-les à une collection parente unique et indiquez au serveur l'identifiant de cette collection parente.

2. Ajouter la collection à la commande de lancement

À la fin de la commande de lancement préparée dans le guide d'installation, ajoutez le paramètre +host_workshop_collection suivi de l'identifiant de votre collection. À chaque démarrage, le serveur télécharge les addons de la collection, vérifie s'ils sont à jour et les monte (mount).

Windows (C:\GModServer\start.bat) :

@echo off
srcds.exe -console -game garrysmod -port 27015 -tickrate 66 +maxplayers 24 +gamemode sandbox +map gm_construct +sv_setsteamaccount YOUR_GSLT_TOKEN +host_workshop_collection 123456789

Linux (/home/steam/gmod/start.sh) :

#!/bin/bash
cd /home/steam/gmod
./srcds_run -game garrysmod -port 27015 -tickrate 66 +maxplayers 24 +gamemode sandbox +map gm_construct +sv_setsteamaccount YOUR_GSLT_TOKEN +host_workshop_collection 123456789

Enregistrez le fichier et redémarrez le serveur. Selon la taille de la collection, le premier démarrage peut être long ; suivez dans la console les lignes qui montrent le téléchargement et le montage des addons. N'oubliez pas le signe + au début du paramètre : les valeurs qui commencent par + sont appliquées comme variable de console (ConVar) ou comme commande une fois le jeu démarré.

Pour démarrer sur une map de la collection, indiquez comme valeur de +map le nom du fichier .bsp de la map, sans extension. Si le nom de la map en cours correspond à une map de la collection, les joueurs la téléchargent automatiquement et la ligne Making workshop map available for client download apparaît dans la console. Pour les détails sur les maps personnalisées, consultez le guide Installer une map personnalisée sur GMod.

3. Variante : liste d'identifiants avec srcds_workshop_ids.txt

À partir de la version 2026.09.22 de Garry's Mod, vous pouvez aussi lister les identifiants Workshop dans un fichier de configuration. Ce fichier peut remplacer la collection ou la compléter ; vous n'avez ainsi plus besoin de passer par Steam pour modifier la liste. Créez manuellement le fichier garrysmod/cfg/srcds_workshop_ids.txt et respectez la structure de l'exemple de Facepunch :

"my_workshop_addons"
{
	"1"
	{
		"wsid"	"111111111"
	}
	"2"
	{
		"wsid"	"222222222"
	}
}

Pour chaque addon, ouvrez un nouveau bloc avec le numéro suivant, comme dans l'exemple, et indiquez l'identifiant de l'addon comme valeur de wsid. S'il manque une accolade ou un guillemet, le fichier n'est pas lu correctement. Après toute modification, redémarrez le serveur. Si votre serveur est antérieur à cette version, le fichier est ignoré ; mettez d'abord le serveur à jour en relançant la commande SteamCMD du guide d'installation (+app_update 4020 validate).

4. Faire télécharger le contenu par les joueurs : resource.AddWorkshop

La collection installe les addons sur le serveur, mais ne les fait pas télécharger par les joueurs. Si un joueur n'a pas les addons de contenu (modèles, textures, sons) autres que la map et le mode de jeu, il voit ces objets sous forme d'inscription ERROR ou de damier violet et noir. La page Serving Content de Facepunch présente le téléchargement via le Workshop comme la façon la plus rapide d'envoyer du contenu. Pour cela, créez un fichier Lua exécuté côté serveur.

Windows : créez le dossier C:\GModServer\garrysmod\lua\autorun\server s'il n'existe pas. Écrivez les lignes ci-dessous dans « Notepad » (Bloc-notes) ; dans la fenêtre « Save As » (Enregistrer sous), choisissez le type All Files (tous les fichiers) et nommez le fichier workshop.lua. Sinon, le fichier est enregistré sous le nom workshop.lua.txt et ne fonctionne pas.

Linux (avec l'utilisateur steam) :

mkdir -p /home/steam/gmod/garrysmod/lua/autorun/server
nano /home/steam/gmod/garrysmod/lua/autorun/server/workshop.lua

Le fichier contient une ligne par addon de contenu :

-- Contenus Workshop à télécharger par les joueurs
resource.AddWorkshop("111111111") -- exemple : pack de modèles
resource.AddWorkshop("222222222") -- exemple : pack de sons

Dans nano, enregistrez avec Ctrl+S, quittez avec Ctrl+X et redémarrez le serveur. Les fichiers du dossier lua/autorun/server s'exécutent automatiquement au démarrage, côté serveur uniquement. En préparant la liste, respectez ces règles :

  • N'ajoutez que des addons de contenu. Ajouter à cette liste des addons qui ne contiennent que des fichiers Lua ne sert à rien et impose aux joueurs un téléchargement inutile. Les fichiers Lua parviennent aux joueurs par une autre voie, sans réglage supplémentaire.
  • N'indiquez pas d'identifiant de collection. resource.AddWorkshop accepte l'identifiant d'un addon unique, pas celui d'une collection.
  • N'ajoutez pas une seconde fois la map et le mode de jeu. Si la map en cours fait partie de la collection, ou si un workshopid est défini dans le fichier garrysmod/gamemodes/<gamemode>/<gamemode>.txt du mode de jeu, ils sont téléchargés automatiquement.
  • Connaissez la limite. D'après Facepunch, toutes les fonctions resource.Add* partagent une limite de 8192 fichiers téléchargeables ; si vous approchez de cette limite, allégez votre liste de téléchargement.

Les joueurs peuvent choisir dans les options du jeu les types de fichiers qu'ils téléchargent. Si tout est correct sur votre serveur mais qu'un seul joueur voit des ERROR, demandez-lui d'abord de vérifier son réglage de téléchargement. Les détails de la fonction figurent sur la page resource.AddWorkshop.

5. Gérer les mises à jour des addons

Par défaut, le serveur vérifie à chaque démarrage si les addons de la collection sont à jour ; pour obtenir la nouvelle version d'un addon, il suffit de redémarrer le serveur. Pour désactiver la mise à jour au démarrage, ajoutez ceci à la commande de lancement :

+host_workshop_autoupdate 0

Ce réglage protège votre serveur lorsque l'auteur d'un addon y publie une modification indésirable ou malveillante. La contrepartie : le serveur reste sur l'ancienne version alors que les joueurs peuvent récupérer la version à jour sur le Workshop. Comme Facepunch le signale, une map mise à jour peut ainsi empêcher les joueurs de rejoindre le serveur. Si vous avez désactivé la mise à jour, mettez vous-même les addons à jour à intervalles réguliers : passez temporairement la valeur à 1 et redémarrez le serveur ; si aucun problème n'apparaît, remettez-la à 0. Avant chaque mise à jour groupée, sauvegardez les dossiers addons, cfg et data ; l'espace de sauvegarde cloud, accessible en SFTP, est une destination adaptée.

6. Addons absents du Workshop : le dossier addons

Les addons non publiés sur le Workshop s'installent comme addons de type dossier (legacy). Chaque addon doit avoir son propre dossier dans garrysmod/addons, et le contenu de ce dossier suit la structure du dossier garrysmod. Tous les sous-dossiers sont facultatifs ; seuls ceux dont l'addon a besoin sont présents :

garrysmod/addons/example_addon/
    lua/autorun/server/example_sv.lua
    materials/example/
    models/example/

Si votre addon se présente sous la forme d'un seul fichier .gma, extrayez-le d'abord dans un dossier. C'est le rôle de l'outil gmad.exe, situé dans le dossier bin de Garry's Mod ; vous accédez à ce dossier dans Steam par un clic droit sur le jeu, puis « Gérer » > « Parcourir les fichiers locaux ». Exécutez la commande sur votre propre ordinateur Windows, dans une invite de commandes ouverte dans ce dossier bin, puis envoyez le dossier obtenu sur le serveur :

gmad.exe extract -file "C:\downloads\example_addon.gma" -out "C:\downloads\example_addon"

Sur les serveurs Linux, faites attention à deux points. D'après Facepunch, des noms de dossiers contenant des majuscules peuvent empêcher d'anciens addons de fonctionner ; passez les noms de dossiers en minuscules et corrigez en conséquence les chemins dans le code Lua. Si vous avez envoyé les fichiers en SFTP avec le compte root, attribuez-en la propriété à l'utilisateur steam qui exécute le serveur (si vous êtes connecté en root, le sudo du début est inutile) :

sudo chown -R steam:steam /home/steam/gmod/garrysmod/addons

Les modèles et textures des addons de type dossier ne sont pas téléchargés automatiquement par les joueurs. Vous pouvez les distribuer avec FastDL (téléchargement rapide), ou publier les fichiers de contenu sur le Workshop et les ajouter à la liste de l'étape 4. Pour la publication, placez dans le dossier de contenu un fichier addon.json dont le type (type) est ServerContent ; le format du fichier est décrit sur la page Workshop Addon Creation de Facepunch. Empaquetez ensuite le dossier en fichier .gma avec gmad.exe et publiez-le avec gmpublish.exe. Les deux outils se trouvent dans le même dossier bin ; pour -icon, fournissez une image de couverture au format .jpg :

gmad.exe create -folder "C:\downloads\example_content" -out "C:\downloads\example_content.gma"
gmpublish.exe create -addon "C:\downloads\example_content.gma" -icon "C:\downloads\example_content.jpg"

Ne publiez pas le contenu d'autrui sans autorisation. N'utilisez pas la méthode de téléchargement direct depuis le serveur (sv_allowdownload) ; Facepunch la considère comme obsolète, très lente et exploitable.

Exemple de configuration

Le tableau ci-dessous regroupe les fichiers et paramètres utilisés dans ce guide. Les chemins sont relatifs au dossier garrysmod.

Fichier / paramètreEmplacementRôleExemple
+host_workshop_collectionCommande de lancementTélécharge, met à jour et monte la collection au démarrage+host_workshop_collection 123456789
+host_workshop_autoupdateCommande de lancementAvec 0, aucune mise à jour au démarrage+host_workshop_autoupdate 0
srcds_workshop_ids.txtcfg/Liste d'identifiants à la place ou en complément de la collection (2026.09.22 et versions suivantes)"wsid" "111111111"
workshop.lualua/autorun/server/Fait télécharger les addons de contenu par les joueursresource.AddWorkshop("111111111")
workshopidgamemodes/<gamemode>/<gamemode>.txtFait télécharger automatiquement le mode de jeu par les joueurs"workshopid" "111111111"
Addon de type dossieraddons/<addon>/Installe sur le serveur un addon absent du Workshopaddons/example_addon/

Erreurs fréquentes

  • La collection n'est jamais téléchargée : la collection n'est ni publique ni non répertoriée, l'identifiant indiqué est celui d'un addon, ou le serveur n'a pas été redémarré après la modification du fichier de lancement. Copiez de nouveau l'identifiant depuis l'adresse de la page de la collection.
  • Les joueurs voient des modèles ERROR et des textures violettes et noires : l'addon de contenu ne figure pas dans la liste de workshop.lua, ou le fichier est dans le mauvais dossier. Si la texture manquante provient du contenu de Counter-Strike : Source, vérifiez le réglage mount.cfg côté serveur à l'aide du guide d'installation ; ce contenu doit aussi être présent chez le joueur.
  • workshop.lua ne fonctionne pas : sous Windows, le fichier a peut-être été enregistré sous le nom workshop.lua.txt ; dans « File Explorer » (Explorateur de fichiers), affichez les extensions de noms de fichiers (option « File name extensions ») et vérifiez. Si la console affiche une erreur Lua, contrôlez les guillemets et les parenthèses.
  • Après une mise à jour, les joueurs ne peuvent plus rejoindre la map : alors que +host_workshop_autoupdate 0 était actif, la map a été mise à jour sur le Workshop et le serveur est resté sur l'ancienne version. Réactivez une fois la mise à jour et redémarrez le serveur.
  • Sous Linux, l'addon de type dossier ne se charge pas : le nom du dossier contient des majuscules ou les fichiers appartiennent à root. Passez les noms en minuscules et appliquez la commande chown.
  • La connexion au serveur prend très longtemps : des addons ne contenant que du Lua ont peut-être été ajoutés à la liste de workshop.lua, ou le contenu que les joueurs doivent télécharger est plus volumineux que nécessaire. Supprimez les lignes resource.AddWorkshop superflues et retirez de la collection les addons inutilisés.
  • srcds_workshop_ids.txt est ignoré : le serveur est antérieur à la version 2026.09.22, le fichier n'est pas dans le dossier cfg, ou il manque une accolade ou un guillemet dans sa structure.
  • Un addon fait planter le serveur : pour trouver l'addon en cause, divisez la collection en deux et testez avec une moitié, puis continuez en divisant de nouveau la moitié problématique. Faites les tests non pas sur le serveur en production, mais sur une copie installée dans un dossier distinct et lancée sur un autre port. Pour lire les erreurs Lua de la console, consultez le guide Corriger les erreurs Lua et le lag.

Questions fréquentes

Les addons Workshop se mettent-ils à jour automatiquement sur le serveur ?

Oui, la vérification des mises à jour se fait au démarrage. À chaque lancement, le serveur vérifie si les addons de la collection sont à jour ; pour obtenir une nouvelle version, redémarrez le serveur. Vous pouvez désactiver cette vérification avec +host_workshop_autoupdate 0.

Puis-je utiliser plusieurs collections ?

La commande de lancement accepte un seul identifiant de collection. Ajoutez vos différentes collections à une collection parente unique ; le serveur télécharge aussi les sous-collections. Vous pouvez en outre lister des identifiants d'addons un par un dans le fichier srcds_workshop_ids.txt.

Une clé Steam Web API (-authkey) est-elle nécessaire ?

La page Workshop for Dedicated Servers actuelle de Facepunch n'indique que le paramètre +host_workshop_collection pour la collection ; elle ne mentionne ni clé Steam Web API ni paramètre -authkey. Ce paramètre figure dans les commandes de lancement d'anciens guides. Si la collection n'est pas téléchargée, vérifiez d'abord la visibilité et l'identifiant. Si votre fichier de lancement contient une clé API ou un GSLT, protégez-les comme un mot de passe et ne partagez pas de capture d'écran du fichier.

Combien d'addons puis-je ajouter ?

Les pages de Facepunch n'indiquent aucune limite au nombre d'addons d'une collection ; pour les fichiers téléchargeables par les joueurs, la limite est en revanche de 8192. En pratique, la limite dépend des ressources du serveur et du temps de connexion des joueurs. Au fur et à mesure que vous ajoutez des addons, surveillez les graphiques CPU et RAM de l'Espace client ; si les ressources ne suffisent pas, vous pouvez consulter les options de la page Location de serveur Garry's Mod.

Guides associés

Commentaires0

Pas encore de commentaire

Soyez le premier à partager votre avis.

Rejoignez la discussion

Veuillez vous connecter ou vous inscrire pour laisser un commentaire.

Ne manquez aucun article

Recevez nos derniers tutoriels, guides et actualités produit dans votre boîte de réception.

Votre abonnement à notre newsletter est confirmé.