Corriger les textures manquantes et les modèles ERROR dans GMod

Un damier rose et noir signifie que le moteur ne trouve pas un matériau ou sa texture. Un grand ERROR rouge indique un modèle manquant. Le plus souvent, le contenu n’existe que sur la machine du mappeur : il n’a pas été packé dans le BSP, il vient d’un jeu qui n’est pas monté, comme Team Fortress 2, ou il est cherché sous un mauvais chemin. Les mappeurs règlent ça en packant le contenu et en vérifiant les chemins, les joueurs et les serveurs en montant ou en téléchargeant le contenu.

Ce que signifient les symptômes

Le dernier cas a son propre article : corriger les reflets des cubemaps.

Les causes les plus fréquentes

1. Contenu non packé : Les matériaux, modèles et sons custom se trouvent dans ton dossier de jeu local. Hammer et ton jeu les y trouvent, personne d’autre.
2. Contenu d’un autre jeu : Beaucoup de maps utilisent des assets d’autres jeux Source. Depuis la mise à jour de juillet 2025, GMod fournit lui-même la plupart des textures, modèles et sons de Counter-Strike: Source et des épisodes de Half-Life 2, mais pas leurs maps, leur musique ni leurs voix. Pour d’autres jeux comme Team Fortress 2 ou Portal, celui qui n’a pas installé le jeu et ne l’a pas monté dans GMod voit des damiers et des ERROR.
3. Mauvais chemin : Dans un VMT, $basetexture est indiqué relativement au dossier materials et sans extension de fichier. Un modèle cherche ses matériaux dans les dossiers définis au moment de sa compilation. Si tu déplaces ensuite des fichiers dans un autre dossier, ces références ne mènent plus nulle part.
4. Fichiers incomplets : Un VMT sans VTF correspondant donne lui aussi un damier. Un modèle se compose de plusieurs fichiers, dont .vvd, .vtx et souvent .phy en plus du .mdl. S’il en manque un, le modèle ne fonctionne pas.
5. Majuscules et minuscules : Les serveurs Linux distinguent les majuscules des minuscules. Écris tous les noms de fichiers et de dossiers en minuscules.

La solution pour les mappeurs

Que tout s’affiche correctement dans Hammer ne prouve rien. L’éditeur charge le contenu depuis tes dossiers locaux et depuis tous les jeux que tu as montés.

1. Fais l’inventaire des matériaux, modèles et sons custom utilisés par la map.
2. Packe ces fichiers dans le BSP. Les outils de packing trouvent la plupart des dépendances tout seuls. Vérifie quand même que les matériaux des modèles et les textures supplémentaires comme les normal maps sont bien inclus. Les détails sont dans l’article packer du contenu custom dans un BSP.
3. Vérifie les chemins dans le pakfile. Chaque fichier doit y être rangé comme dans le dossier du jeu, en commençant par materials/, models/ ou sound/. Depuis décembre 2023, GMod contrôle en plus les fichiers intégrés par rapport à une whitelist et ne charge pas un fichier qui échoue. La console affiche alors BSP embedded file failed whitelist check. Le Map Scanner liste les fichiers Lua et les assets intégrés au pakfile.
4. Teste comme un inconnu. Charge le BSP dans une installation de GMod qui ne contient ni tes addons ni tes fichiers non packés, ou fais-le tester par quelqu’un qui n’a pas ton projet sur sa machine.
5. Indique clairement les jeux requis dans la description. Savoir si tu as le droit de packer du contenu tiers dans ta map est une question de licence, pas de technique.

Ce test fait partie intégrante de la vérification d’une map avant sa publication. Le contenu manquant est l’une des premières erreurs que remarquent les joueurs et les acheteurs.

La solution pour les joueurs

• Monter le jeu : Si tu possèdes le jeu requis, installe-le via Steam. Clique ensuite sur l’icône de manette en bas à droite du menu principal de GMod, coche le jeu et redémarre GMod si le contenu n’apparaît toujours pas.
• S’abonner aux dépendances Workshop : Beaucoup de maps du Workshop indiquent le contenu requis sur leur page. Abonne-toi aussi à ce contenu.
• Récupérer le contenu du serveur : Si le problème n’apparaît que sur un serveur précis, il te manque le contenu de ce serveur. Beaucoup de serveurs renvoient vers une collection Workshop.

Les packs de contenu provenant de sources non officielles sont douteux, sur le plan juridique comme sur celui de la sécurité. La voie propre, c’est le jeu original monté.

La solution pour les propriétaires de serveurs

Sur un serveur, il y a deux tâches distinctes.

Le serveur lui-même a besoin du contenu. S’il lui manque un modèle, il lui manque aussi les données de collision de ce modèle. Sur un serveur dédié, tu montes le contenu d’autres jeux via le fichier garrysmod/cfg/mount.cfg.

Les joueurs ont besoin du contenu. Il y a trois façons de le leur faire parvenir :

• Le contenu packé dans le BSP arrive automatiquement avec la map, à condition de passer la whitelist de GMod pour les fichiers intégrés.
• Le contenu Workshop est chargé sur le serveur via une collection et livré aux joueurs avec resource.AddWorkshop.
• Les fichiers non packés sont distribués par FastDL avec sv_downloadurl.

La mise en place est décrite dans l’article installer une map GMod sur un serveur avec FastDL et Workshop. Si ta map exige un jeu monté, dis-le clairement dans les infos du serveur.

Questions fréquentes

Pourquoi est-ce que je ne vois des textures roses que sur certains serveurs ?

Parce que chaque serveur utilise son propre contenu. Il te manque les fichiers de ce serveur, ou sa map utilise un jeu que tu n’as pas monté. Sur les serveurs qui n’utilisent que du contenu standard, le problème n’apparaît pas.

Ai-je besoin de Counter-Strike: Source pour GMod ?

Dans la plupart des cas, plus maintenant. Depuis la mise à jour de juillet 2025, GMod fournit lui-même la plupart des textures, modèles et sons de Counter-Strike: Source. Tu as encore besoin du jeu, installé et monté, pour ses maps d’origine et pour les maps qui utilisent sa musique ou ses voix.

Pourquoi tout s’affiche-t-il correctement dans Hammer mais pas en jeu ?

Hammer et ton propre jeu trouvent les fichiers dans tes dossiers locaux. Les autres joueurs n’ont pas ces dossiers. Seul un test sans ton contenu local montre ce que contient vraiment le BSP.

Quelle est la différence entre un damier et un modèle ERROR ?

Le damier remplace un matériau ou une texture manquants. L’ERROR rouge remplace un modèle manquant. Si un modèle est visible mais rose et noir, le fichier du modèle a été trouvé et seuls ses matériaux manquent.