Ce chapitre se consulte, il ne se lit pas d'une traite. Le glossaire rassemble les mots propres à Garry's Mod que tu as croisés dans ce tutoriel, chacun en une phrase. La FAQ répond aux questions qui reviennent le plus, et te renvoie chaque fois au chapitre qui va plus loin.
Les mots du panel lui-même (instance, Status, Connection Info, File Manager, sous-compte…) ne sont pas repris ici : ils sont dans le glossaire du tuto général AMP.
1. Glossaire #
Le moteur et ses fichiers #
| Mot | Ce qu'il veut dire |
|---|---|
| Moteur Source | le moteur de jeu de Valve sur lequel Garry's Mod est construit, avec sa console, ses commandes et ses cartes .bsp. |
| srcds | le programme de serveur dédié du moteur Source, celui qui tourne dans ton instance quand tu cliques sur Start. |
| Côté serveur / côté client | ce qui se calcule sur ton serveur ou chez chaque joueur ; les textures, par exemple, se calculent chez le joueur. |
| Lua | le langage de programmation dans lequel sont écrits les gamemodes et les addons de Garry's Mod. |
| ConVar | une variable de console du jeu, qui se pose dans Additional Console Variables avec un + devant, comme +sv_gravity "500". |
| Paramètre de lancement | une option donnée à srcds au démarrage, qui se pose dans Additional Command Line Parameters avec un - devant, comme -authkey. |
server.cfg |
le fichier de réglages de garrysmod/cfg/ qu'AMP écrit, une ligne par entrée de Additional Server Settings. |
mount.cfg |
le fichier de garrysmod/cfg/ qu'AMP écrit pour dire au jeu où trouver le contenu de Counter-Strike: Source ou de Team Fortress 2. |
Les addons et le Workshop #
| Mot | Ce qu'il veut dire |
|---|---|
| Addon | un ajout au jeu (arme, outil, véhicule, système d'administration…) qui vient du Workshop ou se dépose à la main. |
| Workshop | la bibliothèque d'addons de Garry's Mod sur Steam, à l'adresse https://steamcommunity.com/app/4000/workshop/. |
| Identifiant Workshop | le numéro unique d'un élément du Workshop, comme 557962280 pour ULX, lisible dans l'adresse de sa page. |
| Collection | une liste d'éléments du Workshop regroupés sous un seul identifiant, que ton serveur peut télécharger d'un coup. |
.gma |
le paquet dans lequel un addon du Workshop est livré, que Garry's Mod monte tel quel sans jamais le décompresser. |
garrysmod/cache/srcds/ |
le dossier où ton serveur range les .gma téléchargés depuis le Workshop, un fichier par addon. |
garrysmod/addons/ |
le dossier des addons déposés à la main, hors Workshop, à raison d'un dossier par addon. |
| Workshop Collection ID | le réglage AMP qui fait télécharger et monter ta collection par le serveur, via +host_workshop_collection. |
| Resource Lua Code | le réglage AMP qui fait télécharger les addons par les joueurs à leur connexion, une ligne resource.AddWorkshop("<id>") par addon. |
-authkey |
le paramètre de lancement qui donne ta clé Steam Web API au serveur, sans lequel le téléchargement d'une collection peut s'arrêter en route. |
| Steam Web API key | la clé personnelle obtenue sur https://steamcommunity.com/dev/apikey, utilisée par -authkey et par la page Updates d'AMP. |
| Doublon | deux exemplaires d'une même chose dans ta collection, souvent l'officiel et un ré-upload qui l'embarque, ce qui provoque des erreurs Lua. |
La carte et le gamemode #
| Mot | Ce qu'il veut dire |
|---|---|
| Gamemode | l'ensemble de règles qui transforme Garry's Mod en un jeu précis, installé dans garrysmod/gamemodes/ ou fourni par le Workshop. |
sandbox |
le gamemode livré avec le jeu, sans objectif imposé, idéal pour un premier démarrage de référence. |
.bsp |
le fichier d'une carte, dont le nom exact est celui qu'attend Custom Map, pas le titre affiché sur le Workshop. |
--Custom-- |
le choix des listes Initial Map et Initial Gamemode qui fait lire à AMP le champ Custom Map ou Custom Gamemode. |
Le contenu #
| Mot | Ce qu'il veut dire |
|---|---|
| Damier violet et noir | la texture qui remplace, chez le joueur, une texture que son jeu ne trouve pas. |
| Modèle ERROR | l'inscription rouge qui remplace, chez le joueur, un modèle 3D que son jeu ne trouve pas. |
| CSS Content Mode / TF2 Content Mode | les réglages AMP qui montent côté serveur le contenu de Counter-Strike: Source ou de Team Fortress 2, téléchargé seulement lors d'un Update. |
| Pack de contenu | un élément du Workshop séparé qui contient les textures et modèles d'une carte ou d'un addon, à installer en plus de celui-ci. |
| FastDL | un serveur web qui envoie les fichiers aux joueurs, déclaré dans Fast Download URL, à laisser vide tant que tu n'en as pas un vrai. |
L'ouverture au public #
| Mot | Ce qu'il veut dire |
|---|---|
| GSLT | le jeton secret créé sur https://steamcommunity.com/dev/managegameservers avec l'App ID 4000, qui rattache ton serveur à ton compte Steam. |
| Pure Server Mode | le réglage qui décide si les joueurs peuvent garder des fichiers modifiés de leur côté, à ne changer qu'après un test. |
L'administration #
| Mot | Ce qu'il veut dire |
|---|---|
users.txt |
le fichier garrysmod/settings/users.txt qui déclare les admins natifs du jeu, relu seulement au démarrage. |
user / admin / superadmin |
les trois seuls niveaux que Garry's Mod connaît sans mod d'administration. |
| SteamID | l'identifiant d'un joueur au format STEAM_0:X:YYYYYYY, à ne pas confondre avec le SteamID64, plus long. |
| ULX | le mod d'administration gratuit de référence (557962280), qui ajoute bannissement, mute, gel, téléportation et grades. |
| ULib | la bibliothèque (557962238) dont ULX a besoin pour fonctionner, et qui range ses grades dans garrysmod/data/ulib/users.txt. |
lua_run |
la commande de console qui exécute du Lua côté serveur, avec des guillemets simples dans le code et une comparaison sur le SteamID. |
writeid |
la commande de console qui enregistre les bannissements faits avec banid, sans laquelle ils disparaissent au redémarrage. |
Le dépannage #
| Mot | Ce qu'il veut dire |
|---|---|
| Erreur Lua | un message Lua Error: [ERROR] suivi d'une liste numérotée de fichiers, où la ligne utile est celle qui pointe dans ton contenu. |
| Journal du jeu | un fichier garrysmod/logs/L-AAAA-MM-JJ-NNN.log écrit à chaque démarrage, avec les connexions, la carte chargée et les erreurs. |
2. FAQ #
Les addons #
Ma collection n'est descendue qu'à moitié. Pourquoi ?
Sans clé, le serveur télécharge en anonyme et Steam peut couper en route, sans message. Ajoute
-authkey LA_CLE dans Additional Command Line Parameters. Tout est au
chapitre 04.
Faut-il remplir Workshop Collection ID ou Resource Lua Code ? Les deux, avec la même liste. Le premier sert au serveur, le second aux joueurs. Le chapitre 04 explique pourquoi l'un sans l'autre ne marche pas.
Je ne trouve pas les fichiers .lua de mon addon dans le File Manager. C'est normal ?
Oui. Un addon du Workshop reste un .gma fermé dans garrysmod/cache/srcds/, jamais décompressé.
Voir le chapitre 02.
Où je mets un addon qui ne vient pas du Workshop ?
Dans garrysmod/addons/, un dossier par addon, envoyé de préférence par SFTP
(chapitre 01). Le chapitre 02
explique l'arborescence.
J'ai des erreurs Lua depuis que j'ai ajouté un addon. Cherche un doublon : deux bases d'armes, deux protections de props, deux inventaires. Garde seulement l'officiel (chapitre 04).
Combien d'addons je peux mettre ? Il n'y a pas de nombre fixe : tout dépend de leur poids. Mesure la mémoire sur Status et regarde ce que ça coûte à tes joueurs, comme expliqué au chapitre 10.
La carte et le gamemode #
Mon serveur reste sur « Starting » depuis que j'ai mis ma carte.
Le nom dans Custom Map n'est sûrement pas celui du vrai fichier .bsp. Vérifie-le, comme au
chapitre 05.
J'ai corrigé mon gamemode, mais rien ne change. Le code d'un gamemode est chargé au lancement. Redémarre le serveur. Le chapitre 02 détaille ce qui n'est lu qu'au démarrage.
Le serveur démarre, mais la moitié de mon gamemode n'existe pas. Une erreur dans un fichier inclus a interrompu le chargement de tout ce qui suivait. Remonte à la première erreur Lua de la console, avec le chapitre 08.
Le contenu #
Je vois des damiers violets et noirs partout. Il manque une texture chez toi : contenu d'un autre jeu, ou pack de contenu oublié. Le damier n'est pas toujours lié à Counter-Strike: Source. Tout est au chapitre 06.
J'ai activé CSS Content Mode, et rien n'a été téléchargé.
Le réglage écrit mount.cfg, mais le contenu n'arrive qu'avec un Update. Lance-le depuis
Status (chapitre 06).
Faut-il acheter Counter-Strike: Source pour le serveur ? Non. Le contenu côté serveur est gratuit. En revanche, tes joueurs qui ne l'ont pas verront quand même des textures manquantes (chapitre 06).
L'administration #
Je me suis mis superadmin dans users.txt, et je n'ai aucun droit.
Deux causes possibles : le serveur n'a pas redémarré, ou le SteamID n'est pas au format
STEAM_0:X:YYYYYYY. Voir le chapitre 07.
Où je trouve le SteamID d'un joueur ?
Dans la console, au moment où il se connecte, ou dans les journaux de garrysmod/logs/. La commande
status les liste aussi (chapitre 07).
Les commandes de chat de mon gamemode ne marchent pas dans la console d'AMP.
C'est normal : elles attendent un joueur, et la console n'en est pas un. Passe par lua_run, comme
au chapitre 07.
J'ai banni quelqu'un, et il est revenu après le redémarrage.
Après banid, il faut taper writeid pour que le bannissement soit enregistré
(chapitre 07).
Le public et l'entretien #
Mon serveur n'apparaît pas dans la liste des serveurs.
Il lui faut un GSLT créé avec l'App ID 4000, et LAN Server désactivé. En attendant,
connect adresse:port marche toujours. Voir le chapitre 10.
Une sauvegarde a coupé mon serveur en pleine partie. Une sauvegarde AMP arrête le serveur, sauf avec « Backup While Running ». Planifie-les la nuit, avec le chapitre 09.
Mon serveur peut-il être supprimé ? Oui, s'il reste longtemps sans joueurs : avertissement d'abord, puis libération. Les délais sont dans les CGU sur teamkit.fr ; le chapitre 10 explique comment s'y préparer.
Où demander de l'aide ? Sur le Discord TeamKit. Donne le nom de ton serveur, ce que tu as changé juste avant, et les lignes de la console. Le chapitre 08 te dit quoi fournir.