Écran de chargement infini FiveM : diagnostic et correctifs

Lorsque FiveM reste sur un écran de chargement, déterminez d'abord si la panne affecte un client, un serveur ou tous les joueurs après un changement de ressource. Conservez le texte exact de l'écran et l'erreur de la console, testez un serveur dont le fonctionnement est connu et modifiez une cause réversible à la fois. Ne commencez pas par des convars de sécurité non documentés ou une suppression globale des données de l'application et du serveur.

Classez la panne avant de modifier les fichiers

Portée observée	Commencez ici
Un joueur, plusieurs serveurs	Processus client, problème client officiel, installation GTA/FiveM et diagnostic du cache local.
Un joueur, un serveur	Erreur F8, chemin de connexion et la première ressource ou le premier téléchargement qui échoue pour ce client.
Chaque joueur sur un serveur	Console FXServer/txAdmin, déploiement récent, démarrage des ressources et état de la base de données/dépendances.
Uniquement après la modification d’un écran de chargement personnalisé	Manifeste de l'écran de chargement, console du navigateur et cycle de vie d'arrêt manuel.

Vérifications côté joueur

1. Enregistrez le serveur exact, l'heure, le texte de chargement et toute erreur visible.
2. Appuyez sur F8 et capturez la première erreur pertinente plutôt que les lignes répétées qui la suivent. Cfx.re documente F8 dans sa référence de la console client.
3. Essayez un autre serveur connu pour fonctionner. Si cela échoue également, suivez les instructions exactes actuelles du guide des problèmes client Cfx.re.
4. Redémarrez FiveM et Windows une fois pour libérer les processus bloqués.
5. Si des preuves suggèrent des ressources serveur mises en cache, utilisez la procédure réversible décrite dans le guide du cache FiveM. Ne supprimez pas l'intégralité du répertoire application-data.

Vérifications du propriétaire du serveur

1. Gelez les déploiements et exportez le journal FXServer/txAdmin pertinent autour d'une connexion échouée.
2. Vérifiez si le problème a commencé immédiatement après une modification de ressource, d'artefact, de configuration ou de base de données.
3. Utilisez la console en direct et les contrôles de ressources de txAdmin pour identifier la première dépendance défaillante. txAdmin est inclus avec FXServer et ses fonctionnalités de surveillance actuelles sont documentées dans le guide officiel txAdmin.
4. Vérifiez les services requis et l'accès à la base de données sans afficher les identifiants.
5. Annulez la dernière modification effectuée ou désactivez uniquement la ressource isolée sur une instance de développement.

Vérifier le démarrage des ressources et les dépendances

Une ressource peut bloquer l'intégration si elle attend indéfiniment un export, un résultat de base de données, un objet de framework ou un événement client. Vérifiez le journal du serveur pour les messages « could not find dependency », les erreurs d'analyse et les délais d'attente. Rendez l'ordre de démarrage explicite avec dependency dans fxmanifest.lua ou une ensure séquence ensure correcte ; ne masquez pas l'échec avec des pauses arbitraires.

Sur un serveur de développement, refresh re-scanne les manifestes et ensure resource-name démarre ou redémarre une ressource. Ces commandes sont définies dans la référence des commandes de serveur. Évitez de redémarrer une dépendance de production sans comprendre quelles sessions actives l'utilisent.

Échecs de l'écran de chargement personnalisé

Si le jeu est prêt mais qu'un écran personnalisé ne se ferme jamais, vérifiez si la ressource utilise loadscreen_manual_shutdown 'yes'. Ce mode nécessite qu'un script client appelle ShutdownLoadingScreenNui() après une condition de prêt réelle. Supprimez la directive d'arrêt manuel pour revenir au comportement automatique lors du débogage. Le cycle de vie et les événements de progression pris en charge sont documentés dans le guide de l'écran de chargement Cfx.re.

Évitez les corrections génériques non sécurisées

• Ne copiez pas de valeurs de sécurité non documentées sv_* sv_* d'un guide d'erreurs sans rapport.
• Ne désactivez pas la protection antivirus ou pare-feu de manière permanente.
• Ne supprimez pas une base de données en direct, le répertoire de données txAdmin ou une installation FiveM complète avant d'en avoir sauvegardé une copie.
• N'ajoutez pas de tentatives répétées côté client qui accordent des objets, de l'argent ou des permissions plus d'une fois.
• N'appelez pas un délai de chargement plus long une correction lorsque la ressource sous-jacente échoue toujours.

Vérifiez la réparation

Répétez la même connexion sur le client affecté, un deuxième client propre et après un redémarrage complet du serveur. Confirmez que la première erreur de console a disparu, que le joueur atteint un état utilisable, que les ressources requises ont démarré une fois et qu'aucune action d'autorisation ou d'inventaire en double n'a eu lieu. Conservez le rollback jusqu'à ce que le résultat survive au redémarrage.