Damier violet et modèles ERROR : le contenu

Tu rejoins ton serveur. La carte se charge, tu apparais… et les murs sont recouverts d'un damier violet et noir. Plus loin, une caisse a été remplacée par un gros panneau rouge marqué « ERROR ». Le serveur tourne, la console ne signale rien de grave, et pourtant le monde est à moitié vide.

Ce chapitre t'apprend à lire ce symptôme, à trouver ce qui manque, et surtout à savoir de quel côté ça manque : chez ton serveur, ou chez tes joueurs. La moitié des heures perdues sur ce problème viennent d'une correction faite du mauvais côté.

1. Ce que l'écran essaie de te dire #

Deux symptômes, une même cause.

Ce que tu vois	Ce qui manque
Un damier violet et noir sur un mur, un sol, un objet	une texture
Un panneau rouge « ERROR » à la place d'un objet	un modèle

Dans les deux cas, le jeu du joueur cherche un fichier dont la carte ou un addon a besoin, et ne le trouve pas. Il affiche alors un remplaçant voyant, exprès, pour que tu le remarques.

Ce n'est pas une erreur Lua. Tu ne trouveras souvent rien dans la console du serveur : de son point de vue, tout va bien. Les erreurs Lua, c'est le chapitre 8.

✅ À retenir Damier = texture absente. ERROR = modèle absent. Le serveur peut très bien ne rien en savoir.

2. La question qui règle tout : chez qui ça manque ? #

Le chapitre 2 pose la notion fondatrice : certaines choses vivent sur le serveur, d'autres sur le PC de chaque joueur. Les textures sont du second genre. Elles se calculent chez le client. Ton serveur n'a pas d'écran : il ne dessine rien, pour personne.

Conséquence directe, et elle surprend tout le monde la première fois : un serveur qui a tout monté correctement ne garantit rien sur ce que voit un joueur. Si ce joueur n'a pas le contenu dans son propre jeu, il verra le damier.

Avant de toucher à quoi que ce soit, pose donc une seule question : qui voit le problème ?

