Configurer le workshop de son serveur Garry’s Mod

Bienvenue chez la Mesnie, la maison, la fratrie des Gamers, qui porte vos projets de jeu en communauté !

Les tutos sur le workshop des serveurs gmod sont rares et incomplets, j’ai donc décidé d’en faire un.

Voir aussi : Créer un serveur Garry’s Mod dédié sous Linux 

N’hésitez pas à poser vos questions en commentaires, et à faire un don si vous le pouvez (en haut à droite du site).

 

Introduction

Grâce au Workshop, si vous respectez correctement ce tuto, vous maintenez les addons de votre serveur Gmod (Garry’s Mod) à jour automatiquement à chaque reboot du serv, et sans problèmes de version, vous n’avez pas besoin de FTP pour configurer un FastDL et de le refaire à chaque changement dans un plugin, vous soulagez votre serveur FTP… Bref, que d’avantages sur les serveurs Gmod ! Le tout peut sembler complexe au premier abord, mais une fois qu’on a compris quelques petits mécanismes on s’y habitue vite et ça se gère beaucoup plus simplement.

 

Limites et solutions

Trois Deux limites cependant :

– RESOLU !! Les addons de plus de 64 Mo sont bloqués, Garry étant au courant et ne faisant rien;

-Vous êtes forcés de faire les mises à jour des addons s’il  y en a, à chaque reboot du serv; (inévitable mais automatique)

-Vous ne pourrez pas modifier le code des plugins avec cette méthode directement.

 

-Si vous désirez quand même utiliser des addons de plus de 64 Mo : vous devrez les télécharger côté client (dans votre jeu), récupérer le fichier .gma, le renommer, et le placer dans le dossier « addons » du serveur, vous abonner quand même à l’objet, et suivre toutes les étapes du tuto, y compris la 4) pour que les joueurs téléchargent l’addon à la connexion au serv si vous le souhaitez, et vous devrez refaire cette procédure à chaque mise à jour de l’addon.

-Si vous voulez modifier un addon uniquement trouvable sur le workshop, vous devez utiliser un .gma extractor puis utiliser votre addon comme un addon classique, en mettant son dossier dans le dossier addons.

 

Allez c’est parti, bonne chance !

 

Pré requis :

Avoir accès aux options de lancement de son serveur. C’est gagné si vous hébergez vous-même votre serveur sur une machine dédiée ou chez vous par exemple, mais c’est bloqué chez certains mauvais hébergeurs (notamment parce que vous pourriez faire un serveur 64 slots alors que vous payez pour 16 par exemple), mais parfois, vous avez quand même possibilité de gérer le workshop.

 

Étapes obligatoires :

  1. Obtenir sa Steam API Key
  2. Créer une collection dans le workshop, ajouter ses addons et la publier
  3. Activer l’API et l’ID Workshop au lancement du serveur
  4. Créer un fichier LUA qui recense tous les addons à télécharger côté client
  5. Redémarrer son serv et profiter !

 

1) Obtenir sa Steam API Key

Rendez-vous ici et suivez les instructions https://steamcommunity.com/dev/apikey
Notez cette clé quelque part, elle va vous servir de -authkey dans les options de lancement du serveur.

 

 2) Créer une collection dans le workshop, ajouter ses addons et la publier

Alors là, je sais pas vous mais personnellement je trouve que le workshop est très très mal organisé, et on galère à trouver ce qu’on cherche…
Je vous ai fait de beaux screenshots pour vous éviter de ramer trop.
Déjà on se rend sur le workshop de Gmod, on se log à son compte Steam.

a) Créer sa collection

Ensuite on clique sur « collections » puis « créer une collection »

gmod collections

On choisit un titre, une image de couverture qui doit être impérativement carrée, et faire PLUS de 195×195 pixels.
Entrez une description, choissisez type de collection (par défaut (objets liés entre eux) dans 99% des cas).
Vous pouvez rajouter des tags pour indiquer ce que contiendra votre collection.

Vous validez, et vous retrouvez sur une page qui ne sert absolument à rien dans l’immédiat (la logique de ce workshop…).

collection inutile

b) Ajouter des addons à la collection

Vous retournez dans le workshop et allez sur la page d’un addon qui vous intéresse, au hasard Le Wiremod
Et vous l’ajoutez grâce au petit bouton « ajouter à la collection ».

Ajouter collection

 

Vous en ajoutez autant que vous voulez, et pouvez par la suite en rajouter encore et encore.

c) Publier sa collection

Tenez-vous bien, c’est totalement contre instinctif pour retrouver sa collection…
Pour ce-faire, vous retournez sur la page de base du workshop Gmod, onglet collections. Cette fois vous allez à droite dans « Vos fichiers du workshop » sous la barre de recherche. Puis onglet Collections.

