FiveM absent de la liste : diagnostiquer « Server list query returned an error »

Commencer par une connexion directe depuis FiveM

Dans la console F8 du client, tentez la destination attribuée. Notez si l’échec survient avant la connexion, pendant le téléchargement ou après l’entrée en jeu. Si la connexion directe fonctionne, le problème de liste doit être étudié séparément ; si elle échoue, vérifiez d’abord le démarrage et les chemins réseau.

connect 192.0.2.10:30120

Comparer la réponse info.json depuis l’extérieur

Contrôlez l’endpoint public depuis une connexion extérieure autorisée. Comparez, si vous avez un accès console au système, avec un test local adapté à son écoute. Une réponse locale seule ne prouve pas l’accessibilité publique.

curl --connect-timeout 5 --max-time 10 -fsS http://192.0.2.10:30120/info.json

Distinguer affichage privé et absence d’inscription

Examinez server.cfg et les réglages gérés par votre panneau ou le portail Cfx.re. La documentation actuelle distingue sv_master1, qui peut désactiver le bouton de connexion et afficher un état privé, de l’envoi au service de liste : ce réglage n’est plus une méthode pour retirer un serveur de la liste. N’ajoutez pas cette variable si elle est absente.

Contrôlez les erreurs de démarrage et d’authentification Cfx.re sans copier la clé de licence dans un diagnostic public. Les réglages de nom et de projet évoluent selon la version et le portail ; ne remplacez pas un ensemble de paramètres par un vieux modèle trouvé en ligne.

Contrôler les endpoints, le NAT et les proxies

Une adresse d’écoute comme 0.0.0.0 n’est pas l’IP publique à communiquer aux joueurs. Derrière un NAT, comparez l’IP et le port annoncés, les destinations TCP/UDP et les journaux concernés. Les variables sv_listingIpOverride et sv_listingHostOverride ne doivent être utilisées que lorsqu’un proxy ou un NAT les rend nécessaires.

Si une protection ou un proxy distingue connexion HTTP et trafic de jeu, vérifiez chaque trajet. Un proxy web n’achemine pas automatiquement l’UDP. Transmettez au support les allocations et horaires utiles plutôt que de désactiver globalement les protections ou de modifier des routes au hasard.

Écarter un problème propre au service de liste

Après un démarrage confirmé, laissez le temps à l’inscription de se mettre à jour et consultez les annonces de statut ou de support Cfx.re. Un résultat de recherche vide à un instant donné n’établit pas une panne persistante. Évitez les redémarrages en boucle : ils réinitialisent le contexte de diagnostic.

Si la connexion directe fonctionne mais pas la liste, conservez les résultats extérieurs de info.json et le message exact. Si seuls des joueurs d’un opérateur échouent, notez cette différence ; ne concluez pas qu’un incident de référencement explique aussi tous les échecs de connexion.

Constituer un dossier de diagnostic exploitable

Rassemblez heure et fuseau, version de FXServer, dernier changement, IP/port attribués, résultat F8, résultat HTTP extérieur et extraits de logs pertinents. Précisez si un proxy ou un NAT existe. Masquez clés Cfx.re, jetons txAdmin, adresses privées non utiles et informations personnelles.

Le guide sur le chargement FiveM complète ce diagnostic si la connexion aboutit mais qu’une ressource bloque ensuite. Pour la liste, validez une correction ciblée avec les mêmes tests, depuis la même connexion puis une autre autorisée, avant de fermer le dossier.