FiveM crash au lancement : causes et solutions pour les administrateurs de serveur

Votre serveur FiveM plante au démarrage, ou vos joueurs crashent en tentant de se connecter : dans les deux cas, les logs et les crash dumps contiennent la réponse. Ce tutoriel couvre les causes les plus fréquentes de crash FiveM, du point de vue de l'administrateur qui héberge le serveur sur un VPS (serveur privé virtuel) ou un serveur dédié. Vous trouverez les commandes, les réglages dans server.cfg et les vérifications système (mémoire, processeur, espace disque, base de données MySQL) pour diagnostiquer et corriger chaque problème.

Crash serveur ou crash client : comment les distinguer

Avant de corriger quoi que ce soit, identifiez l'origine du problème :

• Crash du serveur (FXServer) : le processus FXServer s'arrête. La console txAdmin affiche une erreur ou un message de redémarrage automatique. Ouvrez l'interface txAdmin dans votre navigateur web (par défaut sur le port 40120) et cliquez sur l'onglet Console pour voir les dernières lignes avant le crash. Les logs complets sont dans le dossier txData/ et les crash dumps dans cache/crashes/ du répertoire serveur.
• Crash du client à la connexion : FXServer tourne normalement, mais un ou plusieurs joueurs plantent en rejoignant le serveur. Le joueur obtient un code d'erreur (ex. 0xc0000005) ou un retour au bureau sans message. Le problème peut venir d'un script serveur mal codé, d'un plugin incompatible, d'un conflit de version ou d'un souci côté joueur (système d'exploitation pas à jour, antivirus, mises à jour Windows manquantes).

Si le crash ne concerne qu'un seul joueur, le problème est probablement local (cache corrompu, antivirus, configuration PC insuffisante). Si plusieurs joueurs crashent au même moment ou dans la même zone de la carte, le problème vient du serveur. Consultez notre guide solutions aux erreurs courantes sur FiveM pour les codes d'erreur les plus fréquents.

Lire les logs et les crash dumps

Le diagnostic commence par les logs. Sur un serveur géré avec txAdmin, ouvrez le panneau d'administration dans votre navigateur web et cliquez sur la console en direct pour voir les erreurs au moment du crash. Le fichier de log complet est dans le dossier txData/. Si votre serveur tourne sur un VPS Linux sous Ubuntu ou Debian, vous pouvez aussi consulter les logs depuis un terminal SSH :

tail -200 ~/FXServer/txData/default/logs/admin.log

Quand FXServer plante, il écrit un crash dump dans cache/crashes/. Ce fichier contient la stack trace, le module fautif et l'adresse mémoire du crash. Les informations clés à chercher :

• Le nom du module : citizen-scripting-lua ou citizen-scripting-v8 pointe vers un script Lua ou JavaScript. Le dump nomme souvent la ressource fautive.
• Le code d'erreur : 0xc0000005 (Access Violation) est le crash le plus courant. Il signifie qu'un script ou un plugin tente d'accéder à une zone mémoire invalide.
• Le module gta-core-five : indique un crash dans le moteur du jeu, souvent lié à un appel natif incorrect dans une ressource ou à un fichier MLO corrompu.

Sur un serveur distant hébergé chez un hébergeur, récupérez les crash dumps par FTP ou SFTP. Si vous utilisez un VPS, connectez-vous en SSH depuis votre terminal et naviguez jusqu'au répertoire cache/crashes/ pour télécharger le fichier le plus récent.

Mettre à jour les artifacts serveur

Les artifacts sont les fichiers binaires de FXServer. Une version obsolète ou instable provoque des crashs au démarrage du serveur ou à la connexion des joueurs. Deux règles pour les mises à jour :

1. Ne pas utiliser le tout dernier artifact : les builds récents peuvent contenir des régressions. Utilisez la version marquée "recommended" ou "latest" stable sur la page de téléchargement officielle des artifacts Cfx.re. Avant d'installer la mise à jour, faites une sauvegarde complète de votre répertoire FXServer.
2. Vérifier la compatibilité avec votre framework : après une mise à jour d'artifacts, vérifiez que votre framework (ESX Legacy, QBCore, QBox) fonctionne correctement. Les changements d'API internes peuvent casser des scripts et des plugins qui appelaient des fonctions natives modifiées.

Pour mettre à jour sous Windows : arrêtez le serveur, remplacez les fichiers artifacts dans le répertoire FXServer, puis redémarrez. Sur un VPS Linux (Ubuntu ou Debian), téléchargez le nouvel artifact depuis le terminal :