Vous cliquez sur votre collection, et en haut, vous faites « Publier » sinon votre collection du workshop sera inactive.

Publier

 

Bravo, la collection est opérationnelle !

d) Noter l’ID de sa collection

Vous vous retrouvez avec une page de collection dont l’adresse ressemble à :

http://steamcommunity.com/sharedfiles/filedetails/?id=251973500

 

Notez bien l’ID !!!  Ce nombre à la fin de l’URL de votre collection, ici « 251973500 » dans mon cas, notez-le par exemple dans votre note où vous avez conservé votre API, car il va aussi vous servir !

 

 

3) Activer l’API et l’ID Workshop au lancement du serveur

Si vous n’avez pas noté votre API alors que je vous ai dit de le faire, vous êtes un peu sot mais vous pouvez la retrouver ici.

A ce niveau là, comme indiqué en pré-requis, vous devez être capable de définir les options de lancement de votre serveur.

Pour ma part, le mien est sous Linux, et j’utilise l’excellent script de management de DanielGibbs dans lequel il n’y a plus qu’à rentrer les ID. Dans votre cas, à moins d’avoir un script de lancement un peu développé, vous devrez peut-être le faire à la main.
Dans votre raccourci ou script de lancement, là où vous trouvez les options telles que -game garrysmod ou +map gm_flatgrass, vous allez rajouter en remplaçant VotreCollectionID et VotreSteamAPI par vos valeurs notées précédemment : +host_workshop_collection VotreCollectionID -authkey VotreSteamAPIKey
Sans guillemets, comme le veut la syntaxe habituelle.

A ce stade, si vous redémarrez votre serveur, dans la console, vous devez le voir récupérer les fichiers sur le workshop et les extraire automatiquement.

 

 

4) Créer un fichier LUA qui recense tous les addons à charger côté client

Dernière étape, à refaire ou mettre à jour dès que vous ajoutez ou retirez des addons ! Pensez-y !
Elle consiste à faire en sorte que vos utilisateurs téléchargent automatiquement les fichiers sur le workshop en se connectant au serveur. Sinon, pour eux, ça fera comme si les addons n’étaient pas installés. A noter que les addons purement LUA n’ont pas besoin de cette manip, le LUA est envoyé automatiquement aux clients à la connexion, contrairement aux addons qui contiennent des textures et des sons par exemple.

Pour ce faire, vous allez créer un fichier .lua (par exemple un .txt que vous renommerez en .lua) dans le dossier :
votre serveur/garrysmod/lua/autorun/server
Vous lui donnez le nom de votre choix (sans majuscules, surtout sous Linux), par exemple je l’ai appelé workshop_launcher.lua

Pour le remplir, il existe 2 méthodes, une manuelle, une automatique. La manuelle vaut le coup si vous n’avez que peu d’addons.

Méthode manuelle :
Le contenu de ce fichier ressemblera à ça :
resource.AddWorkshop( "187437437" )
resource.AddWorkshop( "125490679" )
resource.AddWorkshop( "278881337" )
resource.AddWorkshop( "150404359" )
resource.AddWorkshop( "144982052" )

Où entre les guillemets, se trouve l’ID de chaque addon, que vous devez entrer un par un. Comment avoir l’ID ?
Sur la page d’un addon par exemple wiremod : http://steamcommunity.com/sharedfiles/filedetails/?id=160250458
L’ID correspond au nombre à la fin, ici 160250458

Méthode automatique
Récemment, j’ai découvert un superbe outil, un petit programme, capable de générer le fichier workshop, juste en indiquant votre CollectionID ! Pratique !

ATTENTION ! Plus disponible !

Utilisez ce site ! http://www.configcreator.com/create/gmod/resources.lua
Lien du topic : http://facepunch.com/showthread.php?t=1325685
Lien de téléchargement du programme direct : https://mega.co.nz/#!olsDGCzC!TiJ0tW0aOmqsiC3jx-PSlx68gKQ2RU3N7VYtkYayj9I

workshop ressource generator
workshop ressource generator

Vous rentrez l’ID, vous cliquez sur Generate, ensuite chez moi j’ai droit à quelques erreurs de script durant le chargement, vous validez 2 ou 3 fois, et ensuite il n’y a plus qu’à copier la liste et à la coller dans votre fichier .lua

Des heures d’économisées si vous avez beaucoup d’addons !

 

5) Profiter

Reste plus qu’à redémarrer le serv et à demander à quelqu’un qui n’a pas les addons de se connecter pour voir si ça marche.

Si tout est bon, il ne vous reste plus qu’à profiter ! Sinon, posez vos questions, je conçois qu’on n’y arrive pas du premier coup, même en s’appliquant.

Laissez un commentaire

43 commentaires sur “Configurer le workshop de son serveur Garry’s Mod”