Le message « Couldn't load resource … » au chargement veut dire que le jeu n’a pas réussi à télécharger ou à ouvrir un fichier de cette ressource. Si un seul joueur est touché, c’est le plus souvent son cache local abîmé : fermez FiveM et supprimez les dossiers server-cache et server-cache-priv dans %localappdata%\FiveM\FiveM.app\data. Si tout le monde est touché, la cause est côté serveur (fichier modifié pendant que la ressource tournait, proxy de fichiers, asset trop lourd) : lisez la fin du message, qui dit quelle étape a échoué.
Mise à jour : 15 novembre 2026
Ce que dit le message
À la connexion, le serveur envoie la liste de ses ressources avec l’empreinte attendue de chaque fichier. Le jeu télécharge ce qui lui manque en HTTP, le range dans son cache, contrôle l’empreinte et ouvre le fichier. Après plusieurs essais ratés, l’écran de chargement s’arrête sur un message de cette forme :
Couldn't load resource nom_de_la_ressource: Failed to open packfile: ReadBulk of header failed: Failed to fetch: …
La fin du message, après « Failed to fetch », indique l’étape qui a échoué :
- Failed to add entry to local storage (download corrupted?)
- Le fichier est arrivé mais n’a pas pu être rangé dans le cache : cache abîmé, disque plein, antivirus, ou contenu qui ne correspond pas à l’empreinte annoncée.
- Failure downloading <fichier>: HTTP 403, 404 ou 500
- Le serveur, ou un intermédiaire placé devant lui, a refusé le fichier : 404 pour un fichier introuvable, 403 pour un filtre ou un CDN qui bloque, 500 pour une erreur côté serveur.
- Une erreur de transfert
- Le téléchargement s’est coupé en route : connexion instable, VPN, proxy d’entreprise ou d’école.
Le détail de chaque tentative est dans la console F8 et dans les journaux CitizenFX_log_<date>.log de %localappdata%\FiveM\FiveM.app\logs : cherchez « ResourceCacheDevice reporting failure ».
Côté serveur, FXServer signale au démarrage chaque asset streamé qui prendra beaucoup de mémoire une fois chargé (exemple) :
Asset nom_de_la_ressource/fichier.ytd uses 52.3 MiB of physical memory. Oversized assets can and WILL lead to streaming issues (such as models not loading/rendering). Started resource nom_de_la_ressource (1 warning)
Les causes, de la plus fréquente à la plus rare
- Le cache du joueur est abîmé
- Un seul joueur touché, ou quelques-uns : téléchargement interrompu, disque plein, antivirus qui met un fichier du cache en quarantaine.
- Un fichier a changé pendant que la ressource tournait
- Tout le monde est touché, souvent juste après un envoi FTP ou un outil qui écrit dans le dossier. Le serveur annonce l’empreinte calculée au démarrage de la ressource, mais peut servir un fichier qui ne lui correspond plus.
- Un proxy ou un CDN de fichiers
- Les fichiers passent par un intermédiaire, réglé avec la commande
fileserver_addou par un reverse proxy. Mal configuré, il renvoie des erreurs HTTP ou des fichiers périmés. - Un fichier manquant ou abîmé sur le serveur
- Envoi FTP incomplet, fichier supprimé après le démarrage de la ressource. Sous Linux, une limite de fichiers ouverts trop basse peut aussi produire une erreur HTTP 500 qui mentionne « too many open files ».
- La connexion du joueur
- Wi-Fi instable, VPN, réseau filtré : le transfert se coupe avant la fin, à chaque essai.
- Des assets streamés trop lourds
- Ils ne bloquent pas toujours le chargement, mais allongent les téléchargements, multiplient les échecs et font planter les PC modestes. Détail dans la section suivante.
Ce qu’on a vu en production sur un grand serveur RP français : des fichiers générés directement dans le dossier d’une ressource en marche. Les empreintes ne correspondaient plus, les téléchargements échouaient, et même l’équipe ne pouvait plus se connecter.
Les assets streamés trop lourds (oversized assets)
FXServer lit dans l’en-tête de chaque fichier streamé (.ytd, .yft, .ydr, .ydd…) la mémoire qu’il occupera une fois chargé, en deux parts : « physical », surtout les textures et la géométrie destinées à la carte graphique, et « virtual », la mémoire système. C’est cette taille qui compte, pas le poids du fichier sur le disque. Les seuils, relevés dans le code source de FXServer :
- Plus de 16 Mio
- Une ligne d’avertissement au démarrage de la ressource.
- Plus de 32 Mio
- La même ligne, en jaune.
- Plus de 48 Mio
- La ligne ajoute que ces assets surdimensionnés provoqueront des problèmes de streaming, comme des modèles qui ne se chargent pas.
- Plus de 64 Mio
- La ligne passe en rouge.
La ressource démarre quand même. Mais chaque joueur charge ces fichiers dans la mémoire de son PC.
Sur le même serveur RP, on a trouvé des textures non compressées en 2048 et 4096 pixels, sans mipmaps : jusqu’à 64 Mo pour la texture d’une seule arme, et 245 fichiers au-dessus de 16 Mo. Les joueurs plantaient sur « Failed to call inflate() for streaming file » alors qu’aucun fichier n’était abîmé. C’est la mémoire de leur PC qui s’épuisait.
Pour alléger un pack :
- Compressez les textures en BC1 (DXT1) quand elles n’ont pas de transparence, en BC3 (DXT5) sinon, avec des dimensions en puissances de 2 et leurs mipmaps.
- Réduisez les textures de 4096 à 2048 ou 1024 pixels : en jeu, la différence se voit rarement.
- Vérifiez que les modèles ont de vrais niveaux de détail (LOD), et non une copie du modèle complet.
- Visez moins de 16 Mio par fichier, et relisez les lignes « Asset … uses … » à chaque ajout.
Corriger pas à pas
Côté joueur :
- Fermez complètement FiveM, y compris son icône dans la zone de notification.
- Ouvrez
%localappdata%\FiveM\FiveM.app\dataet supprimez les dossiersserver-cacheetserver-cache-priv. Ne touchez pas àgame-storage, qui contient des fichiers du jeu longs à retélécharger. - Vérifiez l’espace libre du disque, coupez le VPN, et si l’erreur revient, excluez le dossier de FiveM de l’analyse de l’antivirus.
- Reconnectez-vous : ce premier chargement retélécharge tout et prend plus de temps.
- Si l’erreur suit le joueur sur plusieurs serveurs, faites vérifier les fichiers de GTA V depuis son launcher.
Côté serveur, quand plusieurs joueurs sont touchés :
- Lisez la ressource nommée et la fin du message. Sur une erreur 404, vérifiez que le fichier existe dans le dossier de la ressource.
- Réinstallez la ressource en entier depuis son archive d’origine, plutôt que de recopier quelques fichiers.
- Ne modifiez jamais les fichiers d’une ressource qui tourne. Préparez la nouvelle version dans un autre dossier et copiez-la juste avant le redémarrage planifié : c’est au démarrage de la ressource que le serveur recalcule les empreintes.
- Si un proxy ou
fileserver_addsert vos fichiers, désactivez-le le temps d’un test. Une commande tapée dans la console n’apparaît dans aucun fichier de configuration : le journal des actions d’administration de txAdmin la garde. - Sous Linux, si l’erreur mentionne « too many open files », relevez la limite de fichiers ouverts (
ulimit -n) du processus du serveur. - Redémarrez au créneau prévu, annoncé aux joueurs, jamais à chaud avec du monde connecté.
Vérifier que c’est réglé et éviter le retour
Testez vous-même avec un cache vide, jusqu’à l’apparition du personnage. La console F8 ne doit plus montrer « ResourceCacheDevice reporting failure », et la console du serveur doit afficher Started resource sans avertissement pour vos packs streamés.
- Un ajout de pack par redémarrage : au premier souci, vous savez lequel retirer.
- Chaque pack streamé est contrôlé avant l’ajout : taille en mémoire, compression, LOD. Le refuser à l’entrée coûte moins cher que le retirer après une vague de crashs.
- Les nouveautés passent d’abord par le serveur de test, qui a sa propre clé et sa propre base.
- Chaque fichier remplacé est sauvegardé avec sa date, pour revenir en arrière en une copie.
La mise en place du serveur de test et l’ajout propre d’une ressource sont détaillés dans créer un serveur FiveM RP.
Questions fréquentes
- Faut-il vider tout le cache de FiveM ?
- Non. Supprimer
server-cacheetserver-cache-privsuffit : ces dossiers contiennent les fichiers téléchargés depuis les serveurs. Gardezgame-storage, long à retélécharger. - Pourquoi un seul joueur a l’erreur et pas les autres ?
- Parce que le problème est sur son PC : cache abîmé, disque plein, antivirus ou connexion. Quand le serveur est en cause, tous les joueurs qui téléchargent le fichier sont touchés.
- La limite de 16 Mo par fichier streamé est-elle bloquante ?
- Non. Au-delà de 16 Mio en mémoire, FXServer avertit au démarrage, plus fermement à partir de 48 Mio, mais la ressource démarre. Les joueurs en paient le prix : chargements longs, modèles absents, crashs.
- Redémarrer le serveur règle-t-il « Couldn't load resource » ?
- Oui si un fichier a changé pendant que la ressource tournait, car le redémarrage recalcule les empreintes. Non si le cache du joueur est abîmé ou si un proxy renvoie des erreurs.