Dépannage

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 ensure du server.cfg vise 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_lib comme dépendance d’es_extended, et copier es_extended seul 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 double ox_lib (1). Une extraction Windows crée parfois un dossier dans le dossier : la console signale alors que la ressource does not have a resource manifest (fxmanifest.lua).
  • La ressource a été ajoutée serveur allumé. Le serveur ne relit le dossier resources qu’au démarrage ou sur la commande refresh.
  • Les crochets sont mal compris. Un dossier entre crochets, comme [ox], est une catégorie qui range des ressources, jamais une ressource. Un fxmanifest.lua posé directement dans [ox_lib] déclenche l’avertissement is a category, but has a resource manifest, et ox_lib reste 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, pas ox_lib-main. Vérifiez que fxmanifest.lua se trouve directement dans ce dossier, pas un niveau plus bas.
Ajout à chaud
Tapez refresh dans la console, puis ensure suivi 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. oxmysql fournit mysql-async et ghmattimysql, qbx_core fournit qb-core : ces dépendances-là sont satisfaites. Ne supprimez une ligne dependency que si le code n’appelle jamais la ressource (cherchez son nom dans les exports et 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 champ server de l’adresse http://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 ligne set onesync du server.cfg. Sans txAdmin, ajoutez set onesync on.
/gameBuild:…
Le message commence par gameBuild. Fixez ou relevez sv_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 manifest et exists 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 resource apparaî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 restart ne 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.

À lire ensuite