FiveM bloqué sur l'écran de chargement : causes et comment débouter

Les joueurs se connectent, la barre se remplit, puis rien : l'écran de chargement reste indéfiniment, ou le jeu gèle sur un écran noir. Ce guide passe en revue les causes dans l'ordre qui est le plus rapide à éliminer, et montre comment utiliser F8 et la console du serveur pour trouver celle que vous avez.

#D'abord : est-ce tout le monde ou un seul joueur ?

• Tout le monde est bloqué. La cause est sur le serveur : une ressource, le framework, ou un loadscreen.
• Un seul joueur est bloqué. Regardez le client de ce joueur : cache, une connexion lente, des mods, ou une vieille version du jeu. Commencez par effacer le cache FiveM.

Rejoignez une fois vous-même et appuyez sur F8. Cela fonctionne aussi sur l'écran de chargement. Lisez ce qui est imprimé là, et gardez la console du serveur ouverte de l'autre côté.

#1. Une erreur de script sur le client

F8 liste les erreurs client. N'importe quelle ligne comme celle-ci lors du chargement est un indice fort :

SCRIPT ERROR: @my_script/client/main.lua:25: attempt to index a nil value (global 'ESX')

Un script client qui plante dans son thread de démarrage peut laisser le flux de spawn inachevé. Corrigez le script nommé dans l'erreur : les guides pour lire une erreur de script, ESX nil et QBCore nil couvrent les courantes. Redémarrez ensuite la ressource et rejoignez.

Testez par élimination si rien n'est imprimé : arrêtez la ressource la plus récemment ajoutée ou modifiée, rejoignez, et voyez si le chargement se termine.

#2. Personne ne spawn le joueur

Après le chargement, quelque chose doit spawner le joueur et éteindre l'écran de chargement. Habituellement :

• spawnmanager le fait sur un serveur simple.
• Le multicharacter et le sélecteur de spawn d'un framework le font sur ESX et QBCore.

Vérifiez que ces ressources démarrent, dans le bon ordre, et que seul un d'entre eux traite du spawning. Un conflit typique est un spawnmanager par défaut qui auto-spawn le joueur pendant qu'une ressource multicharacter veut aussi le faire. Assurez-vous que les ressources de base sont démarrées avant le framework, comme dans l'ordre des ressources correct :

ensure oxmysql
ensure ox_lib
ensure es_extended        # or qb-core / qbx_core
ensure spawnmanager
ensure esx_multicharacter # or qb-multicharacter / qbx_core's own

Si une ressource multicharacter stagne, cherchez dans la console du serveur une erreur de base de données : le chargement des caractères lit la base de données, et une erreur SQL laisse le joueur en attente. Consultez erreur de connexion oxmysql et la table SQL n'existe pas.

#3. Un loadscreen personnalisé qui ne ferme jamais

Les loadscreens serveur sont des ressources déclarées dans leur manifeste :

fx_version 'cerulean'
game 'gta5'

loadscreen 'html/index.html'
loadscreen_manual_shutdown 'yes'

files { 'html/**/*' }

Avec loadscreen_manual_shutdown 'yes', FiveM ne ferme pas le loadscreen de son propre chef. Un script client doit le faire, en appelant les natives de shutdown une fois que le joueur est prêt :

ShutdownLoadingScreen()
ShutdownLoadingScreenNui()

Si une ressource loadscreen a l'option d'arrêt manuel et personne n'appelle celles-ci, l'écran reste indéfiniment. Soit supprimez loadscreen_manual_shutdown, soit assurez-vous que votre flux de spawn les appelle. Testez en arrêtant la ressource loadscreen et en rejoignant.

Un loadscreen qui est cassé, qui charge un fichier externe inaccessible, ou qui joue une très grande vidéo peut aussi bloquer ou ralentir l'écran. Gardez-le léger et local.

#4. Streaming volumineux et téléchargements

La jonction télécharge tous les fichiers en streaming que le joueur n'a pas encore. Un serveur avec de nombreux grands véhicules, cartes et packs de vêtements peut prendre des minutes lors de la première connexion, et l'écran de chargement ne montre rien se passer si le téléchargement est lent. Signes :

• Le F8 ou l'écran de chargement affiche les téléchargements en cours.
• Ça fonctionne pour les joueurs qui reviennent mais pas pour les nouveaux.
• Le problème s'aggrave après que vous ayez ajouté un pack d'actifs.

Correctifs : réduisez la taille et le nombre d'actifs en streaming (consultez actifs surdimensionnés), hébergez le serveur sur une connexion avec suffisamment de bande passante, et demandez aux joueurs d'attendre la fin du premier téléchargement.

#5. Problèmes de version du jeu ou du serveur

Si le serveur force une version du jeu, un joueur sur une version plus ancienne ou différente peut ne pas réussir à rejoindre proprement. Vérifiez sv_enforceGameBuild dans server.cfg par rapport au DLC dont vos actifs ont besoin. Consultez sv_enforceGameBuild. Un artefact de serveur obsolète peut aussi causer des jonctions bizarres : mettez à jour vos artefacts FiveM.

#6. Le framework ne charge pas le personnage

Les joueurs spawn, mais le framework ne finit jamais de charger le joueur. Dans la console du serveur, cherchez :

• une erreur de base de données lors du chargement du joueur ou du personnage
• une erreur de es_extended, qb-core ou qbx_core sur l'événement player-loaded
• un script qui accroche cet événement et lance, arrêtant d'autres gestionnaires

Si vous voyez une erreur là, corrigez-la, et rejoignez. Un inventaire cassé ou un script de travail cassé peuvent aussi échouer dans le flux player-loaded, donc vérifiez d'abord les plus récemment ajoutés.

#Une routine de débogage

1. Rejoignez et appuyez sur F8. Notez chaque erreur.
2. Lisez la console du serveur pendant la jonction.
3. Arrêtez la ressource la plus récemment modifiée, rejoignez.
4. Arrêtez la ressource loadscreen, rejoignez.
5. Toujours bloqué pour tout le monde : commencez avec seulement les ressources de base et rajoutez le reste en groupes.

Conseil : si vous ajoutez des ressources en groupes de cinq ou dix, vous trouvez la mauvaise avec quelques redémarrages au lieu de tester 80 ressources une par une.

#Liste de contrôle