Tu installes proprement les addons Workshop de Garry's Mod via une collection Steam Workshop, une clé Steam Web API et, en option, resource.AddWorkshop() pour le téléchargement côté client. La configuration du serveur reste ainsi compréhensible, les addons peuvent être remplacés de manière centralisée, et en cas de problème, tu peux vérifier précisément si la collection, la clé API ou certains ID Workshop sont incorrects.
Conditions préalables
Tu as besoin d'un accès aux paramètres de démarrage de ton serveur Garry's Mod, d'une collection Steam Workshop et d'une clé Steam Web API. La source officielle pour les contenus Workshop de Garry's Mod est le Steam Workshop pour Garry's Mod. Tu génères la clé API via la page officielle de Steam steamcommunity.com/dev/apikey.
Planifie soigneusement le choix des addons. Une grande collection peut rallonger le démarrage du serveur, imposer des téléchargements plus longs aux clients et rendre les erreurs plus difficiles à trouver. Pour les serveurs en production, il est judicieux de tester les addons d'abord un par un ou en petits groupes avant de les intégrer durablement à la collection principale. Avec game-serverhosting, ce processus s'intègre bien à un modèle d'exploitation contrôlé : les modifications sont documentées, vérifiées, puis seulement ensuite mises à disposition des joueurs.
Créer une collection Workshop
- Va 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 se trouve dans l'URL de la collection Steam. Copie uniquement l'ID numérique, pas l'URL complète. Veille aussi à ce que la collection soit publique ou accessible au serveur. Si un addon est supprimé, rendu privé ou mis à jour par son auteur, cela peut avoir un impact sur le démarrage de ton serveur ou sur les téléchargements côté client. Vérifie donc toujours la console du serveur après des modifications importantes.
Charger la collection sur le serveur
Dans la ligne de démarrage du serveur :
+host_workshop_collection <collection_id>
-authkey <steam_web_api_key>
Remplace <collection_id> par l'ID de ta collection Workshop et <steam_web_api_key> par ta clé Steam Web API. Le paramètre +host_workshop_collection indique au serveur de charger la collection spécifiée. Le paramètre -authkey fournit l'accès aux services web Steam nécessaires aux téléchargements Workshop.
Après avoir saisi les paramètres de démarrage, redémarre le serveur. Lors du premier démarrage, surveille la console ou le journal. Si les contenus Workshop ne sont pas chargés, la cause vient souvent d'un ID de collection incorrect, d'une clé API manquante ou invalide, ou d'un addon qui n'est plus accessible.
Clé Steam Web API
Nécessaire pour les téléchargements Workshop :
- Va sur steamcommunity.com/dev/apikey
- Génère une clé
- Renseigne-la comme
-authkeydans la ligne de démarrage
Traite la clé API comme un jeton d'accès. Ne la partage pas publiquement et ne l'écris pas dans des forums, des captures d'écran ou des dépôts librement accessibles. Si tu penses que la clé a été exposée, tu devrais en générer une nouvelle chez Steam et ne plus utiliser l'ancienne.
Les joueurs téléchargent automatiquement les addons
Pour que les joueurs téléchargent automatiquement les addons, ajoute ceci dans lua/autorun/server/workshop.lua :
resource.AddWorkshop("workshop_id_1")
resource.AddWorkshop("workshop_id_2")
resource.AddWorkshop("workshop_id_3")
resource.AddWorkshop() utilise des ID Workshop individuels. Indique ici les addons que les clients doivent récupérer automatiquement lors de la connexion. C'est particulièrement important pour les maps, modèles, matériaux, sons ou autres contenus dont les joueurs ont besoin localement. Les addons uniquement côté serveur ne doivent pas forcément être distribués aux clients.
Garde ce fichier clairement structuré. Tu peux regrouper les addons par usage, par exemple maps, armes, playermodels ou HUDs. Si un addon provoque des problèmes, commente temporairement l'entrée correspondante et redémarre le serveur. Tu trouveras ainsi les conflits plus rapidement sans devoir démonter toute la collection.
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 |
| HUDs | 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 exigences différentes. 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 HUDs ou plusieurs outils d'administration peuvent se gêner mutuellement.
Si tu exploites aussi d'autres jeux avec des workflows de mods, les principes du guide Workshop Project Zomboid et du guide d'installation des mods ARK t'aideront : clarifier d'abord les dépendances, saisir proprement les ID, puis vérifier 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 la clé API. 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 adapté. Troisièmement : un client de test doit charger automatiquement les contenus nécessaires lors de la connexion ou ne montrer aucun problème de textures manquantes.
Teste si possible avec un client qui n'a pas déjà abonné localement les addons. Sinon, tu peux facilement ne pas voir que le téléchargement automatique ne fonctionne pas pour les nouveaux joueurs. Sur les serveurs publics, un court avertissement dans la description du serveur vaut aussi la peine si de très gros contenus doivent être chargés.
Dépannage
- L'addon ne se charge pas : vérifier la clé Steam Web API
- Textures manquantes : installer le CSS Content Pack
- Téléchargement lent : réduire la collection au strict nécessaire
Si toute la collection ne se charge pas, vérifie d'abord les fautes de frappe dans +host_workshop_collection et -authkey. Si un seul addon manque, ouvre sa page Workshop et vérifie s'il est encore disponible. En cas de textures manquantes, distingue les contenus Workshop du contenu externe nécessaire. Les serveurs Garry's Mod utilisent souvent des contenus qui ne sont pas automatiquement remplacés par un seul addon.
En cas de longs temps de chargement, supprime les maps inutilisées, les modèles en double, les anciens packs d'armes et les grandes collections de sons ou de matériaux. Une collection plus petite est plus facile à maintenir et réduit le risque que les joueurs abandonnent lors de leur première connexion.
Vérification, limites et retour sécurisé
Le guide « Installer des addons Workshop pour Garry's Mod » s'applique au type de serveur décrit dans l'article et à l'état des versions 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 changer après des mises à jour. Ne transpose donc aucune valeur sans vérification vers une autre version de jeu, de loader ou de serveur.
Avant toute modification de monde, sauvegarde, configuration ou extension, crée une sauvegarde des fichiers concernés. Modifie ensuite une seule étape cohérente et vérifie-la avec la même version client et serveur que celle avec laquelle tu veux jouer plus tard.
| Point de contrôle | Résultat attendu | Arrêt et retour en arrière |
|---|---|---|
| Démarrage du serveur | Le serveur atteint l'état opérationnel sans nouveau message d'erreur. | En cas d'erreurs au démarrage, annuler la modification et restaurer 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'erreurs de version ou de connexion, revérifier la version, le port et les autorisations. |
| Test de fonctionnement | La fonction précisément modifiée fonctionne sans endommager les données de monde ou de jeu existantes. | En cas d'effets secondaires, arrêter le serveur et restaurer les fichiers sauvegardés. |
Un test individuel réussi ne garantit ni les performances ni la disponibilité. La taille du monde, les mods, les plugins, le nombre de joueurs, le trajet 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 comprendre les écarts ultérieurs.
FAQ
Ai-je toujours besoin d'une collection Workshop ?
Pour un serveur avec plusieurs addons, une collection est la méthode la plus propre, car tu gères la sélection de manière centralisée dans Steam. Les ID Workshop individuels dans resource.AddWorkshop() restent tout de même importants pour que les clients téléchargent automatiquement les contenus nécessaires.
Quelle est la différence entre l'ID de collection et l'ID Workshop ?
L'ID de collection renvoie à un ensemble de plusieurs addons. Un ID Workshop renvoie à un seul addon. Dans la ligne de démarrage, tu utilises l'ID de collection ; dans resource.AddWorkshop(), tu saisis des ID Workshop individuels.
Pourquoi les joueurs voient-ils des textures manquantes ?
Les textures manquantes apparaissent généralement lorsque les contenus client n'ont pas été chargés ou qu'un contenu supplémentaire est nécessaire. Vérifie resource.AddWorkshop(), les ID d'addons et si l'addon concerné renvoie à d'autres contenus.
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 la seule façon de vérifier de manière fiable que le serveur charge correctement la collection et enregistre les ressources client.
Quelle taille devrait avoir une collection ?
Aussi petite que possible et aussi grande que nécessaire. Supprime 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 contrôlables.