Resource FiveM qui ne démarre pas : corriger l'erreur selon le message de la console

Une resource FiveM ne démarre pas lorsque le serveur ne la trouve pas, ne peut pas lire son manifeste, la lance avant l'une de ses dépendances, rencontre une erreur Lua ou refuse l'accès faute de droit d'utilisation (entitlement). Repérez la première erreur qui mentionne la resource, puis utilisez la section correspondante ci-dessous.

Les messages ne sont cités que lorsqu'une page Cfx.re, la documentation d'un framework ou d'une bibliothèque, la documentation d'un vendeur ou un message du forum Cfx.re les montre ; la source est indiquée à côté de chacun. Lorsqu'aucun message exact n'a pu être vérifié, la section le précise. Il s'agit d'une revue de documentation datée du 2026-10-13, pas d'un test pratique : rien de tout cela n'a été reproduit sur un serveur.

Commencez par lire la console

1. Redémarrez le serveur et cherchez le nom de la resource dans la console du serveur (ou dans la Live Console de txAdmin, voir Comment trouver et lire les logs txAdmin).
2. Prenez la première erreur qui la mentionne. Les lignes suivantes sont souvent des conséquences : une dépendance en échec fait échouer toutes les resources qui en ont besoin.
3. Copiez cette ligne avec le chemin du fichier et le numéro de ligne, et notez la version de la resource, le framework, le numéro d'artifact FXServer et l'édition de GTA V.

Le testeur de scripts FiveM propose un explicateur d'erreurs qui s'exécute dans votre navigateur ; masquez les clés de licence et les adresses IP avant de partager un log.

Quel message voyez-vous ?

Vous voyez	Cela indique	Source
Couldn't find resource	Le dossier ou le manifeste n'est pas là où le serveur le cherche	Fil du forum Cfx.re
does not specify an `fx_version` in fxmanifest.lua puis Couldn't start resource ...	Version du manifeste absente ou non prise en charge	Fil du forum Cfx.re
Could not start dependency X for resource Y.	La resource X a échoué en premier	Même fil
No such export ... in resource ...	Le fournisseur ne tourne pas, démarre plus tard, ou le nom de l'export est faux	Documentation ox_inventory
Error parsing script / Error loading script / Failed to load script	Erreur de syntaxe Lua ou erreur au chargement	Forum, forum
You lack the required entitlement	La clé du serveur et le propriétaire de la resource ne correspondent pas	Documentation Asset Escrow
Native XXXXXXXX is not supported	Artifact de serveur obsolète	Documentation ESX

1. Le serveur ne trouve pas la resource

Signification : l'introduction au scripting de Cfx.re indique qu'une resource a besoin d'un manifeste pour être détectée. Sans dossier portant ce nom et contenant un fxmanifest.lua lisible, il n'y a rien à démarrer.

Vérification : listez le chemin. Vous voulez resources/[optional_group]/resource_name/fxmanifest.lua. Les archives zip peuvent se décompresser en resource_name/resource_name/fxmanifest.lua. Comparez le nom placé après ensure avec le nom du dossier, y compris -, _ et, sous Linux, la casse. Pour un dossier ajouté pendant que le serveur tourne, refresh réanalyse resources et charge les manifestes (commandes du serveur).

Correction : remontez le dossier intérieur d'un niveau, corrigez le nom, lancez refresh, puis ensure resource_name. Si toutes vos resources personnalisées sont introuvables alors que celles par défaut fonctionnent, vérifiez aussi l'envoi : dans le fil du forum cité plus haut, l'auteur a indiqué que changer de client FTP (de WinSCP à FileZilla) avait réglé le problème, sans savoir pourquoi. C'est une anecdote isolée, et les documentations de vendeurs citées dans la section 5 rapportent l'inverse pour les fichiers protégés (FileZilla les corrompt). Renvoyer l'archive et la décompresser sur le serveur est le test le plus sûr.

2. Le manifeste est absent, incorrect ou trop récent

Signification : la référence du manifeste indique qu'une resource doit préciser une version de manifeste, et que celles qui n'en ont pas reçoivent actuellement une valeur par défaut dont la suppression est prévue. Elle liste cerulean, bodacious et adamant comme valeurs de fx_version, ainsi que gta5 et rdr3 parmi les valeurs de game.

