Le message « Could not find dependency X for resource Y » veut dire que le manifeste de la ressource Y réclame une ressource X que le serveur n’a pas trouvée dans son dossier resources : Y ne démarre pas, et la ligne « Couldn't start resource Y » suit. Le plus souvent, X n’est pas installée, ou son dossier porte un autre nom, par exemple avec le suffixe -main d’une archive GitHub. Comparez le nom écrit dans le fxmanifest.lua de Y avec le nom exact de vos dossiers.
Mise à jour : 15 novembre 2026
Ce que dit le message
Au démarrage du serveur, ou après un ensure tapé en console, FXServer écrit deux lignes. La première nomme la dépendance introuvable, la seconde la ressource qui renonce à démarrer :
Could not find dependency ox_lib for resource ox_inventory. Couldn't start resource ox_inventory.
Le fxmanifest.lua d’une ressource déclare ses dépendances, par une ligne dependency ou un bloc dependencies. Avant de la lancer, le serveur cherche chacune d’elles parmi les dossiers de resources. Si une dépendance existe mais reste arrêtée, il la démarre lui-même ; si elle manque, il abandonne.
Trois messages voisins racontent autre chose :
- Could not start dependency
- La dépendance existe, mais elle a échoué à son tour. Remontez de quelques lignes : sa propre erreur s’y trouve.
- Resource '…' can't run:
- Aucune ressource ne manque. C’est le serveur qui ne remplit pas une condition : version, OneSync, build du jeu. Voir plus bas.
- Couldn't find resource
- La ligne
ensureduserver.cfgvise un nom qu’aucun dossier ne porte.
Les causes, de la plus fréquente à la plus rare
- La dépendance n’est pas installée. Le README d’un script liste ce qu’il réclame, et on s’arrête souvent au script lui-même. Une mise à jour partielle produit le même effet : les versions récentes d’ESX déclarent
esx_libcomme dépendance d’es_extended, et copieres_extendedseul ne suffit plus. - Le dossier porte un autre nom. Pour FXServer, le nom d’une ressource est celui de son dossier. Le bouton « Code » de GitHub produit
ox_lib-main, un téléchargement en doubleox_lib (1). Une extraction Windows crée parfois un dossier dans le dossier : la console signale alors que la ressourcedoes not have a resource manifest (fxmanifest.lua). - La ressource a été ajoutée serveur allumé. Le serveur ne relit le dossier
resourcesqu’au démarrage ou sur la commanderefresh. - Les crochets sont mal compris. Un dossier entre crochets, comme
[ox], est une catégorie qui range des ressources, jamais une ressource. Unfxmanifest.luaposé directement dans[ox_lib]déclenche l’avertissementis a category, but has a resource manifest, etox_libreste introuvable. - Le manifeste réclame une ressource que vous n’utilisez pas : script écrit pour une autre base, ou ancienne bibliothèque SQL comme
mysql-async. - La dépendance est une condition sur le serveur, écrite avec une barre oblique :
/server:12913,/onesync. Une section lui est consacrée plus bas.
L’ordre des ensure ne figure pas dans cette liste. Une dépendance déclarée est démarrée par le serveur au bon moment, quelle que soit sa place dans le server.cfg. L’ordre compte pour les scripts qui utilisent une autre ressource sans la déclarer : ceux-là ne produisent pas ce message, mais une erreur Lua No such export … in resource … en jeu. D’où l’habitude de garder oxmysql, les bibliothèques et le framework en tête, comme dans notre guide pour créer un serveur FiveM RP.
Corriger, cause par cause
- Dépendance absente
- Installez-la depuis sa source officielle, dans la version que demande le README. Sur GitHub, prenez l’archive de la page Releases plutôt que le bouton « Code » : certaines ressources, dont
oxmysql, ne fonctionnent qu’une fois compilées, et seule l’archive Releases l’est. Mettez à jour un framework d’un bloc, avec toutes les ressources qu’il livre. - Dossier mal nommé
- Renommez-le exactement comme le manifeste l’écrit :
ox_lib, pasox_lib-main. Vérifiez quefxmanifest.luase trouve directement dans ce dossier, pas un niveau plus bas. - Ajout à chaud
- Tapez
refreshdans la console, puisensuresuivi du nom. Sur un serveur ouvert, attendez plutôt le redémarrage planifié. - Crochets
- Réservez-les aux dossiers qui contiennent des ressources. Après
ensure, écrivez le nom du dossier de la ressource, jamais un chemin :ensure ox_lib, même si le dossier se trouve dans[ox].ensure [ox]démarre toute la catégorie. - Dépendance inutile
- Avant de toucher au manifeste, cherchez si une ressource installée fournit déjà ce nom avec la clé
provide.oxmysqlfournitmysql-asyncetghmattimysql,qbx_corefournitqb-core: ces dépendances-là sont satisfaites. Ne supprimez une lignedependencyque si le code n’appelle jamais la ressource (cherchez son nom dans lesexportset les chemins@nom/). Sinon, vous troquerez ce message contre un plantage en jeu.
Quand la dépendance est une version du serveur
Une entrée qui commence par une barre oblique ne désigne pas une ressource : c’est une exigence envers le serveur. Le message change alors de forme et numérote ce qui manque :
Resource 'oxmysql' can't run: 1. server needs to be 12913 or higher Couldn't start resource oxmysql.
Le cas est réel : la version 2.14.3 d’oxmysql, sortie en octobre 2026, exige un serveur de build 12913 au moins. Sur des artifacts plus anciens, elle refuse de démarrer, puis chaque ressource qui en dépend affiche Could not start dependency oxmysql for resource ….
- /server:…
- Message
server needs to be … or higher. Vos artifacts sont trop anciens : installez la version marquée « recommended » sur la page des artifacts de Cfx.re. Votre build actuel figure dans le champserverde l’adressehttp://votre-ip:30120/info.json. - /onesync
- Message
onesync: OneSync needs to be enabled. Sous txAdmin, OneSync se règle dans Settings, onglet FXServer, et txAdmin met en commentaire toute ligneset onesyncduserver.cfg. Sans txAdmin, ajoutezset onesync on. - /gameBuild:…
- Le message commence par
gameBuild. Fixez ou relevezsv_enforceGameBuild, sur le serveur de test d’abord : changer de build sur un serveur ouvert touche aux personnages des joueurs. - /native:…
- Message
native 0x… isn't supported. Vos artifacts ne connaissent pas cette fonction du jeu : mettez-les à jour.
Vérifier que c’est réglé
- Redémarrez le serveur entier depuis txAdmin, pas la seule ressource : vous verrez la séquence de démarrage complète.
- Cherchez dans la console
Could not,Couldn't,can't run,does not have a resource manifestetexists in more than one place. Ce dernier avertissement signale deux dossiers du même nom : un seul est chargé, peut-être l’ancien. - Vérifiez que la ligne
Started resourceapparaît pour la ressource corrigée et pour chacune de ses dépendances. - Testez en jeu la fonction qui en dépend : un inventaire qui s’ouvre, un menu qui répond.
Éviter que l’erreur revienne
- Une ressource ajoutée par redémarrage, sur le serveur de test d’abord. Au premier échec, vous savez laquelle accuser.
- La liste des dépendances lue avant le téléchargement, et une note des versions installées.
- Aucun dossier renommé pour faire joli : d’autres manifestes l’appellent par son nom.
- Pas de redémarrage à chaud d’une ressource dont d’autres dépendent : le serveur arrête aussi celles qui la déclarent, et un
restartne les relance pas.
Ce qu’on a vu en production sur un grand serveur RP français : un fichier d’objets de l’inventaire, cassé par une fusion git mal résolue, a empêché l’inventaire de démarrer. Une dizaine de ressources qui en dépendaient ont suivi, et la recherche est d’abord partie vers la mauvaise. Quand plusieurs scripts tombent ensemble, remontez la console jusqu’à la toute première erreur.
Autre cas vécu : un ensure visait une ressource de modèles absente du serveur. La ligne Couldn't find resource, perdue parmi des centaines d’autres, est passée inaperçue, et la boutique a vendu des modèles introuvables en jeu. Relisez aussi les lignes jaunes après chaque démarrage.
Si vous préférez ne pas gérer ce socle vous-même, GeoBase fournit une base RP hébergée dont les ressources de base arrivent installées et réglées.
Questions fréquentes
- Que veut dire « Couldn't start resource » sur FiveM ?
- Le serveur a tenté de démarrer la ressource et y a renoncé. La raison est écrite juste au-dessus : dépendance introuvable, dépendance qui a échoué, ou condition du serveur non remplie.
- Faut-il placer les dépendances avant dans le server.cfg ?
- Pas celles que le manifeste déclare : le serveur les démarre lui-même. L’ordre compte pour les scripts qui utilisent une ressource sans la déclarer, d’où l’habitude de mettre
oxmysql, les bibliothèques et le framework en tête. - Pourquoi l’erreur apparaît-elle après un téléchargement sur GitHub ?
- Le bouton « Code » donne un dossier suffixé
-main, que le serveur prend pour un autre nom, et parfois du code source pas encore compilé. Renommez le dossier, ou prenez l’archive de la page Releases. - Peut-on supprimer la ligne dependency du fxmanifest ?
- Seulement si le script n’appelle jamais la ressource en question. Sinon le démarrage passe, mais le script plante en jeu au premier appel.