cd ~/FXServer/server
wget https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/XXXX-xxxxxxxxx/fx.tar.xz
tar xf fx.tar.xz

Remplacez XXXX-xxxxxxxxx par le numéro du build stable recommandé. Conservez toujours une copie de la version précédente pour revenir en arrière en cas de problème. Si vous utilisez un framework RP, consultez notre guide installer ESX Legacy sur FiveM pour les détails de compatibilité.

Vérifier sv_enforceGameBuild dans server.cfg

La variable sv_enforceGameBuild dans server.cfg force les joueurs à charger un build spécifique de GTA V. Sans cette ligne, le serveur utilise le build de base (1604), et les véhicules, armes et vêtements des DLC récents ne sont pas disponibles.

Un mauvais numéro de build ou une incohérence entre le build serveur et les ressources installées (scripts, plugins, vêtements addon) provoque des crashs à la connexion. Symptômes typiques :

• Les joueurs restent bloqués sur l'écran de chargement, puis plantent.
• Les crashs surviennent dès l'apparition du personnage (spawn).
• Les vêtements addon ou EUP provoquent un retour au bureau immédiat.

Pour corriger : vérifiez que le numéro de build dans server.cfg correspond aux ressources installées (véhicules, vêtements, armes). Ce réglage ne prend effet qu'au démarrage du serveur : un changement nécessite un redémarrage complet de FXServer.

# Exemple dans server.cfg
sv_enforceGameBuild 3258

Scripts et plugins : identifier une ressource corrompue

Une ressource mal codée, un MLO corrompu ou un véhicule addon défectueux sont les causes les plus fréquentes de crash côté serveur. Les scripts Lua et JavaScript (plugins, extensions de framework) peuvent provoquer des erreurs fatales si leur code accède à des fonctions natives supprimées ou modifiées dans un artifact récent. La méthode de diagnostic :

1. Activez le moniteur de ressources : tapez resmon 1 dans la console serveur (ou cliquez sur le bouton Resource Monitor dans txAdmin). Chaque ressource affiche son temps processeur par frame. Un script dépassant 5 ms par frame est un risque de crash sous charge.
2. Isolez par suppression : si le crash est récent, désactivez les derniers scripts ajoutés. Commentez les lignes ensure correspondantes dans server.cfg et redémarrez le serveur après chaque suppression pour identifier le plugin fautif.
3. MLO et crashs par zone : si les joueurs plantent en entrant dans une zone précise de la carte, le MLO (Map Load Object) de cette zone est probablement corrompu ou incompatible avec le build actuel. Retirez le MLO et testez.
4. Vérifiez la provenance des scripts : installez uniquement des ressources provenant de sources fiables (Cfx.re Forum, GitHub, Tebex). Un script téléchargé depuis un site non vérifié peut contenir du code malveillant ou des erreurs qui crashent le serveur. Notre guide scripts FiveM : où les trouver, lesquels éviter détaille les bonnes pratiques.

Avant d'installer un nouveau plugin, vérifiez sa compatibilité avec votre version d'artifacts et votre framework. Notre guide optimiser les performances d'un serveur FiveM détaille la surveillance des ressources et la réduction de la charge serveur.

Connexion MySQL et base de données

Les serveurs FiveM en mode RP (ESX Legacy, QBCore, QBox) dépendent d'une base de données MySQL ou MariaDB pour stocker les personnages, inventaires, véhicules et comptes joueurs. Si la connexion à MySQL échoue au démarrage, le serveur crash ou démarre sans charger les scripts essentiels du framework. Les causes les plus fréquentes :

• Chaîne de connexion incorrecte : vérifiez la variable set mysql_connection_string dans server.cfg. Le format attendu par oxmysql est mysql://utilisateur:motdepasse@adresse/nom_base. Si la base MySQL est sur le même serveur, utilisez 127.0.0.1 comme adresse. Pour une base MySQL distante hébergée sur un autre serveur, indiquez l'adresse IP du serveur distant et vérifiez que le port 3306 est ouvert dans le pare-feu.
• Ordre de démarrage des ressources : oxmysql doit être la première ressource chargée, le premier ensure dans server.cfg, avant le framework et avant toute extension qui interroge la base de données. Si oxmysql démarre après un script qui fait des requêtes MySQL, les erreurs "database not connected" provoquent un crash en cascade.
• Limite de connexions MySQL : un serveur FiveM chargé (50+ joueurs simultanés) ouvre de nombreuses connexions. Si la limite max_connections de MySQL est trop basse, les nouvelles requêtes échouent et les scripts crashent. Augmentez cette limite dans la configuration MySQL si nécessaire.