Constat	Piste la plus probable
Tous les joueurs, au même endroit	il manque quelque chose dans ce que ton serveur fournit (une entrée de la collection, un pack de contenu, un addon qui n'est pas descendu)
Certains joueurs seulement	il manque quelque chose dans leur Garry's Mod (souvent un jeu dont la carte réutilise les textures)
Une seule carte, et pas les autres	cette carte a un pack de contenu à part (section 5)

Pour trancher, demande à un deuxième joueur de venir regarder le même endroit. Deux minutes de test t'évitent une soirée de réglages inutiles.

✅ À retenir Le serveur ne dessine pas. Avant de corriger, vérifie si le damier est chez tout le monde ou chez quelques-uns.

3. Les trois origines du contenu manquant #

Presque tous les cas tombent dans l'une de ces trois cases.

Le contenu d'un autre jeu Source. Beaucoup de cartes et d'addons réutilisent des textures et des modèles de Counter-Strike: Source ou de Team Fortress 2. Garry's Mod ne les contient pas : il faut les « monter ». Section 4.
Un pack de contenu publié à part sur le Workshop. L'auteur a séparé sa carte et ses textures en deux entrées distinctes. Tu as pris l'une, pas l'autre. Section 5.
Un addon qui n'est pas arrivé du tout. Ta collection s'est téléchargée à moitié, ou l'addon est dans Resource Lua Code sans être dans la collection, ou l'inverse. Ce cas-là relève du Workshop et le chapitre 4 le traite en détail (clé -authkey, vérification de cache/srcds/).

Garde cet ordre en tête, mais ne saute pas aux conclusions : le damier n'est pas toujours CS:S. C'est la piste la plus connue, donc la première qu'on accuse, et elle est souvent innocente.

✅ À retenir Trois suspects : un jeu à monter, un pack de contenu oublié, un addon jamais descendu.

4. Monter CS:S et TF2 sur ton serveur #

Les deux réglages #

Dans Configuration → Garry's Mod, onglet Server, tu trouves :

CSS Content Mode : le contenu de Counter-Strike: Source ;
TF2 Content Mode : le contenu de Team Fortress 2.

Quand tu les actives, AMP écrit pour toi le fichier garrysmod/cfg/mount.cfg, qui dit à Garry's Mod où trouver ces contenus. Voici ce qu'on lit dans ce fichier sur une instance où les deux sont activés :

"mountcfg"
{
    "cstrike"   "../232330/cstrike"
    "tf"        "../232250/tf"
}

Les deux nombres sont des identifiants Steam de serveurs dédiés :

232330 = Counter-Strike: Source Dedicated Server ;
232250 = Team Fortress 2 Dedicated Server.

Ces deux serveurs sont gratuits. Monter leur contenu sur ton serveur ne demande aucun achat, ni de ta part, ni de celle de TeamKit.

Le piège : écrit au démarrage, téléchargé à l'Update #

Voici ce qui a été constaté sur une vraie instance : mount.cfg contenait les deux lignes ci-dessus… et les dossiers 232330 et 232250 n'existaient pas. Le montage pointait dans le vide.

La raison : AMP écrit mount.cfg à chaque démarrage, mais il ne va chercher le contenu que pendant un Update. L'aide du réglage le dit d'ailleurs en toutes lettres : « Update the server after changing this setting ». Cocher la case puis cliquer sur Start ne télécharge rien.

C'est exactement la différence entre Start et Update que le chapitre 1 t'a demandé de retenir.

La procédure complète #

Ouvre Configuration → Garry's Mod, onglet Server.
Active CSS Content Mode, et TF2 Content Mode seulement si ton contenu en a besoin.
Enregistre.
Va sur Status et clique sur Update. Laisse-le travailler jusqu'au bout : c'est lui qui télécharge les fichiers.
Démarre ou redémarre le serveur.
Ouvre le File Manager et vérifie que les dossiers 232330 (CS:S) et 232250 (TF2) existent bien. Le ../ du chemin de mount.cfg les place hors de garrysmod/ : remonte d'un cran pour les chercher.
Ouvre garrysmod/cfg/mount.cfg pour contrôler que les lignes correspondent à ce que tu as activé.

Ne corrige pas mount.cfg à la main. AMP le réécrit au démarrage : passe toujours par les deux réglages.

Un dernier conseil de bon sens : ne monte que ce qui sert. Chaque jeu monté, c'est un téléchargement de plus et de la place prise sur ton disque.

✅ À retenir Activer le réglage écrit le montage. Seul un Update télécharge le contenu. Vérifie que les dossiers 232330 et 232250 existent.

5. Les packs de contenu publiés à part #

Le cas vécu #

Sur une carte très utilisée, vérifiée pour ce tuto, la carte et son contenu sont deux entrées Workshop différentes. La description de la carte le précise : « subscribe to the map content ». Le serveur qui n'avait pris que la carte la chargeait sans broncher, et tout le monde se promenait dans un monde en damier.

Rien ne prévient. Pas d'erreur, pas d'avertissement : juste une carte qui semble en place et qui ne l'est qu'à moitié.

Comment repérer un pack manquant #

Ouvre la page Workshop de la carte (ou du gros addon) qui pose problème, sur https://steamcommunity.com/app/4000/workshop/.
Lis la description en entier, jusqu'en bas. Cherche les mots content, required, subscribe to, ou un lien vers une autre entrée Workshop.
Regarde si la page affiche une liste d'éléments requis : beaucoup d'auteurs l'utilisent.
Note l'id de chaque pack de contenu trouvé, sur sa propre page.
Ajoute ces ids à ta collection et à Resource Lua Code, exactement comme n'importe quel autre addon. Le chapitre 4 détaille pourquoi il faut les deux.
Redémarre, puis vérifie dans garrysmod/cache/srcds/ que le nouveau .gma est bien arrivé.

Une règle du chapitre 4 s'applique ici aussi : un seul exemplaire de chaque chose. Si deux packs prétendent fournir le même contenu, garde celui que recommande l'auteur de la carte.

✅ À retenir Une carte peut venir en deux morceaux. Lis sa page Workshop jusqu'au bout avant de chercher ailleurs.

6. FastDL et Loading URL : une vraie adresse, ou rien #

À quoi ils servent #

Dans l'onglet Server, deux réglages attendent une adresse web :

Fast Download URL : l'adresse d'un site web qui sert aux joueurs les fichiers de ton serveur, plus vite que le serveur de jeu ne le ferait. Il concerne en général ce que tu as déposé à la main (une carte dans maps/, un addon dans addons/). Ce qui vient du Workshop passe déjà par Resource Lua Code.
Loading URL : l'adresse de la page affichée pendant le chargement.

Le fonctionnement détaillé du téléchargement côté client est décrit sur le wiki officiel : https://wiki.facepunch.com/gmod.

Le piège relevé sur de vraies instances #

Plusieurs instances portaient http://example.com dans ces champs. C'est l'exemple du gabarit, resté tel quel. Avec ça, les joueurs vont chercher des fichiers à une adresse qui ne les a pas.

Un FastDL bidon est pire que pas de FastDL du tout. Sans adresse, le jeu se débrouille avec ce qu'il a. Avec une fausse adresse, il part dans la mauvaise direction.

Le ménage à faire #

Ouvre Configuration → Garry's Mod, onglet Server.
Regarde Fast Download URL et Loading URL.
Vide chaque champ qui contient example.com, ou toute adresse que tu ne contrôles pas toi-même.
Enregistre, puis redémarre.

Tu remettras une adresse le jour où tu auras vraiment un site qui sert ces fichiers. Pas avant. Le réglage voisin, Allow Download From Server, est présenté au chapitre 3.

✅ À retenir example.com n'est pas une valeur, c'est un oubli. Vide le champ tant que tu n'as pas de vrai FastDL.

7. Ce que le serveur ne pourra jamais faire à ta place #

Même avec CS:S et TF2 montés, même avec tous les packs de contenu dans ta collection, il reste un cas que tu ne peux pas régler depuis le panel : un joueur qui n'a pas le contenu dans son propre jeu.

Le montage côté serveur sert au serveur. Il n'envoie pas les textures de CS:S aux joueurs. Un joueur sans CS:S verra le damier sur les surfaces qui en dépendent, quoi que tu fasses.

C'est une vraie décision à prendre avant d'ouvrir au public, et le chapitre 10 y revient. Tu as trois options honnêtes :

choisir du contenu qui ne dépend d'aucun autre jeu, quand c'est possible ;
l'annoncer clairement (sur ton Discord, dans la description du serveur) pour que personne ne soit surpris ;
accepter que certains joueurs voient quelques damiers, si la carte reste jouable.

✅ À retenir Monter un jeu sur le serveur ne le donne pas aux joueurs. Ce qui manque dans leur jeu ne se corrige pas depuis AMP.

8. Ce que tu peux demander à tes joueurs #

Une partie de la solution est chez eux. Ce que tu peux raisonnablement leur demander :

s'abonner à ta collection sur le Workshop avant de venir : leur jeu télécharge les addons à l'avance, et la première connexion est plus courte ;
posséder et monter le jeu nécessaire (CS:S, TF2) s'ils veulent voir correctement les cartes qui en dépendent ; le menu principal de Garry's Mod permet de choisir les jeux montés (détails sur https://wiki.facepunch.com/gmod) ;
décrire précisément ce qu'ils voient : quelle carte, à quel endroit, damier ou ERROR, avec une capture d'écran ;
regarder la console de leur propre jeu : elle cite souvent le nom du fichier introuvable, ce qui te dit d'où il vient.

Et ce que tu ne dois jamais leur demander : télécharger une archive de textures depuis un site inconnu. Si un contenu manque, il se trouve sur le Workshop ou dans un jeu officiel.

Quand un joueur te signale un damier, un message bien fait ressemble à ceci :

Carte : gm_construct
Endroit : le grand bâtiment gris, à l'étage
Ce que je vois : des murs en damier violet et noir
Les autres joueurs aussi ? oui / non / je ne sais pas

La quatrième ligne est la plus précieuse : elle te dit tout de suite de quel côté chercher.

✅ À retenir Collection en abonnement, jeux nécessaires montés, signalement précis : c'est tout ce que tu peux attendre d'un joueur, et c'est déjà beaucoup.

✅ Checklist du chapitre #

Je sais distinguer un damier (texture) d'un ERROR (modèle).
Avant de corriger, je vérifie si le problème touche tous les joueurs ou seulement certains.
J'ai activé CSS Content Mode et/ou TF2 Content Mode seulement si mon contenu en a besoin.
J'ai fait un Update après les avoir activés, et j'ai vu les dossiers 232330 / 232250.
J'ai lu garrysmod/cfg/mount.cfg sans le modifier à la main.
J'ai lu jusqu'au bout la page Workshop de chacune de mes cartes, à la recherche d'un pack de contenu séparé.
Fast Download URL et Loading URL sont vides ou contiennent une adresse que je contrôle.
Je sais expliquer à un joueur pourquoi il peut voir un damier que je ne vois pas.

❓ Si ça ne marche pas #

J'ai activé CSS Content Mode, redémarré, et le damier est toujours là. Tu as sans doute cliqué sur Start ou Restart, pas sur Update. Le réglage écrit mount.cfg, mais seul l'Update télécharge le contenu. Fais l'Update, puis vérifie dans le File Manager que le dossier 232330 existe.

Le contenu est monté, les dossiers existent, et un seul joueur voit le damier. Le problème est dans son jeu, pas sur ton serveur. Il lui manque probablement CS:S ou TF2, ou il ne les a pas montés dans son Garry's Mod. Rien à corriger dans AMP.

Tout le monde voit le damier, mais sur une seule carte. Cherche un pack de contenu séparé sur la page Workshop de cette carte (section 5). S'il existe, ajoute-le à ta collection et à Resource Lua Code, puis redémarre.

Des objets d'un addon s'affichent en ERROR pour tout le monde. L'addon n'est probablement pas arrivé, côté serveur ou côté joueurs. Vérifie qu'il est à la fois dans la collection et dans Resource Lua Code, que la clé -authkey est en place, et que son .gma est dans garrysmod/cache/srcds/. Tout est au chapitre 4.

Les joueurs restent bloqués longtemps au chargement, ou le téléchargement échoue. Regarde Fast Download URL : s'il contient http://example.com ou une adresse morte, vide-le, enregistre et redémarre.

Je ne trouve toujours pas d'où vient le damier. Demande sur le Discord TeamKit. Donne le nom de la carte, la liste de ce que tu as activé (CSS, TF2), l'id de ta collection, et dis si tout le monde voit le problème ou seulement certains joueurs.

Une étape qui coince ? Ouvre un ticket sur le site ou demande sur le Discord TeamKit. Le bot Guide connaît ces pages.