Installer une map personnalisée (custom map) sur un serveur GMod
Dans ce guide, vous apprendrez à installer une map personnalisée (custom map) sur votre serveur Garry's Mod (GMod) : démarrer sur une map issue d'une collection du Steam Workshop (Atelier), envoyer manuellement sur le serveur un fichier .bsp téléchargé sur Internet, faire parvenir aux joueurs les textures et les modèles de la map, et générer un fichier .nav pour les NPC et les bots. Les commandes sont données séparément pour Windows et pour Linux. Ce guide s'adresse aux administrateurs qui ont installé leur serveur et veulent le démarrer sur une autre map que la map par défaut gm_construct.
Le bon fonctionnement d'une map sur le serveur dépend de trois choses : le serveur doit trouver la map sous le bon nom, les joueurs doivent disposer du fichier de la map et du contenu qu'elle utilise, et la map doit convenir au mode de jeu choisi. Les étapes ci-dessous suivent cet ordre. Les autres sujets GMod sont regroupés sur la page Guides Garry's Mod.
Avant de commencer
Ce guide suppose que le serveur est installé et qu'il démarre. Si SteamCMD, le GSLT (jeton de connexion du serveur de jeu) et le fichier 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 reprennent les dossiers de ce guide : C:\GModServer sous Windows, /home/steam/gmod sous Linux ; les fichiers de lancement sont start.bat et start.sh.
- Accès au serveur : vous vous connectez au VDS Windows en RDP (Bureau à distance) et au VDS Linux en SSH. Pour envoyer des fichiers sous Linux, vous pouvez utiliser un client SFTP (par exemple WinSCP, FileZilla) ou la commande
scp. Si la connexion échoue, la console VNC de l'Espace client affiche l'écran du serveur dans votre navigateur. - Origine de la map : si la map est sur le Workshop, suivez l'étape 2 ; si vous n'avez qu'un fichier ou une archive, suivez l'étape 3. Téléchargez les maps depuis des sources de confiance et respectez les conditions d'utilisation sur serveur fixées par leur créateur.
- Marge de ressources : les grandes maps et les packs de contenu remplissent le disque, et l'utilisation de la RAM augmente pendant le chargement d'une map. Surveillez le disque et la RAM dans les graphiques d'utilisation en direct de l'Espace client ; si les ressources ne suffisent pas, consultez les options de la page Location de serveur Garry's Mod.
- Sauvegarde : la sauvegarde automatique n'est pas incluse dans les VDS. Avant toute modification, copiez votre fichier de lancement et le dossier
garrysmod/cfgen dehors du serveur.
1. Faire correspondre le nom de la map et le mode de jeu
Le serveur reconnaît une map à son nom de fichier. Le nom de map du fichier rp_examplemap_v2.bsp est rp_examplemap_v2 ; dans la commande de lancement et dans la console, on n'écrit pas l'extension .bsp. Le titre de la page Workshop et l'identifiant (ID) de l'addon ne sont pas le nom de la map : pour lancer la map, vous utilisez toujours le nom du fichier .bsp.
Le préfixe (prefix) placé au début du nom indique pour quel mode de jeu la map a été conçue. Les modes de jeu définissent ce préfixe dans la clé maps de leur propre fichier .txt. Sur la page Gamemode Creation de Facepunch, cette clé est présentée comme un filtre de maps ; le code du menu du jeu (getmaps.lua) n'utilise ce filtre que pour regrouper les maps dans le sélecteur de map :
- Sandbox (
+gamemode sandbox) : filtre^gm_|^gmod_|^phys_, c'est-à-dire les maps qui commencent pargm_,gmod_etphys_. - TTT (
+gamemode terrortown) : filtre^ttt_; les maps conçues pour TTT portent ce préfixe. - DarkRP (
+gamemode darkrp) : le fichierdarkrp.txtde DarkRP ne contient pas de clémaps; le préfixerp_n'est qu'une convention de nommage répandue.
Le préfixe n'est pas un verrou : le serveur lance la map qu'il trouve, quel que soit son préfixe. Mais sur une map qui n'a pas été conçue pour un mode, le déroulement de la partie dans ce mode peut ne pas fonctionner comme prévu. Vérifiez dans la description de la map pour quel mode elle a été faite et si elle demande le contenu d'un autre jeu, comme Counter-Strike : Source (CSS). Si le contenu de CSS est nécessaire, le réglage mount.cfg côté serveur est expliqué dans le guide d'installation. Pour l'installation des modes eux-mêmes, consultez les guides serveur GMod TTT et serveur GMod DarkRP.
2. Démarrer sur une map du Workshop
Utiliser une map du Workshop est la méthode la moins contraignante : le serveur télécharge la map avec la collection et la monte (mount), et les joueurs téléchargent la map via Steam. Ajoutez la map à la collection Workshop du serveur ; la collection doit être publique ou non répertoriée (unlisted). Les étapes pour créer la collection et trouver son identifiant figurent dans le guide Ajouter des addons Workshop à un serveur GMod.
Dans la commande de lancement, indiquez la collection, le mode de jeu et le nom .bsp de la map. Comme dans l'exemple de la page Workshop for Dedicated Servers de Facepunch, écrivez d'abord la collection, puis le mode de jeu, et la map en dernier.
Windows (C:\GModServer\start.bat) :
@echo off
srcds.exe -console -game garrysmod -port 27015 -tickrate 66 +maxplayers 24 +sv_setsteamaccount YOUR_GSLT_TOKEN +host_workshop_collection 123456789 +gamemode terrortown +map ttt_examplemap
Linux (/home/steam/gmod/start.sh) :
#!/bin/bash
cd /home/steam/gmod
./srcds_run -game garrysmod -port 27015 -tickrate 66 +maxplayers 24 +sv_setsteamaccount YOUR_GSLT_TOKEN +host_workshop_collection 123456789 +gamemode terrortown +map ttt_examplemap
Redémarrez le serveur ; la collection est téléchargée au démarrage. Si le nom de la map en cours correspond à un .bsp de la collection, la ligne Making workshop map available for client download apparaît dans la console. D'après la page resource.AddWorkshop de Facepunch, la map en cours issue de la collection est ajoutée automatiquement à la liste de téléchargement ; vous n'avez pas besoin d'écrire une ligne supplémentaire pour la map.
Si vous ne connaissez pas le nom .bsp de la map, exécutez dans la console du serveur la commande maps avec une partie du nom. D'après la documentation de Valve, la commande liste, parmi les maps accessibles au serveur, celles qui contiennent cette partie ; maps * les affiche toutes :
maps ttt_
Les noms des maps issues du Workshop sont en minuscules : d'après son code source, l'outil gmad de Facepunch convertit les noms de fichiers en minuscules lorsqu'il crée le paquet .gma. Même si le nom de la map est écrit en majuscules sur la page Workshop, indiquez comme valeur de +map le nom affiché par la commande maps.
Pour certaines maps, les modèles et les textures sont publiés séparément, sous forme d'un addon Workshop distinct (pack de contenu). Ajoutez aussi ce pack à la collection et, pour le faire télécharger par les joueurs, inscrivez son identifiant dans le fichier workshop.lua décrit dans le guide du Workshop :
resource.AddWorkshop("111111111") -- exemple : pack de contenu de la map
3. Envoyer manuellement le fichier .bsp
Une map absente du Workshop est généralement fournie dans une archive (.zip, .rar, .7z). Ouvrez l'archive sur votre propre ordinateur et examinez son contenu :
- S'il n'y a qu'un fichier
.bsp, copiez-le dans le dossiergarrysmod/mapsdu serveur. - S'il y a des dossiers comme
maps,materials,models,sound, copiez chacun d'eux dans le dossier du même nom à l'intérieur degarrysmod, sans modifier la structure des sous-dossiers. Par exemple, le dossiermaterials/examplemap/de l'archive devientgarrysmod/materials/examplemap/sur le serveur. - Si un fichier
.navest fourni avec la map, placez-le dans le même dossier que le.bsp(étape 6).
Windows : copiez le fichier sur votre propre ordinateur et collez-le dans le dossier C:\GModServer\garrysmod\maps de la session RDP. Vérifiez que le fichier ne se trouve pas dans un sous-dossier ou encore dans l'archive, mais directement dans le dossier maps.
Linux : envoyez le fichier depuis votre propre ordinateur avec un client SFTP ou, dans un terminal, avec scp. Si vous l'envoyez avec l'utilisateur steam qui exécute le serveur, vous n'avez pas à vous occuper de la propriété du fichier :
scp rp_examplemap_v2.bsp steam@SERVER_IP:/home/steam/gmod/garrysmod/maps/
Si vous avez envoyé le fichier avec le compte root, attribuez-en la propriété à l'utilisateur steam sur le serveur ; l'utilisateur qui exécute le serveur pourra ainsi modifier le fichier par la suite. Vérifiez ensuite le nom du fichier :
chown steam:steam /home/steam/gmod/garrysmod/maps/rp_examplemap_v2.bsp
ls /home/steam/gmod/garrysmod/maps | grep -i examplemap
Sous Linux, les noms de fichiers et de dossiers sont sensibles à la casse : rp_ExampleMap_v2.bsp et rp_examplemap_v2.bsp sont deux fichiers différents. Écrivez les valeurs de +map et de changelevel exactement comme le nom affiché par ls, lettre pour lettre. Si l'archive contient des noms de dossiers en majuscules (par exemple Materials), passez-les en minuscules ; la page Linux de Facepunch indique que les noms de dossiers en majuscules posent problème dans les addons. En revanche, ne renommez pas le fichier de la map : d'après la page Cubemaps de Valve, changer le nom du fichier .bsp casse les reflets des cubemaps sur les modèles.
4. Faire parvenir le contenu de la map aux joueurs
Même si la map se lance sur le serveur, un joueur qui n'a pas le fichier de la map ou le contenu qu'elle utilise voit la map endommagée ou ne peut pas rejoindre le serveur. D'après la page Missing content (contenu manquant) de Valve, les textures et matériaux manquants apparaissent sous forme de damier noir et magenta, et les modèles manquants sous forme d'inscription ERROR rouge clignotante. Le contenu parvient au joueur par trois voies :
- Contenu intégré à la map : le créateur de la map a pu empaqueter le contenu dans le fichier
.bspavec un outil comme BSPZIP. D'après Valve, ces fichiers sont montés au chargement de la map comme s'ils se trouvaient dans les dossiers du jeu ; dès que le fichier de la map parvient au joueur, le contenu lui parvient aussi. - Workshop : si la map et son pack de contenu sont sur le Workshop, l'étape 2 suffit. La page Serving Content de Facepunch présente le téléchargement via le Workshop comme la voie la plus rapide.
- FastDL (téléchargement rapide) : la map envoyée manuellement et le contenu non intégré sont téléchargés par les joueurs depuis un serveur web, dont l'adresse est indiquée par le réglage
sv_downloadurldu serveur de jeu. Les étapes d'installation figurent dans le guide FastDL pour GMod.
Les textures et modèles non intégrés s'ajoutent à la liste de téléchargement avec resource.AddFile. Pour cela, créez dans le dossier garrysmod/lua/autorun/server un fichier nommé par exemple map_content.lua :
-- Contenus de la map à télécharger par les joueurs
resource.AddFile("materials/examplemap/wall01.vmt")
resource.AddFile("models/examplemap/sign.mdl")
D'après Facepunch, un fichier .vmt ajoute automatiquement à la liste la texture .vtf du même nom, et un fichier .mdl les fichiers annexes du modèle comme .vvd, .phy et .vtx. Le fichier doit être présent sur le serveur, sinon il n'est pas ajouté à la liste ; toutes les fonctions resource.Add* partagent une limite commune de 8192 fichiers. N'utilisez pas le téléchargement direct depuis le serveur (sv_allowdownload) : Facepunch considère cette méthode comme obsolète, très lente (64 kb/s) et exploitable.
D'après la documentation FastDL de Valve, si un fichier du même nom existe déjà sur l'ordinateur du joueur, il n'est pas écrasé et le téléchargement est ignoré ; une map mise à jour sous le même nom reste donc dans son ancienne version chez le joueur. C'est pourquoi vous ne devez publier la nouvelle version d'une map que sous un nom de fichier différent (par exemple rp_examplemap_v3). Ce nom doit être donné par le créateur de la map ; si vous renommez vous-même le fichier, le problème de cubemaps de l'étape 3 peut apparaître.
5. Définir la map de démarrage et changer de map
Pour démarrer sur la map envoyée manuellement, modifiez la valeur de +map dans votre fichier de lancement et vérifiez que la valeur de +gamemode convient à la map.
Windows (start.bat) :
@echo off
srcds.exe -console -game garrysmod -port 27015 -tickrate 66 +maxplayers 32 +sv_setsteamaccount YOUR_GSLT_TOKEN +gamemode darkrp +map rp_examplemap_v2
Linux (start.sh) :
#!/bin/bash
cd /home/steam/gmod
./srcds_run -game garrysmod -port 27015 -tickrate 66 +maxplayers 32 +sv_setsteamaccount YOUR_GSLT_TOKEN +gamemode darkrp +map rp_examplemap_v2
Pour changer de map pendant que le serveur tourne, utilisez la console du serveur : sous Windows, tapez ceci dans la fenêtre de console du serveur ; sous Linux, dans la session que vous rejoignez avec screen -r gmod :
changelevel rp_examplemap_v2
D'après la documentation de Valve, changelevel charge la nouvelle map sans expulser les joueurs du serveur, alors que la commande map peut expulser tout le monde dans les jeux multijoueurs. Sur un serveur ouvert, utilisez changelevel. Ces commandes ne changent pas le mode de jeu d'elles-mêmes ; pour passer durablement à un autre mode, modifiez la valeur de +gamemode dans le fichier de lancement et redémarrez le serveur.
6. Créer un fichier .nav pour les NPC et les bots
Sur certaines maps, les NPC ou les bots ne bougent pas ; l'une des causes possibles est l'absence des données de recherche de chemin de la map. GMod utilise pour cela deux systèmes distincts :
- Maillage de navigation (navigation mesh, navmesh) : d'après Valve et Facepunch, dans GMod, les NPC basés sur NextBot calculent le chemin vers leur objectif à partir de ce maillage ; les addons de bots qui utilisent le navmesh ont besoin des mêmes données. Celles-ci se trouvent dans le fichier
.navqui porte le même nom que la map :garrysmod/maps/rp_examplemap_v2.nav. - Réseau de nœuds (nodegraph) : les NPC de Half-Life 2 utilisent les nœuds que le créateur de la map a placés manuellement dans la map. Ce réseau est compilé automatiquement en fichier
.ainau chargement de la map et écrit dans le dossiergarrysmod/maps/graphs; pendant la compilation, le messageNode Graph out of Date. Rebuilding...apparaît. Les nœuds faisant partie de la map, ils ne peuvent pas être générés par une commande serveur ;nav_generaten'aide pas ces NPC.
Les maps du Workshop peuvent contenir le fichier .nav ; la liste blanche des addons de Facepunch autorise les fichiers maps/*.nav. Si la map n'est pas fournie avec un fichier .nav, vous pouvez le générer vous-même. D'après la page Nav Mesh Editing de Valve, la commande nav_generate fonctionne lorsqu'une map est chargée et nécessite sv_cheats 1. La génération part d'un point d'apparition des joueurs (spawn) et analyse de proche en proche la zone praticable à partir de ce point ; selon la taille de la map, elle peut durer de quelques minutes à plusieurs heures. Facepunch indique aussi que l'opération consomme beaucoup de ressources et ne doit pas être lancée en cours de partie. Exécutez donc la commande lorsqu'aucun joueur n'est sur le serveur :
sv_cheats 1
nav_generate
À la fin, la commande analyse le maillage (nav_analyze), enregistre le fichier .nav dans le dossier maps et recharge la map. Désactivez ensuite de nouveau les triches :
sv_cheats 0
Si vous le souhaitez, générez le fichier sur votre propre ordinateur : ouvrez la map en solo dans Garry's Mod, tapez les mêmes commandes dans la console du jeu et envoyez le fichier garrysmod/maps/<map>.nav obtenu dans le dossier maps du serveur. Si le maillage n'a pas atteint certaines parties de la map, regardez en jeu un point praticable de cette zone et tapez nav_mark_walkable ; ce repère devient un point de départ supplémentaire pour la génération. Relancez ensuite la commande nav_generate. Le wiki de Facepunch liste les fonctions navmesh côté serveur (server) ; il suffit donc que le fichier .nav soit présent sur le serveur.
Exemple de configuration
Le tableau ci-dessous regroupe les fichiers, paramètres et commandes utilisés dans ce guide. Les chemins sont relatifs au dossier garrysmod.
| Fichier / commande | Emplacement | Rôle | Exemple |
|---|---|---|---|
| Fichier de la map | maps/ | La map lancée par le serveur | rp_examplemap_v2.bsp |
| Maillage de navigation | maps/ | Recherche de chemin des NextBot | rp_examplemap_v2.nav |
| Réseau de nœuds | maps/graphs/ | NPC de Half-Life 2 ; compilé automatiquement au démarrage | rp_examplemap_v2.ain |
+host_workshop_collection | Commande de lancement | Télécharge et monte au démarrage les maps de la collection | +host_workshop_collection 123456789 |
+gamemode | Commande de lancement | Nom du dossier du mode de jeu | +gamemode terrortown |
+map | Commande de lancement | Map de démarrage, sans l'extension .bsp | +map ttt_examplemap |
changelevel | Console du serveur | Change de map sans expulser les joueurs | changelevel gm_flatgrass |
maps | Console du serveur | Liste les maps accessibles au serveur | maps rp_ |
nav_generate | Console du serveur ou du jeu (sv_cheats 1) | Génère le fichier .nav | nav_generate |
resource.AddFile | lua/autorun/server/ | Ajoute le contenu non intégré à la liste de téléchargement | resource.AddFile("materials/examplemap/wall01.vmt") |
Erreurs fréquentes
- Erreur de map introuvable (map not found), le serveur ne démarre pas ou
changelevelne fonctionne pas : le nom est mal écrit : l'extension.bspa été ajoutée, sous Linux la casse ne correspond pas au nom du fichier, ou un identifiant Workshop a été indiqué à la place du nom de la map. Le fichier est peut-être resté dans un sous-dossier issu de l'archive au lieu degarrysmod/maps. Pour une map du Workshop, la collection n'est ni publique ni non répertoriée, ou la map ne figure pas dans la collection. Trouvez avec la commandemapsle nom que voit le serveur et recopiez-le tel quel. - Textures violettes et noires et modèles ERROR : le contenu de la map n'est pas intégré à la map et n'est pas téléchargé par les joueurs, ou la map demande le contenu de CSS. Distribuez le pack de contenu Workshop avec
resource.AddWorkshop, et le contenu envoyé manuellement avec FastDL etresource.AddFile; pour CSS, appliquez l'étapemount.cfgdu guide d'installation (le contenu de CSS doit aussi être présent chez le joueur). - Reflets ou brillances noirs, ou violets et noirs, sur les surfaces : d'après Valve, cela vient généralement du fait que les cubemaps de la map n'ont pas été générées. Les cubemaps doivent être générées avant la diffusion de la map ; c'est au créateur de la map de corriger le problème. Si vous avez renommé le fichier
.bsp, redonnez-lui son nom d'origine. - Les joueurs ne peuvent pas télécharger la map ou sont déconnectés pendant la connexion : FastDL n'a pas été mis en place pour la map envoyée manuellement, et le serveur n'envoie pas de fichiers puisque
sv_allowdownload 0est actif. D'après Valve, si le fichier est absent du serveur web ou si la casse de son nom ne correspond pas, le joueur abandonne le serveur web et tente de télécharger les fichiers restants depuis le serveur de jeu. Gardez des noms de fichiers strictement identiques à ceux du serveur de jeu. - La map que vous avez mise à jour s'ouvre dans son ancienne version chez les joueurs : le fichier a été remplacé sous le même nom, et le fichier du même nom présent chez le joueur n'est pas écrasé. Envoyez la nouvelle version sous le nom différent donné par le créateur de la map. Pour les maps du Workshop, si vous avez désactivé la mise à jour au démarrage (
+host_workshop_autoupdate 0), consultez l'avertissement du guide du Workshop. - Les NPC ou les bots ne bougent pas : il manque le fichier
.navpour les NextBot et les bots qui utilisent le navmesh ; générez-le comme à l'étape 6. Si ce sont les NPC de Half-Life 2 qui ne bougent pas, la map ne contient très probablement pas de nœuds ; seul le créateur de la map peut corriger cela. - Le mode de jeu ne fonctionne pas correctement sur la map : la valeur de
+gamemodeest mal écrite ou la map n'a pas été conçue pour ce mode. Pour TTT, essayez une map avec le préfixettt_.
Questions fréquentes
Dois-je écrire le nom de la map avec l'extension .bsp ?
Non. D'après la documentation de Valve, on n'écrit pas l'extension .bsp dans les commandes map et changelevel ; pour rp_examplemap_v2.bsp, on écrit +map rp_examplemap_v2.
Dois-je aussi copier la map du Workshop dans le dossier maps ?
Non. Le serveur télécharge et monte au démarrage la map de la collection ; il suffit d'indiquer le nom .bsp avec +map. L'envoi manuel est réservé aux maps absentes du Workshop.
Dois-je faire télécharger le fichier .nav par les joueurs ?
Non. La recherche de chemin se fait côté serveur ; il suffit que le fichier .nav se trouve dans le dossier maps du serveur. L'ajouter à la liste resource.AddFile ne ferait que consommer une partie de la limite de 8192 fichiers.
Changer de map expulse-t-il les joueurs du serveur ?
Pas si vous utilisez changelevel : les joueurs passent sur la nouvelle map. La commande map, elle, peut expulser les joueurs du serveur. Préparez avant le changement la façon dont la nouvelle map parviendra aux joueurs (Workshop ou FastDL).
Guides associés
- Comment installer un serveur Garry's Mod ? Guide SteamCMD et srcds
- Comment ajouter des addons Workshop (Atelier) à un serveur GMod ?
- Qu'est-ce que FastDL (téléchargement rapide) sur GMod et comment l'installer ?
- Comment ouvrir un serveur GMod TTT (Trouble in Terrorist Town) ?
- Comment installer et configurer un serveur GMod DarkRP ?
Commentaires0
Pas encore de commentaire
Soyez le premier à partager votre avis.
Veuillez vous connecter ou vous inscrire pour laisser un commentaire.