Votre serveur FiveM démarre, la console a l'air en bonne santé, et le navigateur de serveurs ne l'affiche toujours pas. Presque tous les cas se ramènent à l'une de six causes, et un seul test d'une minute vous dit quelle moitié de cette liste vous devez lire.
Commencez par le test d'accessibilité ci-dessous. Il découpe le problème proprement : soit l'extérieur n'atteint pas du tout votre serveur, soit il l'atteint et quelque chose dans server.cfg vous tient à l'écart de la liste. Sauter ce test, c'est la raison pour laquelle des gens passent une soirée entière à réécrire un fichier de configuration alors que le vrai problème était un port UDP fermé.
Étape 1 : votre serveur est-il joignable depuis l'extérieur ?
Serveur démarré, ouvrez ceci dans un navigateur en remplaçant l'adresse par l'IP publique et le port de votre serveur :
http://203.0.113.10:30120/info.json
Faites-le depuis un autre endroit que la machine qui fait tourner le serveur. Votre PC à la maison convient, votre téléphone en données mobiles aussi. Un test depuis le serveur lui-même réussit toujours, car ce trafic ne quitte jamais la machine.
- Une page de JSON apparaît. Le serveur est joignable. Passez à l'étape 3.
- Délai dépassé ou connexion refusée. Le serveur n'est pas joignable. Passez à l'étape 2.
Vous pouvez aussi consulter http://votre-ip:30120/dynamic.json, qui renvoie le nombre de joueurs en direct, ou passer l'adresse dans notre vérificateur de statut de serveur FiveM.
Étape 2 : le serveur n'est pas joignable
C'est un problème de ports, pas de configuration. Trois choses à vérifier, dans cet ordre.
Le pare-feu Windows. Windows Server bloque le trafic entrant par défaut, un VPS tout neuf refuse donc tout jusqu'à ce que vous en décidiez autrement. Il vous faut le port 30120 ouvert en TCP et en UDP, sous forme de deux règles distinctes. Le détail complet, avec les commandes qui font tout d'un coup : Ouvrir les ports FiveM dans le pare-feu Windows.
Sous Linux, le comportement par défaut est généralement l'inverse, rien n'est bloqué. Sur un VPS Ubuntu ou Debian fraîchement installé, le pare-feu est donc rarement le coupable. Vérifiez plutôt que le processus du serveur écoute réellement et qu'il est lié à 0.0.0.0 plutôt qu'à 127.0.0.1.
Le port sur lequel le serveur écoute. Dans server.cfg, ce sont ces deux lignes qui le définissent :
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
Les deux doivent être présentes, pointer vers le même port, et ce port doit être celui que vous avez ouvert dans le pare-feu. 0.0.0.0 signifie "écouter sur toutes les interfaces". Si quelqu'un a mis 127.0.0.1, le serveur ne parle qu'à lui-même.
La redirection de ports, si vous hébergez depuis chez vous. Une connexion domestique exige de rediriger 30120 en TCP et UDP sur le routeur vers le PC qui fait tourner le serveur, en plus des règles Windows. Un VPS n'en a aucun besoin, il possède déjà sa propre IP publique.
Dès que /info.json répond depuis l'extérieur, revenez ici et continuez.
Étape 3 : joignable, mais toujours absent de la liste
Le serveur répond, le problème se situe donc dans server.cfg ou du côté de la licence. Déroulez la liste.
sv_master1 doit rester commentée
C'est le point que la plupart des guides du web ont à l'envers, alors vérifiez-le en premier. Ouvrez server.cfg et cherchez cette ligne :
#sv_master1 ""
Le # est déterminant. Commentée comme ci-dessus, votre serveur envoie son heartbeat et apparaît normalement dans la liste. Retirez le # et vous avez explicitement demandé à FXServer de ne pas s'enregistrer auprès de la master list : le serveur ressort comme privé, et le bouton de connexion est désactivé pour tous ceux qui parcourent la liste.
Quantité de tutoriels et de modèles de configuration recopiés vous disent d'ajouter sv_master1 "" pour régler les problèmes de listing. L'effet est exactement inverse. Si la ligne ne figure pas du tout dans votre server.cfg, ne l'ajoutez pas. Le listing est actif par défaut.
sv_projectName et sv_projectDesc doivent être définies toutes les deux
sets sv_projectName "My FXServer Project"
sets sv_projectDesc "Default FXServer requiring configuration"
S'il en manque une seule, le serveur lève une erreur au démarrage et risque de ne pas figurer dans la liste. Les deux lignes commencent par sets, pas par set. Cette lettre unique se perd facilement quand on édite à la main.
La clé de licence doit être valide pour ce serveur
La ligne sv_licenseKey a besoin d'une clé fonctionnelle issue du portail Cfx. Une clé en échec fait tomber le serveur au lieu de le masquer, vérifiez donc les premières lignes de la console à la recherche d'une erreur de licence au démarrage. Les clés créées aujourd'hui dans le portail Cfx ne sont liées à aucune adresse, mais les anciennes clés issues de Keymaster pouvaient l'être, donc si vous avez déplacé le serveur vers un nouvel hébergeur, ouvrez la clé dans le portail et vérifiez qu'elle est toujours valable pour celui-ci.
Pas à pas : Obtenir une clé de licence FiveM.
Laissez-lui jusqu'à huit minutes
Un serveur fraîchement lancé peut mettre jusqu'à huit minutes à apparaître dans la liste. Si vous venez de redémarrer après une modification de configuration, attendez ce délai avant de changer quoi que ce soit d'autre. Redémarrer en boucle remet ce compteur à zéro à chaque fois.
Plus de 48 places demandent un abonnement
Si sv_maxclients dépasse 48, le serveur exige un abonnement Element Club Argentum ou supérieur sur votre compte Cfx. Sans cela, réglez sv_maxclients sur 48 ou moins et le serveur se liste normalement.
Un NAT qui masque les ports source UDP
Pertinent si vous hébergez depuis chez vous ou derrière une passerelle d'entreprise. Certains routeurs et pare-feu réécrivent le port source UDP, ce qui casse le heartbeat alors que tout le reste fonctionne. Un VPS avec une IP publique directe n'a pas ce souci. C'est une des raisons pour lesquelles on quitte une connexion domestique.
Direct Connect fonctionne mais le serveur n'est pas listé
Cela mérite d'être isolé, car cela réduit beaucoup le champ. Appuyez sur F8 dans FiveM et lancez :
connect 203.0.113.10:30120
Si cela vous connecte alors que le navigateur ne montre toujours pas le serveur, c'est que le serveur est joignable et tourne parfaitement. L'étape 2 est donc entièrement écartée, et cela pointe vers sv_master1, les variables de projet manquantes, le nombre de places, ou simplement les huit minutes pas encore écoulées.
Si Direct Connect échoue aussi, retournez à l'étape 2.
Liste de contrôle rapide
| Vérification | Où | Valeur correcte |
|---|---|---|
| TCP 30120 ouvert | Pare-feu Windows Defender | Inbound, Allow, tous les profils |
| UDP 30120 ouvert | Pare-feu Windows Defender | Une seconde règle distincte |
| Adresse d'écoute | server.cfg |
endpoint_add_tcp et endpoint_add_udp sur 0.0.0.0:30120 |
| Master list | server.cfg |
#sv_master1 "" commentée, ou totalement absente |
| Variables de projet | server.cfg |
sets sv_projectName et sets sv_projectDesc définies |
| Places | server.cfg |
sv_maxclients à 48 ou moins sans abonnement |
| Licence | server.cfg |
sv_licenseKey valide issue du portail Cfx |
| Patience | Après un redémarrage | Jusqu'à 8 minutes |
Questions fréquentes
Mon serveur apparaît comme privé dans la liste. Même problème ?
Oui, et la cause est le plus souvent la même ligne. Un sv_master1 "" sans # marque le serveur comme privé et grise le bouton de connexion.
Le nom du serveur influe-t-il sur le listing ?
Non, mais il influe sur votre capacité à le retrouver. Le navigateur FiveM liste des milliers de serveurs, cherchez donc votre sv_hostname exact, et souvenez-vous que les codes couleur du type ^2 font partie du nom enregistré sans s'afficher comme texte.
J'ai ouvert les ports et rien n'a changé. Confirmez que les règles sont entrantes et non sortantes, que TCP et UDP existent tous les deux, et que Public est coché à l'étape des profils. Une carte de VPS se trouve généralement sur le profil Public, donc une règle sans Public ne fait strictement rien.
Dois-je configurer tout cela sur un serveur FiveM DoomHosting ? Non. Les ports sont ouverts et le serveur est listé dès l'installation. Tout ce qui précède concerne un VPS que vous gérez vous-même, à comparer avec un serveur FiveM infogéré si vous préférez éviter la maintenance.
