Comment corriger les addons GMod qui ne se chargent pas sur votre serveur

Sur un serveur Linux, Garry's Mod est exigeant concernant les noms de dossiers d'addons en raison de la sensibilité à la casse. Ce guide vous aidera à corriger les addons qui n'apparaissent pas à cause de problèmes de nommage.

Qu'est-ce qui ne fonctionne pas sur Linux ?

Les serveurs Linux sont sensibles à la casse, ce qui signifie que certains noms de dossiers causeront des problèmes :

  • Lettres majuscules (par exemple Gas-Config ne fonctionnera pas)
  • Espaces dans les noms de dossiers
  • Ponctuation et caractères spéciaux (!, @, #, etc.)
  • Les noms de dossiers doivent être entièrement en minuscules sans espaces

Règles de nommage valides

Pour garantir que vos addons se chargent correctement sur les serveurs Linux, suivez ces règles :

  • Utilisez uniquement des minuscules
  • Utilisez des tirets (-) ou des underscores (_) — les deux fonctionnent bien sur Linux
  • Évitez les espaces et les symboles

Bons exemples :

gas-config
my_custom_addon
weather_system
darkrp-modifications
police-jobs

Mauvais exemples :

Gas-Config        ← les majuscules cassent tout
Gas Config        ← les espaces échouent sur Linux
Gas_Config!       ← le point d'exclamation ou les symboles ne sont pas autorisés
MyAddon          ← les lettres majuscules causent des problèmes
Custom Addon 2   ← les espaces ne sont pas autorisés

Comment corriger les noms d'addons

Suivez ces étapes pour renommer correctement vos dossiers d'addons :

Étape 1 : Accéder aux fichiers de votre serveur

Connectez-vous via SFTP ou utilisez votre gestionnaire de fichiers dans le panneau de contrôle.

Étape 2 : Naviguer vers le dossier des addons

Allez dans :

garrysmod/addons/

Étape 3 : Renommer les dossiers

Renommez tous les dossiers qui ne suivent pas les règles de nommage :

  • Convertissez toutes les lettres majuscules en minuscules
  • Remplacez les espaces par des tirets ou des underscores
  • Supprimez tous les caractères spéciaux ou symboles

Étape 4 : Redémarrer votre serveur

Après avoir renommé tous les dossiers problématiques, redémarrez votre serveur pour que les modifications prennent effet.

Conseils importants

  • Même si vous téléchargez depuis Windows, vérifiez toujours les noms de dossiers dans /addons/ après l'extraction
  • Linux traite Gas-Config, gas-config et gas_config comme des dossiers complètement différents
  • Tenez-vous aux minuscules + tirets/underscores pour éviter les addons manquants
  • Certains addons peuvent être imbriqués dans d'autres dossiers—vérifiez également les sous-répertoires

Toujours pas chargé ?

Si vos addons ne se chargent toujours pas après avoir corrigé les noms :

  1. Vérifiez les logs du serveur pour les erreurs de chargement
  2. Vérifiez la structure de l'addon - assurez-vous qu'il y a un fichier addon.json ou info.txt
  3. Vérifiez les dépendances manquantes - certains addons nécessitent d'autres addons pour fonctionner
  4. Testez avec une configuration minimale - désactivez les autres addons pour voir s'il y a un conflit
  5. Vérifiez les permissions des fichiers - assurez-vous que le serveur peut lire les fichiers de l'addon

Messages d'erreur courants

Si vous voyez des erreurs comme :

  • addon not found
  • failed to load addon
  • invalid addon structure

Celles-ci sont généralement causées par un nommage de dossier incorrect ou des fichiers manquants dans l'addon.

Prévention

Pour éviter ces problèmes à l'avenir :

  • Utilisez toujours des noms de dossiers en minuscules lors de la création ou du téléchargement d'addons
  • Utilisez une convention de nommage cohérente (tous tirets ou tous underscores)
  • Testez les addons sur un serveur local avant de les télécharger en production
  • Conservez une sauvegarde des configurations d'addons fonctionnelles