Réparer un serveur FiveM qui ne démarre pas ou qui crash
Serveur FiveM qui refuse de démarrer ou qui plante en boucle ? Pas de panique. La console vous dit toujours pourquoi. Voici la méthode pour diagnostiquer et réparer.
Votre serveur FiveM ne démarre pas : commencez par la console
Lorsqu’un serveur FiveM ne démarre pas, la console contient généralement l’information nécessaire pour identifier la cause. L’erreur importante n’est pas forcément la dernière ligne affichée : recherchez plutôt le premier message d’erreur exploitable, car les lignes suivantes peuvent n’être que ses conséquences.
Depuis txAdmin, ouvrez la console en direct, puis redémarrez FXServer afin d’observer le lancement depuis le début. Pour prendre en main cette interface, consultez le guide pour démarrer avec txAdmin.
Recherchez notamment les messages contenant :
SCRIPT ERROR
Couldn't start resource
Couldn't find dependency
No such export
Access denied for user
Unknown database
Failed to load
License key
Notez le nom de la ressource affichée entre crochets. Par exemple :
[script:garage_entreprise] SCRIPT ERROR: ...
Le problème vient probablement de garage_entreprise ou d’une dépendance qu’il utilise.
Appliquez cette méthode de diagnostic :
- redémarrez le serveur ;
- relevez la première erreur ;
- identifiez la ressource concernée ;
- vérifiez sa documentation et ses dépendances ;
- corrigez un seul élément ;
- redémarrez et contrôlez le résultat.
Ne modifiez pas simultanément les artifacts, la base de données et plusieurs scripts. Vous ne sauriez plus quelle modification a corrigé ou aggravé le problème.
Avant toute intervention, des sauvegardes automatiques sont incluses pour vous aider à restaurer. Conservez aussi vos propres exports réguliers : vous restez responsable de vos données.
Erreur : une dépendance est manquante
De nombreux scripts dépendent d’une bibliothèque, d’un connecteur SQL ou d’un framework. Si cette ressource est absente ou démarre trop tard, FXServer peut refuser de charger le script.
Messages fréquents :
Couldn't find dependency ox_lib for resource mon_script
No such export MySQL in resource oxmysql
Couldn't find resource es_extended
No such export GetCoreObject in resource qb-core
Vérifiez d’abord que chaque dépendance se trouve dans resources/ et contient directement un fichier fxmanifest.lua.
Exemple correct :
resources/
├── [standalone]/
│ ├── oxmysql/
│ │ └── fxmanifest.lua
│ └── ox_lib/
│ └── fxmanifest.lua
└── [local]/
└── mon_script/
└── fxmanifest.lua
Contrôlez ensuite l’ordre des lignes dans server.cfg. Les dépendances doivent démarrer avant les scripts qui les utilisent.
Pour ESX :
ensure oxmysql
ensure ox_lib
ensure es_extended
ensure mon_script
Pour QBCore :
ensure oxmysql
ensure ox_lib
ensure qb-core
ensure mon_script
Une erreur de dépendance peut aussi venir d’un mauvais nom de dossier. Si le script recherche ox_lib, le dossier ne doit pas être renommé ox_lib-main ou ox_lib-v3.
Erreur : la version des artifacts est incompatible
Certains scripts exigent une version minimale de FXServer. Si vos artifacts sont trop anciens, la ressource peut utiliser une fonction indisponible ou refuser de démarrer.
Vous pouvez rencontrer des messages comme :
This resource requires a newer server artifact
Failed to load script
No such native
This server artifact is outdated
Relevez le numéro de build affiché au démarrage, puis comparez-le aux prérequis indiqués par le développeur du script. Pour la procédure complète, consultez le guide pour mettre à jour les artifacts FXServer.
Dans le panel TalCloud :
- arrêtez le serveur ;
- notez le numéro d’artifact actuel ;
- créez une sauvegarde ;
- sélectionnez de préférence le canal recommandé ;
- mettez à jour FXServer ;
- redémarrez et testez les ressources.
Ne choisissez pas automatiquement le build le plus récent sur votre serveur principal. Une version recommandée est généralement préférable en production, sauf lorsqu’un script ou un correctif exige explicitement un build plus récent.
Si le crash apparaît juste après une mise à jour, revenez temporairement à l’ancien numéro d’artifact. Vous pourrez ensuite mettre à jour les scripts incompatibles avant de retenter la migration.
Erreur : la licence Cfx.re est invalide
FXServer doit disposer d’une clé Cfx.re valide dans server.cfg.
La directive attendue est :
sv_licenseKey "cfxk_VOTRE_CLE"
Une clé absente ou incorrecte peut produire un message proche de :
This server does not have a license key specified
Vérifiez :
- que la ligne n’est pas précédée de
#; - que la clé est complète ;
- que les guillemets sont fermés ;
- que FXServer charge le bon
server.cfg; - que la clé est toujours active dans le portail Cfx.re ;
- qu’elle correspond à votre serveur et à votre compte.
Exemple incorrect :
# sv_licenseKey "cfxk_VOTRE_CLE"
Le caractère # transforme la ligne en commentaire. La clé n’est donc pas chargée.
Exemple correct :
sv_licenseKey "cfxk_VOTRE_CLE"
Ne publiez jamais votre clé Cfx.re dans une capture, un dépôt GitHub ou un message Discord. Si elle a été exposée, révoquez-la et générez-en une nouvelle. Pour tout savoir sur sa gestion, consultez le guide sur la licence Cfx.re.
Erreur : oxmysql ne se connecte pas
ESX, QBCore et de nombreux scripts RP dépendent d’une base MySQL. Si oxmysql ne peut pas s’y connecter, le framework peut démarrer partiellement, produire une succession d’erreurs ou rester inutilisable.
Messages fréquents :
Access denied for user
Unknown database
Unable to establish a connection
Table 'nom_base.users' doesn't exist
Vérifiez la chaîne de connexion placée avant ensure oxmysql :
set mysql_connection_string "mysql://UTILISATEUR:MOT_DE_PASSE@HOTE:3306/NOM_BASE?charset=utf8mb4"
ensure oxmysql
Chaque erreur oriente vers une cause précise :
| Message | Cause probable |
|---|---|
Access denied for user | Utilisateur, mot de passe ou autorisation incorrecte |
Unknown database | Nom de base erroné ou base inexistante |
Unable to establish a connection | Hôte, port, identifiants ou service MySQL indisponible |
Table ... doesn't exist | Fichier SQL non importé ou mauvaise base sélectionnée |
No such export ... oxmysql | Oxmysql absent, mal installé ou démarré trop tard |
Si le mot de passe contient des caractères réservés comme @, :, / ou #, utilisez leur encodage dans l’URL ou la syntaxe par paramètres :
set mysql_connection_string "user=fivem_user;password=MotDePasse;host=mysql.exemple.fr;port=3306;database=fivem"
Ne publiez jamais cette ligne avec de véritables identifiants. Pour une configuration détaillée, consultez le guide oxmysql et la base de données.
Erreur : un script fait crash le serveur
Lorsqu’un crash commence après l’installation ou la mise à jour d’une ressource, désactivez-la temporairement dans server.cfg.
Configuration active :
ensure nouveau_script
Configuration désactivée :
# ensure nouveau_script
Redémarrez ensuite le serveur. S’il fonctionne à nouveau, vous avez isolé le problème.
Lorsque plusieurs scripts ont été ajoutés simultanément, utilisez une méthode par élimination :
- désactivez la moitié des nouveaux scripts ;
- redémarrez ;
- observez si l’erreur persiste ;
- continuez avec le groupe fautif ;
- répétez jusqu’à identifier la ressource précise.
Vérifiez ensuite :
- sa compatibilité ESX, QBCore ou standalone ;
- ses dépendances ;
- son fichier SQL ;
- sa version minimale de FXServer ;
- les modifications demandées dans
server.cfg; - son fichier de configuration.
Évitez de supprimer directement les fichiers. Les commenter dans server.cfg facilite le retour arrière.
Erreur : server.cfg est mal écrit
Une faute de syntaxe peut empêcher une directive ou une ressource de fonctionner correctement.
Erreurs courantes :
ensur mon_script
ensure "mon script"
sv_licenseKey "cfxk_CLE
set mysql_connection_string mysql://user:pass@host/base
Utilisez des noms de ressources sans espaces :
ensure mon_script
Fermez toujours les guillemets :
sv_licenseKey "cfxk_VOTRE_CLE"
Placez les valeurs sensibles ou contenant des caractères spéciaux entre guillemets :
set mysql_connection_string "mysql://user:pass@host:3306/base"
Vérifiez également que le fichier chargé au démarrage est bien le bon :
+exec server.cfg
Dans txAdmin, contrôlez le chemin du profil et le fichier de configuration associé. Une modification peut être correcte mais sans effet si FXServer exécute un autre server.cfg.
En résumé
- Lorsqu’un serveur FiveM ne démarre pas, recherchez la première erreur exploitable dans la console txAdmin.
- Notez le nom de la ressource concernée avant de modifier la configuration.
- Vérifiez les dépendances et leur ordre dans
server.cfg. - Démarrez
oxmysql,ox_libet le framework avant leurs scripts dépendants. - Mettez à jour les artifacts lorsqu’une ressource exige un build plus récent.
- Revenez à l’ancien build si le crash commence juste après une mise à jour.
- Vérifiez la ligne
sv_licenseKeyet gardez votre clé Cfx.re privée. - Contrôlez la connection string oxmysql, le nom de la base et les tables SQL.
- Désactivez les scripts par groupes pour identifier une ressource fautive.
- Vérifiez les fautes dans
server.cfg, les guillemets et les lignesensure. - Corrigez un seul élément à la fois, puis redémarrez pour valider.
- Pour réparer et administrer votre serveur FiveM depuis un panel de gestion avec stockage NVMe, Anti-DDoS L3/L4/L7 inclus et support francophone, consultez l’offre serveur FiveM TalCloud.