Économisez 20 % avec WELCOMEVoir les promotions

Écran de chargement infini FiveM : guide de résolution complet

Les blocages de l'écran de chargement de FiveM surviennent lorsque la liaison client-serveur échoue, que les ressources dépassent la capacité de streaming ou que les chemins réseau bloquent le trafic UDP essentiel sur les ports 30110 à 30125. Ce guide fournit des diagnostics et des correctifs systématiques pour ces trois catégories de défaillances.

Diagnostic immédiat

Presse F8 pendant le blocage pour accéder à la console :

Connexion au serveur... Échange de données avec le serveur... Téléchargement du contenu...

La phase bloquée détermine le chemin de correction.


Portée

Couvertures : Délais d'attente réseau, échecs de diffusion de ressources, corruption du cache, boucles d'authentification
Exclut : Plantages de serveur, problèmes d'installation de jeu, pannes matérielles
Public cible : Administrateurs de serveur, développeurs de mods, utilisateurs avancés avec accès à la console

Indicateurs de réussite

  • Connexion établie en 60 secondes
  • Toutes les ressources chargées sans délai d'attente
  • La console n'affiche aucun AVERTISSEMENT: ou ERREUR: entrées
  • Le temps d'image reste <16 ms après le chargement

Outils requis

  • Accès administratif à Windows
  • Console F8 activée
  • Privilèges de diagnostic réseau
  • Éditeur de texte pour les fichiers de configuration

Passer à l'initiale Section Diagnostic pour une résolution étape par étape.

Diagnostics initiaux

1. Identifier l'étape de chargement

Appuyez sur F8 pour ouvrir la console pendant le chargement. Vérifiez :

Chargé @resourcename/client.lua (xxx ms) Démarrage de la ressource resourcename Création d'environnements de script pour resourcename

La dernière ressource chargée indique le point de défaillance.

2. Délai d'expiration de la connexion vs. Blocage des ressources

Tester la connexion directe :

connecter le serveur IP:port

Si l'opération réussit, le problème est lié au lanceur. Sinon, passez aux diagnostics réseau.

Surveiller le chargement des ressources :

-- Ajouter à la console client resmon 1

Les ressources utilisant > 50 ms indiquent des problèmes d'optimisation.

Solutions basées sur le réseau

1. Correction de la résolution DNS

netsh int ip set dns « Connexion au réseau local » statique 8.8.8.8 netsh int ip add dns « Connexion au réseau local » 8.8.4.4 index=2

2. Optimisation MTU

Trouver le MTU optimal :

ping -f -l 1472 google.com

Diminuez de 8 jusqu'à ce que vous réussissiez, puis définissez :

netsh interface ipv4 définir la sous-interface « Ethernet » mtu=1492 store=persistent

3. Exigences de redirection de port

Configuration du routeur :

  • TCP : 30120, 30110
  • UDP : 30120, 30110
  • Voix FiveM : UDP 30125

Corrections côté client

1. Désactiver les optimisations plein écran

$fivemPath = "$env:LOCALAPPDATAFiveMFiveM.appFiveM.exe" $bytes = [System.IO.File]::ReadAllBytes($fivemPath) [System.IO.File]::WriteAllBytes($fivemPath, $bytes) (Get-Item $fivemPath).Properties["Compatibility"].DisableFullscreenOptimizations = $true

2. Effacer des types de cache spécifiques

:: Cache spécifique au serveur uniquement pour /d %%i dans ("%localappdata%FiveMFiveM.appdataserver-cache*") faire rmdir /s /q "%%i" :: Conserver les privilèges mais effacer tout le reste déplacer "%localappdata%FiveMFiveM.appdatacachepriv" "%temp%priv_backup" rmdir /s /q "%localappdata%FiveMFiveM.appdatacache" mkdir "%localappdata%FiveMFiveM.appdatacache" déplacer "%temp%priv_backup" "%localappdata%FiveMFiveM.appdatacachepriv""

3. Reconstruction du cache des shaders

Supprimer le cache du shader DirectX :

