Ce guide couvre les problèmes courants que vous pouvez rencontrer lors de l'utilisation d'un serveur dédié Garry's Mod avec Legion Hosting, ainsi que leurs causes et solutions.

Table des matières

1. Textures manquantes / Damiers roses et noirs
2. Les addons Workshop ne se téléchargent pas
3. Le serveur n'apparaît pas dans le navigateur de serveurs
4. Les métiers DarkRP n'apparaissent pas
5. Les commandes ULX ne fonctionnent pas
6. Ping élevé / Lag
7. Le serveur plante au démarrage
8. Les clients restent bloqués sur « Téléchargement » ou connexions lentes

1. Textures manquantes / Damiers roses et noirs

Corrections côté serveur

• Monter Counter-Strike: Source : Dans GPanel, vérifiez si votre offre inclut le montage de contenu de jeu supplémentaire. Si disponible, activez le montage de CS:S dans les paramètres de votre serveur.
• Addon de contenu CSS : Ajoutez un pack de contenu CS:S communautaire depuis le Workshop Garry's Mod à la collection Workshop de votre serveur. Recherchez « Counter-Strike: Source Content » et ajoutez-le.
• Téléversement manuel : Si aucune des options ci-dessus n'est disponible, vous pouvez téléverser manuellement les fichiers de contenu CS:S via SFTP dans garrysmod/addons/css-content/. Consultez le guide de téléversement SFTP pour les instructions.

Correction côté client

Les joueurs qui possèdent Counter-Strike: Source peuvent le monter dans GMod sous Options → Game Content. Cela résout les textures manquantes de leur côté sans aucune modification du serveur.

2. Les addons Workshop ne se téléchargent pas

Si votre serveur ne charge pas les addons Workshop au démarrage, vérifiez les points suivants :

3. Le serveur n'apparaît pas dans le navigateur de serveurs

Si votre serveur fonctionne mais n'apparaît pas dans le navigateur de serveurs Steam :

• Vérifiez sv_lan : Assurez-vous que sv_lan 0 est défini dans server.cfg. Une valeur de 1 rend le serveur accessible uniquement en LAN.
• Vérifiez votre GSLT : Assurez-vous qu'un Game Server Login Token valide est défini via sv_setsteamaccount. Un token expiré ou révoqué empêchera l'affichage public. Générez-en un nouveau sur steamcommunity.com/dev/managegameservers.
• Patientez quelques minutes : L'apparition d'un nouveau serveur dans la liste maîtresse Steam peut prendre plusieurs minutes après le premier démarrage.
• Testez en connexion directe : Essayez de vous connecter via l'IP directe d'abord (voir les instructions de connexion) pour confirmer que le serveur fonctionne bien.

4. Les métiers DarkRP n'apparaissent pas

Si les métiers personnalisés n'apparaissent pas dans le menu F4 après avoir configuré DarkRP :

• Vérifiez l'emplacement des dossiers : DarkRP lui-même doit être dans garrysmod/gamemodes/darkrp/, pas dans addons/. DarkRPModification doit être dans garrysmod/addons/darkrpmodification/. C'est l'erreur la plus courante.
• Vérifiez les erreurs Lua : Ouvrez la console du serveur dans GPanel et recherchez les erreurs Lua au démarrage. Une erreur de syntaxe dans jobs.lua empêchera le chargement de tous les métiers personnalisés.
• Vérifiez le mode de jeu : Confirmez que sv_gamemode "darkrp" est défini dans server.cfg et que le serveur a été entièrement redémarré (pas seulement un changement de carte).
• Vérifiez l'encodage des fichiers : Si vous avez modifié les fichiers Lua sous Windows, assurez-vous qu'ils sont enregistrés en UTF-8 sans BOM. Certains éditeurs de texte ajoutent un BOM (byte order mark) qui peut casser l'analyse Lua.

Étapes rapides de débogage

// Run these in the server console to check gamemode status:
lua_run print(engine.ActiveGamemode())
// Should output: darkrp

lua_run PrintTable(RPExtraTeams)
// Should list all custom jobs if DarkRP loaded correctly

5. Les commandes ULX ne fonctionnent pas

Si les commandes ULX retournent des erreurs ou ne font rien après l'installation :

