Fix "Too Many Lua Errors, Sorry!" : guide complet côté client et côté serveur

TL;DR

Vous vous faites kick avec le message Disconnect: Too Many Lua Errors, Sorry! ? Ce disconnect vient d'un système intégré à Garry's Mod qui expulse automatiquement un joueur dès qu'il accumule trop d'erreurs Lua côté client pendant une session. La solution rapide pour les admins/propriétaires de serveur est la commande sv_kickerrornum 0. Si vous êtes simple joueur, la démarche est différente et se passe entièrement côté client. Ce guide couvre les deux cas.

Comprendre le problème

Garry's Mod dispose d'un mécanisme de protection qui compte les erreurs Lua générées par un client. Quand ce compteur dépasse un certain seuil, le serveur expulse le joueur avec le fameux message :

Disconnect: Too Many Lua Errors, Sorry!

Dans la console du serveur, vous verrez quelque chose comme :

[NomDuJoueur|3|STEAM_0:1:XXXXXXXX] Lua Error: Couldn't include file 'monaddon.lua' (File not found)
[NomDuJoueur|3|STEAM_0:1:XXXXXXXX] Lua Error: Couldn't include file 'autreaddon.lua' (File not found)
Dropped NomDuJoueur from server ("Too many Lua Errors! Sorry!")

Ces erreurs surviennent typiquement quand un addon ou gamemode tente d'inclure des fichiers Lua introuvables, quand un modèle ou NPC provoque des erreurs au chargement, ou quand il y a un conflit entre les addons du serveur et ceux installés côté client.

Important : sv_kickerrornum est une ConVar serveur. Elle ne peut être modifiée que par le propriétaire ou un admin console du serveur — pas par un simple joueur depuis sa propre console.

Fix côté serveur (admins et propriétaires)

C'est la solution la plus connue et la plus efficace pour empêcher que des joueurs se fassent kick.

Option A — Dans la console du serveur (temporaire)