Vérification : ouvrez fxmanifest.lua et vérifiez qu'il contient fx_version et game. Dans le fil du forum, les réponses se contredisent : l'une dit que la valeur bodacious nécessite une version de serveur plus récente (elle a été ajoutée en 2207), une autre conseille de télécharger le dernier artifact, et une troisième a obtenu la même erreur sur toutes les versions. Considérez un artifact obsolète comme une cause possible. Vérifiez aussi que chaque fichier listé dans client_script, server_script, shared_script et files existe. Je n'ai pas trouvé de source Cfx.re pour le message exact produit par un fichier listé manquant ; confirmez donc en comparant le manifeste avec le contenu du dossier.

Correction : restaurez le manifeste d'origine du téléchargement, ou mettez l'artifact à jour. Pour en écrire un : Comment écrire et vérifier un fxmanifest.lua FiveM.

3. Une dépendance n'a pas démarré

Signification : la directive dependency du manifeste exige que la resource nommée soit chargée avant la resource actuelle. Dans le fil du forum, le log montre la dépendance en échec avec son propre avertissement, suivi de Could not start dependency essentialmode for resource esplugin_mysql. La resource dépendante n'est que le symptôme.

Vérification : remontez jusqu'à la première erreur concernant la dépendance et lisez-la. Vérifiez ensuite que la dépendance est bien démarrée par ensure dans server.cfg (par convention au-dessus de votre resource) et que le nom indiqué dans le manifeste correspond au nom du dossier de la dépendance.

Correction : réparez la dépendance ; voir les autres sections pour son message. Références sur l'ordre de démarrage : QBCore, ESX, Qbox et Configurer le server.cfg de FiveM et vérifier vos modifications.

4. No such export

Signification : la documentation d'ox_inventory énumère trois causes probables pour No such export * in resource ox_inventory : une erreur s'est produite au démarrage d'ox_inventory ou d'une dépendance comme ox_lib ; la resource appelante démarre avant ox_inventory ; ou l'export appelé n'existe pas. Le même schéma, no such export getPlayerData in resource mumble-voip, apparaît dans un fil du forum Cfx.re resté sans réponse.

Vérification : (1) la resource nommée a démarré sans erreur, (2) sa ligne ensure est au-dessus de celle de l'appelant, (3) le nom de l'export dans l'appelant correspond au code et au manifeste du fournisseur. La page du runtime Lua ajoute que les exports de manifeste ne deviennent disponibles qu'après le premier tick du scheduler ; un code qui en appelle un très tôt est donc suspect.

Correction : corrigez d'abord l'erreur du fournisseur lui-même, puis l'ordre, puis le nom. Ne créez jamais un export vide pour faire taire la ligne.

5. Erreurs Lua au chargement d'un script

