La plupart des pannes d'un serveur FiveM se rangent dans une poignée de catégories récurrentes : connexion, crash au démarrage, erreurs de script, performances et base de données. Ce guide reprend chacune avec la vraie cause la plus fréquente et la marche à suivre pour la corriger, plutôt qu'une liste générique de conseils.
Les joueurs n'arrivent pas à se connecter
Avant de chercher plus loin, vérifiez dans cet ordre :
- Le serveur tourne réellement et le port par défaut
30120(TCP et UDP) est bien ouvert sur le pare-feu de la machine, pas seulement sur la box si vous êtes en local. - La version de l'artefact FXServer utilisée n'est pas obsolète : un artefact trop ancien peut refuser certaines connexions clientes récentes.
- Le serveur n'est pas plein ou mal configuré en
sv_maxclients.
Sur un hébergement avec panel, ces ports sont en général déjà ouverts par défaut : si le problème persiste malgré tout, il vient plutôt de la configuration du serveur lui-même que du réseau.
Le serveur crash ou refuse de démarrer
Un crash au démarrage vient presque toujours d'une des trois causes suivantes, dans cet ordre de fréquence :
- Une ressource mal chargée dans
server.cfg: nom de dossier qui ne correspond pas exactement à ce qui est écrit dansensure(sensible à la casse sur certains systèmes), ou ordre de chargement incorrect. - Un artefact FXServer corrompu ou incompatible avec les ressources installées, en particulier après une mise à jour majeure de FiveM.
- Une ressource qui plante au démarrage : la console affiche presque toujours le nom exact du script fautif juste avant l'arrêt, c'est la première chose à lire.
Isolez le problème en commentant les ressources ajoutées récemment dans server.cfg, puis en les réactivant une par une jusqu'à retrouver la coupable.
Erreurs de script en jeu ou dans la console
Une erreur Lua ou JS dans la console au moment où un joueur déclenche une action pointe presque toujours vers un script tiers mal mis à jour, en particulier après une mise à jour de framework (ESX, QBCore). Deux réflexes avant de chercher plus loin : vérifiez que la version du script correspond bien à la version du framework installée, et testez la ressource seule sur un serveur de développement avant de la remettre en production.
Lags et temps de réponse élevés
Les problèmes de performance côté serveur ont rarement une seule cause : ils s'accumulent. Les leviers les plus efficaces, dans l'ordre :
- Réduire le nombre de ressources actives en continu qui tournent en boucle (threads mal optimisés dans certains scripts communautaires).
- Vérifier la charge CPU réelle du processus FXServer plutôt que de deviner : un serveur qui sature un seul cœur lag même avec de la RAM disponible.
- S'assurer que l'hébergement dispose d'un CPU à fréquence élevée, FXServer étant mono-thread pour l'essentiel de sa logique de jeu : la fréquence compte plus que le nombre de cœurs.
Si les lags persistent malgré un serveur bien optimisé et que le problème vient visiblement de la machine elle-même, le souci est probablement l'hébergement plutôt que la configuration. Nous avons écrit une page dédiée pour ce cas précis : changer d'hébergeur FiveM sans tout recommencer.
Erreurs liées à la base de données
Les problèmes de sauvegarde ou d'accès aux données passent presque toujours par la même checklist : la chaîne de connexion dans server.cfg pointe vers le bon hôte, utilisateur et nom de base, le connecteur (oxmysql, voir notre guide ESX Legacy pour la configuration détaillée) est bien chargé avant les ressources qui en dépendent, et la base n'est pas saturée en connexions simultanées sur les gros serveurs.
Mettez en place des sauvegardes régulières indépendamment de votre hébergeur : c'est la seule vraie protection contre une perte de données, quelle qu'en soit la cause.
Checklist de dépannage générale
- Lire la console au démarrage avant de chercher ailleurs : l'erreur exacte y est presque toujours.
- Isoler en désactivant les ressources récemment ajoutées.
- Vérifier les versions (artefact FXServer, framework, scripts tiers) en cas de comportement nouveau après une mise à jour.
- Surveiller CPU et RAM réels plutôt que de deviner la cause d'un lag.
Si vous montez tout juste votre infrastructure, notre guide de mise en place d'un serveur FiveM couvre les bases avant même d'en arriver au dépannage. Et si vous voulez tester ces réglages sans engager de budget, l'offre FiveM gratuite suffit largement.