rmdir /s /q "%localappdataDSCache"
rmdir /s /q "%localappdata%NVIDIADXCache"
rmdir /s /q "%localappdata%AMDDxCache"

Problèmes spécifiques au serveur

1. Problèmes de diffusion des ressources

Pour les serveurs avec des fichiers MLO/YMAP volumineux :

-- server.cfg réglage définir sv_streamingTickRate 120 définir adhesive_cdnKey "votre_clé_cdn" définir sv_requestParanoia 0

2. Délai d'authentification expiré

-- Augmenter le délai d'expiration de la connexion définir sv_endpointprivacy sur false définir sv_authMaxRetries sur 10 définir sv_authMinTrust sur 5

3. Conflits du système de file d'attente

Désactiver les ressources de file d’attente en conflit :

# Vérifier les systèmes de files d'attente multiples grep -r "deferrals" resources/

Gardez un seul système de file d'attente actif.

Débogage avancé

1. Analyse des traces de réseau

netsh trace start capture=yes tracefile=fivem.etl provider=Microsoft-Windows-TCPIP level=5 :: Tentative de connexion netsh trace stop

Analysez avec Message Analyzer pour détecter la perte de paquets.

2. Ordre de chargement des ressources

Créer __ressource.lua dans la ressource problématique :

dépendance 'baseresource'
client_script {
 '@baseresource/client.lua',
 'client.lua'
}

3. Problèmes d'allocation de mémoire

Pour les systèmes de 16 Go ou plus de RAM :

-- citizen.ini dans le dossier FiveM.app [Jeu] DisableOSVersionCheck=1 PatchLethalForce=1 HeapAdjust=2048

Corrections spécifiques à la plateforme

Version Steam :

reg add "HKLMSOFTWAREWow6432NodeRockstar GamesGTAV" /v "InstallFolder" /t REG_SZ /d "C:\Program Files (x86)\Steam\steamapps\common\Grand Theft Auto V" /f

Version Epic Games :

Supprimer %programdata%EpicEpicGamesLauncherDataManifests fichiers cache.

Lanceur Rockstar :

-vérifier -safemode

Prévention des dépassements de délai

1. Précharger les actifs localement

-- client.lua dans la ressource personnalisée
Citizen.CreateThread(function()
 RequestModel(`prop_cs_cardbox_01`)
 while not HasModelLoaded(`prop_cs_cardbox_01`) do
 Wait(0)
 end
end)

2. Script de nouvelle tentative de connexion

:retry start "" "%localappdata%FiveMFiveM.appFiveM.exe" +connect serverip:port timeout /t 30 taskkill /f /im FiveM.exe goto retry

Incertitudes

  • Windows 11 les fonctionnalités d'intégrité de la mémoire peuvent entraîner des retards de chargement non documentés
  • Les serveurs protégés par Cloudflare nécessitent une vérification du navigateur (pas de solution automatisée)
  • Certains FAI limitent le trafic UDP sur les ports non standard de manière imprévisible

Référence aux normes

  • Protocole de streaming CitizenFX v2.4.1
  • RFC 4787 (Exigences comportementales NAT pour UDP)

Conclusion: Les blocages de l'écran de chargement proviennent généralement de problèmes de chemin réseau, de cache corrompu ou de goulots d'étranglement du streaming des ressources côté serveur nécessitant une isolation systématique.

Liste de contrôle pratique

Utilisez ce guide comme liste de vérification avant de modifier un serveur FiveM en production. Assurez-vous de la version actuelle des artefacts serveur, de la version du framework, des dépendances des ressources, des modifications de la base de données et des fichiers côté client avant d'appliquer la modification.

  • Sauvegardez les fichiers de configuration et les tables de base de données concernés.
  • Appliquez d'abord la modification sur un serveur de test.
  • Surveillez la console du serveur et la console F8 du client pour détecter les erreurs.
  • Vérifiez si la modification affecte les emplois, l'inventaire, les véhicules, les cartes, la voix, les autorisations ou les données des joueurs.
  • Documentez précisément le fichier, la commande ou le paramètre que vous avez modifié afin de pouvoir le rétablir rapidement.