Ouvrez la console de votre serveur dédié (ou votre console in-game si vous êtes l'hôte) et tapez :

sv_kickerrornum 0

Cela désactive immédiatement le système de kick par erreurs Lua. Attention : ce réglage est perdu au redémarrage du serveur.

Option B — Dans le server.cfg (permanent, recommandé)

Pour que le fix soit permanent, ajoutez la ligne suivante à votre fichier de configuration serveur :

// Désactive le kick automatique pour trop d'erreurs Lua
sv_kickerrornum 0

Le fichier à éditer se trouve ici :

garrysmod/cfg/server.cfg

Si vous utilisez un hébergeur (panel de gestion), allez dans Configuration Files et éditez le server.cfg depuis l'interface. Sauvegardez puis redémarrez le serveur pour appliquer le changement.

Note importante : sv_kickerrornum 0 ne supprime pas les erreurs Lua, il empêche seulement le serveur d'expulser les joueurs à cause d'elles. Les erreurs continuent d'exister dans la console — c'est à vous de les corriger à la source.

Ce que sv_kickerrornum fait réellement

Selon le code source de Facepunch (dépôt GitHub officiel de Garry's Mod), sv_kickerrornum est défini à "0" par défaut dans les nouvelles versions du jeu — ce qui signifie que sur les serveurs bien configurés, ce problème ne devrait plus se produire si le server.cfg n'écrase pas cette valeur.

Fix côté client (joueurs sans accès admin)

Si vous n'êtes pas admin du serveur et que vous seul êtes affecté par ce disconnect, voici les étapes à suivre dans l'ordre.

Étape 1 — Désactiver vos addons Workshop

Le problème vient souvent d'addons installés localement qui entrent en conflit avec le contenu du serveur. Désactivez tous vos addons avant de rejoindre le serveur :

1. Lancez Garry's Mod
2. Cliquez sur Addons dans le menu principal
3. Désactivez l'ensemble des addons (ou utilisez un preset vide)
4. Redémarrez GMod et retentez la connexion

Si ça fonctionne, réactivez vos addons un par un pour identifier lequel est problématique.

Étape 2 — Vérifier l'intégrité des fichiers du jeu

Via Steam :

1. Clic droit sur Garry's Mod dans votre bibliothèque
2. Propriétés → Fichiers locaux
3. Vérifier l'intégrité des fichiers du jeu

Attendez la fin du processus, puis relancez GMod.

Étape 3 — Vider le cache de téléchargement

Les fichiers temporaires corrompus peuvent causer des erreurs Lua en masse. Supprimez le contenu du dossier :

Steam\steamapps\common\GarrysMod\garrysmod\cache\

Ne supprimez pas le dossier lui-même, seulement son contenu.

Étape 4 — Lire la console pour identifier l'erreur source

Avant de rejoindre le serveur, ouvrez la console (touche ` ou F10) et regardez ce qui s'affiche pendant le chargement. Les erreurs Lua sont affichées en jaune (clientside) ou en bleu (serverside). Notez le nom du fichier incriminé — c'est souvent un addon spécifique qu'il vous suffit de désactiver.

Étape 5 — Contacter l'admin du serveur

Si vous avez suivi toutes les étapes précédentes sans succès, le problème vient très probablement du serveur lui-même (addons cassés, fichiers manquants). Dans ce cas, la seule solution est que l'admin du serveur corrige les erreurs Lua à la source ou applique sv_kickerrornum 0.

Côté admin : aller plus loin que sv_kickerrornum 0

Désactiver le kick, c'est bien, mais ça ne règle pas le fond du problème. Voici comment identifier et corriger les vraies erreurs :

Lire les logs du serveur

Chaque erreur Lua affiche le fichier et la ligne concernés dans la console. Par exemple :

Lua Error: Couldn't include file 'monscript.lua' (File not found)
(@lua/autorun/monaddon.lua (line 42))

→ Cela signifie que monaddon.lua essaie d'inclure monscript.lua qui n'existe pas. Soit l'addon est incomplet, soit il dépend d'un autre addon non installé.

Méthode de diagnostic par exclusion

1. Désactivez tous les addons du serveur sauf le gamemode de base
2. Redémarrez et vérifiez si le problème persiste
3. Réactivez les addons par groupes pour isoler le coupable

Maintenir ses addons à jour

Les addons Workshop obsolètes ou non maintenus sont la première source d'erreurs Lua en masse. Vérifiez régulièrement que vos addons sont compatibles avec la version actuelle de GMod (branche x86-64 / Chromium).

Pièges classiques à éviter

• Ne pas mettre sv_kickerrornum 0 sans chercher à corriger les erreurs : vous masquez le problème, vos joueurs auront des bugs visuels ou fonctionnels liés aux scripts cassés.
• Confondre erreur clientside et serverside : une erreur jaune dans la console est côté client, une erreur bleue est côté serveur. La correction n'est pas la même.
• Croire que seul le joueur kické a un problème : souvent, les mêmes erreurs affectent tous les joueurs, mais certains ont un seuil atteint plus vite selon leurs addons locaux.
• Oublier de redémarrer après avoir modifié server.cfg : la ConVar n'est pas rechargée à chaud.

FAQ

Q : Je suis simple joueur et je n'ai aucun addon, pourquoi je me fais quand même kick ?

Le problème vient alors du serveur lui-même (addons serveur cassés, fichiers manquants). Contactez l'admin et demandez-lui d'appliquer sv_kickerrornum 0 ou de corriger ses addons.

Q : Est-ce que sv_kickerrornum 0 est dangereux pour mon serveur ?

Non, c'est une ConVar officielle de GMod. Elle désactive simplement le kick automatique. Vos joueurs peuvent rester en jeu même avec des erreurs Lua, ce qui peut causer quelques bugs graphiques ou de script — mais rien de critique pour la stabilité du serveur.

Q : L'erreur revient même après avoir mis sv_kickerrornum 0 dans server.cfg ?

Vérifiez qu'il n'y a pas une autre ligne dans votre server.cfg ou dans un fichier .cfg chargé après (ex: autoexec.cfg) qui remet la valeur à 1. Cherchez toutes les occurrences de sv_kickerrornum dans vos fichiers de config.

Q : Peut-on trouver des addons et scripts GMod de qualité pour éviter ces problèmes ?

Oui — sur GM Market, les scripts proposés sont vérifiés et testés, ce qui limite considérablement les risques d'erreurs Lua à la source.

Si ce guide vous a aidé, n'hésitez pas à partager votre cas dans les commentaires — ça peut aider d'autres membres de la communauté qui rencontrent le même problème.