Aller au contenu principal

Lister son serveur dans FiveM

Ce guide vous explique comment rendre votre serveur FiveM visible dans la liste publique des serveurs.

Prérequis​

Obtenir une clé de licence​

Vous devez obtenir votre propre clé de licence sur le portail Cfx.re.

Important

Chaque serveur nécessite sa propre clé de licence unique. N'utilisez jamais la même clé pour plusieurs serveurs.

Configuration du server.cfg​

1. Configuration de la confidentialité​

Ajoutez cette ligne pour protéger certaines informations de votre serveur :

sv_endpointPrivacy true

2. Configuration du listing public​

Activez le listing direct et configurez l'adresse IP publique :

# Active la vue de listing FiveM
set sv_useDirectListing true

# IP publique de votre serveur (SANS le port)
set sv_listingIPOverride "51.91.123.45"
Utilisation d'un sous-domaine

Vous pouvez utiliser l'IP d'un sous-domaine comme game-node6.yorkhost.fr (sans spécifier le port dans cette variable).

3. Informations du serveur​

Configurez le nom et la description qui apparaîtront dans la liste :

# Nom de votre serveur
sets sv_projectName "[FR] Mon Serveur Roleplay"

# Description de votre projet
sets sv_projectDesc "Serveur RP français avec économie réaliste"

4. Configuration technique​

# Active OneSync
# 'on' = infinity (plus de 64 slots)
# 'legacy' = jusqu'à 64 slots
set onesync on

# Clé API Steam (optionnel, utilisez 'none' si non nécessaire)
set steam_webApiKey none

# Votre clé de licence FiveM
set sv_licenseKey VOTRE_CLE_CFX_RE

# Nombre maximum de joueurs
sv_maxclients 64

Configuration complète exemple​

Voici un exemple complet de configuration :

# Confidentialité
sv_endpointPrivacy true

# Listing public
set sv_useDirectListing true
set sv_listingIPOverride "51.91.123.45"

# Informations serveur
sets sv_projectName "[FR] YorkCity RP"
sets sv_projectDesc "Serveur RP français - Économie réaliste"
sets tags "rp, français, whitelist"

# Configuration technique
set onesync on
set steam_webApiKey none
set sv_licenseKey cfxk_VOTRE_CLE_ICI
sv_maxclients 64

# Hostname visible dans la console
sv_hostname "YorkCity RP - discord.gg/exemple"

Validation et vérification​

1. Supprimer sv_master1​

Si vous avez la ligne suivante dans votre server.cfg, supprimez-la :

sv_master1 ""  # À SUPPRIMER
attention

La présence de sv_master1 peut empêcher le listing correct de votre serveur.

2. Redémarrer le serveur​

  1. Sauvegardez votre fichier server.cfg
  2. Redémarrez complètement votre serveur FiveM
  3. Attendez 2-3 minutes pour la propagation

3. Vérifier le listing​

Rendez-vous sur la liste des serveurs FiveM et recherchez votre serveur par son nom.

Problèmes courants​

Le serveur n'apparaît pas dans la liste​

Vérifications :

  • La clé de licence est valide et correctement saisie
  • sv_useDirectListing est défini sur true
  • sv_listingIPOverride contient la bonne IP publique
  • sv_master1 a bien été supprimé du fichier
  • Le serveur est démarré et accessible

Solution : Attendez 5-10 minutes après le redémarrage, le listing peut prendre du temps.

Le serveur apparaît comme "Privé"​

Vérifiez que vous n'avez pas :

sv_lan true  # Mode serveur privé

Cette option rend le serveur invisible dans la liste publique.

Informations incorrectes affichées​

Si le nom ou la description ne s'affichent pas correctement :

  • Utilisez bien sets (et non set) pour sv_projectName et sv_projectDesc
  • Évitez les caractères spéciaux non supportés
  • Redémarrez le serveur après modification

Erreurs JSON (JsonReaderException)​

Si vous rencontrez des erreurs comme :

Newtonsoft.Json.JsonReaderException: Error reading JArray from JsonReader. Path '', line 0, position 0.

Cause : Ces erreurs et autres erreurs similaires liées au JSON sont généralement causées par le fait que votre serveur n'est pas correctement listé dans la liste publique FiveM.

Solution :

  1. Vérifiez que votre serveur est correctement configuré en suivant les étapes ci-dessus
  2. Assurez-vous que sv_useDirectListing est défini sur true
  3. Vérifiez que sv_listingIPOverride contient votre IP publique correcte
  4. Confirmez que votre clé de licence est valide
  5. Supprimez toute directive sv_master1 de votre server.cfg
  6. Redémarrez votre serveur et attendez 5-10 minutes pour la propagation du listing

Pour aller plus loin​

Tags personnalisés​

Ajoutez des tags pour améliorer la découverte de votre serveur :

sets tags "rp, français, whitelist, economie, jobs"

Locale​

Définissez la langue de votre serveur :

sets locale "fr-FR"

Vous pouvez ajouter une bannière personnalisée :

sets banner_detail "https://exemple.com/banner.png"
sets banner_connecting "https://exemple.com/loading.png"
info

Assurez-vous que les images sont hébergées sur un serveur accessible publiquement et que les URLs utilisent HTTPS.