Deux formes apparaissent dans les fils du forum : Error parsing script ... in resource ...: ... unexpected symbol (le fichier ne peut pas être analysé) et Error loading script ... in resource ...: ... attempt to index a nil value (global 'ESX') (le fichier a été analysé, puis a échoué à l'exécution), généralement suivies chacune de Failed to load script ....

• Objet de framework nil. Dans le fil es_extended, Failed to load script @es_extended/imports.lua s'accompagnait de global 'ESX' valant nil. Les réponses suggéraient de vérifier comment le manifeste inclut imports.lua et d'utiliser une version plus récente d'ESX ; le fil n'enregistre aucune correction confirmée. Vérifiez que le framework démarre en premier et que le script cible bien la version du framework que vous utilisez.
• Erreur d'analyse près d'un octet étrange. Le fil Config montre unexpected symbol near '<\239>' dans config.lua, puis global 'Config' valant nil dans server/main.lua. Le fil ne donne aucune explication. Mon interprétation, pas une cause documentée : \239 est la valeur décimale de 0xEF, le premier octet d'une marque d'ordre des octets (BOM) UTF-8, et la seconde erreur semble être une conséquence de la première. Réenregistrez le fichier en UTF-8 sans BOM, puis testez à nouveau.
• Une erreur de syntaxe dans un fichier que vous n'avez jamais modifié. Les documentations de vendeurs (Lation, JG Scripts) listent syntax error near <\1> pour les fichiers protégés et l'associent à des correctifs concernant des transferts corrompus ou incomplets et des serveurs obsolètes. Renvoyez l'archive d'origine, décompressez-la sur le serveur et mettez l'artifact à jour.

Correction : allez au fichier et à la ligne indiqués dans le premier message, comparez avec votre sauvegarde et annulez votre dernière modification des fichiers de config ou d'items. Ne modifiez pas les fichiers protégés.

6. La base de données n'est pas connectée

Je n'ai pas pu vérifier de message d'échec universel pour oxmysql ; cherchez donc la première erreur de base de données affichée par oxmysql ou par le script. La documentation d'oxmysql indique de définir mysql_connection_string avec set (« only ever use set ») avant de démarrer les resources, de démarrer oxmysql tout en haut, et d'éviter ; , / ? : @ & = + $ # dans les valeurs de connexion, car ils peuvent ne pas être pris en charge. La page de dépannage d'ESX mentionne « ESX Multicharacter couldn't connect to the database » et l'attribue à une chaîne de connexion erronée dans server.cfg ou à une connexion à la base de données qui ne fonctionne pas.

Vérification : le serveur de base de données tourne, les identifiants fonctionnent dans un outil de base de données, et les tables dont le script a besoin existent. Détails : fichiers SQL et erreurs de base de données et Migrer en toute sécurité les resources mysql-async vers oxmysql.

7. Asset Escrow et la clé du serveur

Selon la documentation Asset Escrow, une resource sans droit d'utilisation ne démarre pas et la console affiche You lack the required entitlement. Les documentations de vendeurs ajoutent que la resource est liée au compte Cfx.re qui la possède, que la clé d'enregistrement du serveur doit donc provenir de ce compte, et qu'un redémarrage complet peut être nécessaire après la première installation. Un autre message documenté par des vendeurs est [svadhesive] Failed to verify protected resource ..., que les vendeurs rattachent à des redémarrages incomplets, des envois corrompus ou un fichier .fxap manquant. Étapes : Comment corriger l'erreur FiveM « Required Entitlement » et Qu'est-ce qu'un fichier .fxap dans une resource FiveM ?

8. Incompatibilité entre Legacy et Enhanced

Je n'ai trouvé aucun message d'erreur documenté propre à une incompatibilité d'édition. La comparaison de Cfx.re documente des différences susceptibles d'empêcher une resource de fonctionner : certains fichiers serveur Enhanced portent un autre nom (par exemple cfx-server.exe au lieu de FXServer.exe), les resources peuvent fournir stream_enhanced à côté de stream, et Asset Escrow est indiqué comme pas encore implémenté pour Enhanced. Si vous utilisez Enhanced, vérifiez que le créateur prend en charge cette version précise ; voir FiveM Standard vs Enhanced : quelle version choisir ?

À envoyer au support

La première ligne d'erreur, le nom et la version de la resource, le framework et sa version, le numéro d'artifact, l'édition, et les lignes concernées de server.cfg sans clés ni mots de passe. Voir erreurs de démarrage et ce dont le support a besoin.

FAQ

Que signifie « Couldn't start resource » dans FiveM ?

C'est le serveur qui indique que la resource n'a pas démarré. La raison se trouve dans les lignes qui précèdent, par exemple un avertissement sur le manifeste. Lisez la première erreur qui nomme la resource.

Qu'est-ce qui provoque « No such export » ?

La resource qui fournit l'export n'a pas démarré, a démarré après l'appelant, ou ne possède pas cet export. La documentation d'ox_inventory énumère ces trois causes.

Que signifie « Failed to load script » ?

Un fichier n'a pas pu être chargé. Les lignes d'erreur autour de celle-ci nomment le vrai problème, par exemple une erreur de syntaxe ou un objet de framework nil. Corrigez cette erreur, pas la ligne générique.

L'ordre des lignes ensure a-t-il de l'importance ?

Oui, lorsque des resources dépendent les unes des autres : démarrez une resource après son framework, ses bibliothèques et toute resource dont elle appelle les exports (la documentation d'ox_inventory liste un ordre de démarrage pour cette raison).