Pour diagnostiquer, vérifiez d'abord que le service MySQL tourne. Sur un VPS Linux sous Ubuntu ou Debian, ouvrez un terminal et tapez :

sudo systemctl status mysql

Si le service est arrêté, redémarrez-le avec sudo systemctl start mysql. Consultez notre guide lier une base de données MySQL à un serveur FiveM pour la configuration complète, et notre tutoriel sauvegarder et restaurer une base MySQL FiveM pour protéger vos données joueurs.

Mémoire RAM et processeur du serveur

Un serveur FiveM qui manque de mémoire RAM plante sans avertissement. La consommation dépend directement du nombre de ressources chargées, de joueurs connectés et du contenu custom installé (scripts, véhicules addon, MLO). Le processeur est aussi un facteur : un VPS avec un processeur lent ou surchargé fait monter le temps de frame au-delà de la limite, ce qui déclenche un crash ou un gel du serveur.

Surveillez la consommation mémoire et processeur de FXServer en temps réel. Dans txAdmin, cliquez sur Dashboard pour voir les graphiques d'utilisation. Si le serveur tourne sur un VPS Linux, connectez-vous en SSH et utilisez htop dans le terminal :

htop -p $(pgrep -d',' FXServer)

Si la RAM sature régulièrement ou si le processeur atteint 100 %, il faut soit réduire le nombre de scripts et plugins, soit passer à une offre avec plus de mémoire et de puissance processeur. Consultez nos offres d'hébergement FiveM pour trouver la configuration adaptée à votre serveur.

Espace disque et nettoyage du cache

Un serveur FiveM consomme de l'espace disque pour les artifacts, les ressources (scripts, MLO, véhicules addon), les logs txAdmin, les crash dumps et le cache compilé. Quand le disque dur est plein, FXServer ne peut plus écrire de fichiers temporaires et plante silencieusement, sans message d'erreur explicite dans les logs.

Vérifier l'espace disque disponible

Sur un VPS Linux (Ubuntu, Debian), vérifiez l'espace disque depuis le terminal :

df -h /home

Sous Windows, ouvrez l'explorateur de fichiers et vérifiez l'espace libre sur le disque dur où FXServer est installé. Si l'espace disque est inférieur à 1 Go, supprimez les anciens artifacts, les crash dumps obsolètes et les logs volumineux. Notre guide surveiller l'espace disque d'un VPS Linux détaille la surveillance automatique.

Nettoyer le cache serveur

Le dossier cache/ dans le répertoire de votre serveur FiveM contient les fichiers compilés des ressources. Sa taille représente 15 à 50 % de la taille de votre dossier resources/, selon le volume de contenu streamé (vêtements, textures, sons). Après une mise à jour d'artifacts ou un changement de scripts, nettoyez-le :

1. Arrêtez le serveur FiveM.
2. Supprimez le contenu du dossier cache/ (sauf le sous-dossier crashes/ si vous avez besoin des dumps).
3. Redémarrez le serveur : FXServer recompile les ressources automatiquement.

Nettoyer le cache client (joueur)

Si un joueur crash en se connectant à votre serveur mais pas aux autres, demandez-lui de nettoyer son cache FiveM local :

1. Fermer complètement FiveM.
2. Sous Windows, ouvrir l'explorateur et aller dans %localappdata%\FiveM\FiveM.app\data\cache.
3. Supprimer tout le contenu du dossier.
4. Relancer FiveM.

