Un serveur FiveM qui refuse de démarrer, c'est presque toujours une cause précise et identifiable. La console vous montre déjà l'origine du problème. Voici les 8 erreurs les plus courantes et comment les corriger une par une.
D’abord, lisez la console
Avant tout, ouvrez la console du serveur (ou les logs txAdmin). C’est votre meilleur outil de diagnostic : FiveM y écrit presque toujours la raison exacte du blocage, en rouge, avec le nom de la ressource fautive et le numéro de ligne.
Le réflexe gagnant : repérez le premier message d’erreur du haut vers le bas. Les erreurs suivantes sont souvent des conséquences en cascade de la première. Réglez la cause initiale et le reste disparaît généralement.
Gardez à l’esprit que la plupart des serveurs qui ne démarrent pas tombent dans l’une des huit catégories ci-dessous. Passons-les en revue dans l’ordre où il faut les vérifier.
1. Une clé de licence invalide
C’est la cause numéro un. Sans clé de licence FiveM valide, le serveur s’arrête immédiatement avec un message du type « invalid license key ».
Vérifiez que :
- La clé est bien renseignée dans votre
server.cfg(sv_licenseKey "votre_clé"). - La clé n’est pas expirée ou liée à une autre IP que celle de votre serveur.
- Vous n’avez pas laissé d’espace ou de guillemet en trop.
Regénérez-en une gratuitement sur keymaster.fxserver.com si le moindre doute subsiste.
2. La connexion MySQL échoue
Si votre serveur utilise un framework (ESX, QBCore), il a besoin de MySQL pour démarrer. Une erreur de type « Unable to connect to database » bloque tout.
Contrôlez les paramètres de connexion dans votre configuration :
| À vérifier | Erreur fréquente |
|---|---|
| Hôte et port | Port 3306 fermé ou mauvais hôte |
| Identifiants | Mot de passe erroné |
| Nom de la base | Base inexistante |
| Droits | Utilisateur sans accès à la base |
Si vous n’êtes pas sûr de votre configuration, notre guide MySQL pour FiveM détaille la procédure complète. Vérifiez aussi que le service MySQL est bien démarré.
Bon à savoir : le caractère ? dans la chaîne de connexion mysql_connection_string est sensible. Une faute de frappe sur l'utilisateur ou le mot de passe se traduit toujours par un échec de démarrage silencieux côté framework.
3. Un script fautif bloque le démarrage
Un seul script mal configuré peut empêcher tout le serveur de se lancer. La console indique alors « Failed to load resource » suivi du nom de la ressource.
La méthode : désactivez temporairement le script suspect en commentant sa ligne ensure nom_du_script dans le server.cfg (ajoutez # devant). Relancez. Si le serveur démarre, vous avez trouvé le coupable. Il faut alors le mettre à jour, vérifier ses dépendances ou le remplacer. Pour ajouter ou retirer proprement vos ressources, suivez notre tutoriel sur les scripts FiveM.
4. Une erreur dans le server.cfg
Le fichier server.cfg est le cœur de la configuration. Une virgule oubliée, un guillemet non fermé ou une directive mal écrite suffisent à tout bloquer.
Points à inspecter :
- Chaque ligne
ensurecorrespond à un dossier réellement présent dansresources/. - Les guillemets sont toujours fermés.
- Les
endpoint_add_tcpetendpoint_add_udpsont correctement définis. - Aucun caractère spécial parasite n’a été collé depuis un éditeur de texte.
5. Un port déjà utilisé ou fermé
FiveM utilise par défaut le port 30120 en TCP et UDP. Si ce port est déjà occupé par un autre processus, ou fermé par le pare-feu, le serveur ne pourra pas s’ouvrir aux joueurs.
Assurez-vous qu’aucun autre serveur ne tourne sur le même port, et que le pare-feu autorise bien le 30120 en entrée. Sur un hébergement géré, ce point est déjà pris en charge pour vous.
6. Une artifact obsolète ou corrompue
L’artifact, c’est la version du serveur FXServer que vous exécutez. Une version trop ancienne devient incompatible avec les frameworks récents ; une version corrompue lors d’un téléchargement interrompu provoque des plantages au lancement.
Téléchargez la dernière artifact recommended depuis le site officiel de Cfx.re et remplacez l’ancienne. Évitez les versions « latest » expérimentales pour un serveur en production.
7. Un problème de permissions ou de chemin
Si le serveur ne trouve pas ses fichiers, il échoue. Cela arrive souvent après un déplacement de dossier ou un mauvais chemin renseigné.
Vérifiez que le chemin vers le dossier resources/ et vers les données du serveur est correct, et que l’utilisateur qui exécute le serveur a bien les droits de lecture et d’écriture sur ces dossiers. Un chemin avec des accents ou des espaces peut aussi poser problème sur certaines configurations.
8. Le serveur crash après quelques secondes
Parfois le serveur démarre puis se ferme aussitôt. C’est généralement le signe d’un conflit entre scripts ou d’une ressource qui plante en boucle après le chargement.
Réactivez vos scripts par petits groupes plutôt que tous d’un coup : vous isolerez rapidement le conflit. Surveillez aussi la RAM : un serveur saturé est tué par le système. Un CPU à haute fréquence et une mémoire suffisante, comme sur notre hébergement FiveM, évitent une bonne partie de ces crashs.
En résumé
Un serveur FiveM qui ne démarre pas a presque toujours une cause unique et lisible dans la console : licence invalide, MySQL injoignable, script fautif, erreur de server.cfg, port bloqué, artifact obsolète, permissions ou conflit de scripts. Lisez le premier message d’erreur du haut, traitez les causes une par une, et désactivez vos scripts par petits lots pour isoler le coupable. Dans 90 % des cas, le diagnostic prend moins de cinq minutes.