• Les deux addons sont installés ? ULX nécessite à la fois ULib et ULX. ULX ne fonctionnera pas sans ULib. Vérifiez que les deux sont présents dans garrysmod/addons/ ou dans votre collection Workshop.
• Vérifiez la console pour les erreurs : Consultez la sortie console du serveur dans GPanel au démarrage pour les erreurs mentionnant ULib ou ULX.
• Vérifiez l'attribution de votre utilisateur : Exécutez ulx adduser avec votre nom d'affichage Steam exact, ou utilisez ulx adduserid "STEAM_0:1:12345678" superadmin avec votre Steam ID pour plus de fiabilité.
• Conflits d'addons : Certains addons peuvent entrer en conflit avec ULX. Si les commandes ont cessé de fonctionner après l'ajout d'un nouvel addon, essayez de le supprimer et de redémarrer pour isoler le problème.

6. Ping élevé / Lag

Si votre serveur connaît un ping élevé ou des pics de lag :

• Trop d'addons : Les grandes collections Workshop augmentent l'utilisation de la mémoire et le temps de chargement. Passez en revue votre collection et supprimez les addons qui ne sont pas activement utilisés.
• Surcharge d'entités (DarkRP) : Les serveurs DarkRP avec de nombreuses entités générables (imprimantes à billets, labos de drogue, etc.) peuvent être gourmands en CPU. Définissez des limites d'entités raisonnables dans darkrpmodification/lua/darkrp_config/settings.lua.
• Pics de lag liés à la sauvegarde automatique : Si des pics de lag surviennent à intervalles réguliers (toutes les quelques minutes), il peut s'agir de la sauvegarde automatique du serveur. C'est un comportement normal mais l'intervalle peut être ajusté.
• Nombre de joueurs vs offre : Assurez-vous que votre nombre de joueurs ne dépasse pas ce que les ressources de votre offre peuvent gérer. Envisagez de réduire maxplayers dans server.cfg si vous êtes proche des limites de ressources.
• Complexité de la carte : Certaines cartes communautaires sont mal optimisées. Si le lag a commencé après un changement de carte, essayez de revenir à une carte plus simple pour isoler le problème.

7. Le serveur plante au démarrage

Si votre serveur plante ou ne parvient pas à démarrer :

• Vérifiez le journal de la console : Dans GPanel, consultez la sortie console avant le plantage. Les dernières lignes indiquent généralement la cause.
• Addon défectueux : Un addon récemment ajouté peut être à l'origine du plantage. Supprimez le dernier addon que vous avez ajouté et essayez de redémarrer. Si le serveur démarre, l'addon est le problème.
• Fichiers de mode de jeu corrompus : Si vous utilisez DarkRP ou un autre mode de jeu tiers, essayez de le réinstaller proprement depuis le Workshop ou GitHub.
• Mémoire insuffisante : Trop d'addons peuvent dépasser l'allocation mémoire de votre offre. Vérifiez l'utilisation des ressources dans GPanel et envisagez de réduire votre liste d'addons.

8. Les clients restent bloqués sur « Téléchargement » ou connexions lentes

Si les joueurs restent bloqués sur le téléchargement de contenu pendant longtemps lors de la connexion :

• Configurez FastDL : Sans FastDL, les clients téléchargent les fichiers directement depuis le serveur de jeu, ce qui est très lent. Consultez la section FastDL du guide de configuration du serveur.
• Utilisez le Workshop pour les addons : Les addons livrés via Workshop se téléchargent par le CDN de Steam, ce qui est plus rapide que le téléchargement direct depuis le serveur. Préférez les collections Workshop aux téléversements manuels d'addons quand c'est possible.
• Réduisez le nombre d'addons : Chaque addon ajoute du temps de téléchargement pour le client. Supprimez les addons qui ne sont pas essentiels au gameplay de votre serveur.
• Vérifiez l'utilisation de resource.AddFile : Si vous forcez les clients à télécharger de nombreux fichiers via resource.lua, passez en revue la liste et supprimez les entrées pour les fichiers qui ne sont pas réellement nécessaires côté client.

Articles connexes

• Guide de configuration du serveur Garry's Mod — Server.cfg, Workshop, modes de jeu, DarkRP, FastDL
• Garry's Mod Admin Setup (ULX) — Installer ULX/ULib, commandes admin, groupes de permissions
• Comment téléverser des fichiers via SFTP
• Comment trouver l'IP et le port de votre serveur