Si le problème persiste côté joueur, renvoyez-le vers notre guide FiveM ne se lance pas qui couvre les causes locales (antivirus, mises à jour du système d'exploitation Windows, Visual C++ Redistributables, fichiers GTA V corrompus).

Configuration réseau et pare-feu

Un pare-feu mal configuré empêche les joueurs de se connecter ou provoque des timeouts qui ressemblent à un crash. FXServer utilise le port 30120 en TCP (téléchargement des ressources, handshake client) et UDP (données de jeu en temps réel). Le panneau txAdmin écoute sur le port TCP 40120. Si seul le port TCP est ouvert, les joueurs voient le serveur dans la liste mais ne peuvent jamais s'y connecter : les données de jeu transitent en UDP.

Sous Windows

Si votre serveur FiveM tourne sous Windows (VPS Windows ou serveur dédié), ouvrez les ports dans le pare-feu Windows Defender. Depuis un terminal PowerShell lancé en administrateur :

New-NetFirewallRule -DisplayName "FiveM TCP" -Direction Inbound -Protocol TCP -LocalPort 30120 -Action Allow
New-NetFirewallRule -DisplayName "FiveM UDP" -Direction Inbound -Protocol UDP -LocalPort 30120 -Action Allow
New-NetFirewallRule -DisplayName "txAdmin" -Direction Inbound -Protocol TCP -LocalPort 40120 -Action Allow

Sous Linux (Ubuntu, Debian)

Sur un VPS Linux, utilisez UFW pour ouvrir les ports. Depuis le terminal, en tant que root ou avec sudo :

sudo ufw allow 30120/tcp
sudo ufw allow 30120/udp
sudo ufw allow 40120/tcp

Consultez notre guide ouvrir les ports d'un serveur de jeu Linux avec UFW pour la configuration complète du pare-feu. Si vous avez configuré un nom de domaine personnalisé avec un enregistrement DNS SRV pour votre serveur FiveM, vérifiez aussi que la résolution DNS pointe vers la bonne adresse IP du serveur.

Déployer et mettre à jour les fichiers du serveur

Une mauvaise manipulation lors du transfert de fichiers (ressources incomplètes, fichiers écrasés) provoque des crashs au démarrage. Voici les bonnes pratiques pour déployer vos mises à jour sur le serveur distant :

• Utilisez SFTP plutôt que FTP : le protocole FTP transmet les données en clair. Préférez SFTP (transfert via SSH) pour envoyer vos scripts et plugins vers le serveur distant. Des outils comme WinSCP ou FileZilla permettent de gérer les fichiers du serveur depuis votre poste sous Windows.
• Faites des sauvegardes avant chaque mise à jour : avant d'installer un nouveau plugin ou de mettre à jour le framework, copiez l'intégralité du répertoire resources/ et du fichier server.cfg. Notre guide sauvegardes serveur FiveM détaille les méthodes de sauvegardes automatiques.
• Vérifiez l'intégrité des fichiers après transfert : un fichier .lua ou .js tronqué lors d'un transfert interrompu provoque un crash au chargement de la ressource. Comparez la taille des fichiers sur votre poste et sur le serveur distant.
• Redémarrez le serveur après chaque modification : certains scripts et extensions ne supportent pas le rechargement à chaud (ensure en console). Un redémarrage complet de FXServer évite les conflits en mémoire.

Si vous hébergez votre serveur FiveM sur un VPS Linux, vous pouvez aussi utiliser rsync depuis le terminal pour synchroniser les fichiers entre votre poste et le serveur distant, ou git pull si vos ressources sont versionnées dans un dépôt.

Réglages server.cfg pour la stabilité

Plusieurs variables dans server.cfg réduisent les risques de crash au démarrage et pendant le fonctionnement du serveur :

Pensez à sauvegarder votre serveur FiveM avant toute modification de la configuration. Un server.cfg mal configuré peut empêcher le démarrage du serveur. Après chaque modification, redémarrez FXServer et vérifiez les logs dans txAdmin pour confirmer que le serveur démarre correctement.

Checklist de diagnostic rapide

Quand votre serveur FiveM crash au lancement ou que vos joueurs plantent en se connectant, suivez cette liste dans l'ordre :

1. Lire les logs dans txAdmin (cliquez sur Console) et le crash dump dans cache/crashes/.
2. Vérifier la version des artifacts : installez la version stable recommandée par Cfx.re.
3. Vérifier sv_enforceGameBuild dans server.cfg et sa cohérence avec les scripts et plugins installés.
4. Vérifier la connexion MySQL : le service tourne-t-il ? La chaîne de connexion est-elle correcte ?
5. Désactiver le dernier plugin ou script ajouté et redémarrer le serveur.
6. Surveiller la consommation mémoire RAM et processeur avec txAdmin ou htop dans le terminal.
7. Vérifier l'espace disque disponible sur le disque dur du serveur.
8. Nettoyer le cache serveur (cache/) et demander aux joueurs de nettoyer leur cache local sous Windows.
9. Vérifier les règles de pare-feu : ports 30120 (TCP et UDP) et 40120 (TCP) ouverts.
10. Vérifier les logs pour un MLO ou véhicule addon spécifique nommé dans le crash dump.

Si le problème persiste après ces vérifications, isolez le serveur en ne démarrant que les ressources essentielles (framework + base de données MySQL) et rajoutez les plugins un par un jusqu'à reproduire le crash. Si votre hébergeur ne fournit pas assez de ressources (mémoire, processeur, espace disque), envisagez de migrer votre serveur FiveM vers un nouvel hébergeur qui propose des offres adaptées à votre nombre de joueurs et de scripts.