Une ressource refuse de démarrer et la console affiche `Couldn't find resource` ou `Couldn't start resource` ? Ces erreurs ont des causes simples, à condition de lire le message qui les suit.
1. Couldn't find resource
Le serveur ne trouve pas de dossier au nom indiqué dans `ensure`. Vérifiez dans cet ordre :
- le nom exact du dossier : sous Linux, `esx_menu` et `ESX_Menu` sont deux noms différents ;
- son emplacement, dans `resources` ou un sous-dossier entre crochets comme `[esx]` ;
- l'absence de dossier imbriqué après décompression : `ma_ressource/ma_ressource/fxmanifest.lua` est une erreur fréquente.
2. Couldn't start resource
Le dossier est trouvé, mais la ressource ne peut pas démarrer. Lisez la ligne suivante dans la console : elle donne la vraie raison. Les causes habituelles :
- un `fxmanifest.lua` absent, mal nommé ou invalide : vérifiez `fx_version`, `game` et les chemins des fichiers ;
- une erreur de syntaxe dans un script ;
- un script incompatible avec votre build du serveur.
3. Dépendance manquante
Un message comme `Could not find dependency` signifie qu'une ressource en réclame une autre. Installez-la, puis démarrez-la avant : l'ordre des lignes `ensure` compte. Mettez d'abord `oxmysql`, puis le framework, puis le reste.
4. Deux dossiers au même nom
Si deux dossiers portent le même nom, le serveur peut charger le mauvais. Après une mise à jour, vérifiez qu'il ne reste pas une ancienne copie dans un autre sous-dossier.
5. Trouver la ressource fautive
Si plusieurs erreurs s'enchaînent, partez de la première : les suivantes en découlent souvent. Pour isoler un problème, commentez la moitié de vos `ensure`, redémarrez, puis recommencez sur la moitié qui pose problème. Trois ou quatre essais suffisent en général.
Après la correction
Gardez une copie du dossier et de la base avant chaque ajout de ressource. Si le serveur démarre mais rame, voyez combien de RAM prévoir. Sur un serveur FiveM Rvhhost, txAdmin affiche la console et l'état de vos ressources.
Questions fréquentes
Que signifie « Couldn't find resource » sur FiveM ?+
Le nom indiqué dans ensure ne correspond à aucun dossier trouvé. Vérifiez le nom exact, les majuscules et l'emplacement du dossier.
Pourquoi une ressource FiveM ne démarre pas ?+
Lisez la ligne qui suit l'erreur dans la console. Les causes courantes sont un fxmanifest.lua invalide, une dépendance manquante ou un script incompatible avec votre build.
Dans quel ordre mettre les ensure ?+
Démarrez d'abord les dépendances comme oxmysql, puis le framework, puis les autres ressources.