Tests avant production

Après le premier test, connectez-vous avec un compte joueur standard et répétez le processus du point de vue du joueur. Si le sujet concerne les performances, effectuez des mesures avant et après en conservant le même nombre de joueurs, le même parcours et les mêmes ressources. Si le sujet concerne les outils d'administration ou les permissions, vérifiez les utilisateurs autorisés et ceux qui n'y sont pas autorisés.

Erreurs courantes

La plupart des problèmes rencontrés avec FiveM proviennent de dépendances manquantes, d'un cache obsolète, de noms de dossiers incorrects, d'incompatibilités de frameworks ou d'une configuration copiée depuis un autre serveur. Évitez de modifier plusieurs systèmes simultanément ; effectuez une modification, testez-la, puis poursuivez.

Ressources connexes

Pour les ressources prêtes à la production, comparez les ressources payantes dans le Boutique FiveMX. Pour accéder à des ressources gratuites, consultez Scripts FiveM gratuits et tester chaque ressource avant de l'utiliser publiquement.

Notes de déploiement de la production

Avant d'appliquer ce guide sur un serveur FiveM en production, définissez précisément le résultat attendu. Pour le guide de correction complet du problème d'écran de chargement infini dans FiveM, cela implique de vérifier quelle ressource, quel paramètre, quelle commande ou quel processus est concerné et de confirmer que la modification est compatible avec votre infrastructure, votre version d'artefacts et les règles de votre serveur. Déployez la modification progressivement afin de pouvoir l'annuler rapidement si des joueurs signalent des erreurs.

Utilisez un serveur de test avec la même infrastructure, le même schéma de base de données, le même ordre de ressources et les mêmes dépendances clés que le serveur de production. Si le sujet abordé modifie le gameplay, les permissions, les graphismes, le doublage, les véhicules, les cartes, l'inventaire ou le comportement économique, effectuez des tests avec au moins un compte administrateur et un compte joueur. Surveillez la sortie de la console du serveur, les journaux F8 du client et le temps d'accès aux ressources tout en reproduisant exactement le parcours de jeu qui se déroulera sur le serveur de production.

Liste de contrôle de restauration

  • Sauvegardez le fichier de configuration précédent, le dossier de ressources et l'état de la base de données avant toute modification.
  • Notez la version de la ressource, le commit, la page de téléchargement ou la valeur du paramètre que vous avez testée.
  • Redémarrez d'abord uniquement la ressource concernée lorsque cela est possible, puis redémarrez le serveur complet si des dépendances l'exigent.
  • En cas d'erreur, rétablissez la ressource ou le paramètre modifié avant de tester une autre solution.

Conseils d'entretien

Revérifiez cette configuration après chaque mise à jour des artefacts FiveM, du framework ou modification importante des ressources. Une configuration fonctionnelle aujourd'hui peut devenir inutilisable suite à des mises à jour de dépendances, des modifications d'exports, des changements d'événements ou des migrations de base de données. Conservez des notes dans la documentation de votre serveur afin que les futurs administrateurs comprennent les modifications apportées, leurs raisons et comment les reproduire.

Examen en cours

Consultez à nouveau le guide de correction complet de l'écran de chargement infini de FiveM après les mises à jour majeures des artefacts, les modifications du framework ou les migrations de ressources. Assurez-vous que les conseils correspondent toujours au comportement actuel du serveur, que les sources mentionnées restent disponibles et que les étapes d'installation correspondent toujours aux fichiers que le propriétaire du serveur téléchargera ou configurera.

Pour les serveurs publics, conservez un bref historique des modifications à côté de la documentation du serveur. Indiquez ce qui a été testé, ce qui a changé, les comptes utilisés pour la vérification et la procédure de retour en arrière. Cela facilitera la maintenance future et évitera que les anciennes notes de configuration ne deviennent obscures ou dangereuses pour les joueurs.

Laisser un commentaire