Contexte
Vous gérez un serveur FiveM chez Winheberg et vous souhaitez le rendre visible sur la liste publique Cfx.re, consultable depuis servers.fivem.net et depuis le client FiveM. C'est l'étape clé pour faire grandir votre communauté, mais encore faut-il bien configurer votre server.cfg pour se démarquer parmi les milliers de serveurs déjà listés.
Ce guide passe en revue tous les paramètres essentiels de votre server.cfg, du nom d'affichage aux tags, en passant par l'icône, les bannières et les directives de référencement propres à un hébergement gaming comme le nôtre.
Comment fonctionne le référencement Cfx.re ?
Au démarrage, votre serveur FiveM envoie automatiquement un heartbeat, un signal de vie, aux master servers de Cfx.re. Si tous les paramètres sont corrects, votre serveur apparaît dans la liste publique. Les joueurs peuvent ensuite filtrer cette liste par tags, par langue ou par nombre de joueurs. Plus votre fiche est complète et précise, plus votre serveur remonte dans les recherches pertinentes.
Pour apparaître sur la liste publique, votre serveur doit disposer d'une License Key valide, aussi désignée Server Registration Key, générée depuis le portail Cfx.re (portal.cfx.re) et renseignée dans votre sv_licenseKey. Sans cette clé, votre serveur ne peut pas envoyer de heartbeat.
Générez toujours votre clé directement sur le portail Cfx.re. Les clés proposées par des revendeurs tiers ne sont pas fiables et peuvent être révoquées sans préavis. Chaque serveur listé a besoin de sa propre clé dédiée, une clé partagée ou réutilisée sur plusieurs serveurs n'autorise pas le référencement public.
La clé gratuite de base autorise jusqu'à 48 slots. Pour aller au-delà, un abonnement Element Club, souscrit lui aussi sur le portail Cfx.re, est nécessaire pour débloquer davantage de slots.
Prérequis
- Un serveur FiveM actif sur votre panel gaming Winheberg
- Une License Key Cfx.re dédiée à ce serveur, générée sur
portal.cfx.reet renseignée dans votresv_licenseKey - L'accès à votre
server.cfg, via le panel ou en SFTP - L'adresse exacte de votre serveur au format
gm1-whXX.wh-game.fr:30XXX, visible sur la page principale de votre serveur dans le panel
1. Configurer le hostname
Le hostname est le nom public de votre serveur, celui qui s'affiche dans la liste Cfx.re et dans le client FiveM. C'est la première impression de vos visiteurs, autant la soigner. Repérez ou ajoutez cette ligne dans votre server.cfg.
sv_hostname "^1[FR] ^7Mon Serveur RP ^2| ^3ESX ^7| ^5discord.gg/monserveur"
FiveM permet d'ajouter des codes couleurs pour rendre le hostname plus lisible dans la liste.
| Code | Couleur |
|---|---|
^0 |
Noir |
^1 |
Rouge |
^2 |
Vert |
^3 |
Jaune |
^4 |
Bleu |
^5 |
Cyan |
^6 |
Violet |
^7 |
Blanc |
^8 |
Orange |
^9 |
Gris |
Limitez-vous à deux ou trois couleurs. Un hostname trop coloré et trop long devient illisible dans la liste et donne une impression peu soignée.
2. Renseigner sv_projectName et sv_projectDesc
Ces deux paramètres ne s'affichent pas dans le hostname, ils sont utilisés par Cfx.re et par l'interface de connexion de votre serveur. Le premier est le nom court de votre projet, sans code couleur, le second une description d'une à deux phrases.
sv_projectName "Mon Serveur RP"
sv_projectDesc "Serveur RP francophone basé sur ESX, économie réaliste, jobs custom, ambiance immersive."
Ces valeurs apparaissent sur l'écran de connexion quand un joueur rejoint votre serveur, et aident FiveM à mieux indexer votre fiche. Une description claire reflète mieux votre projet qu'une accroche générique.
3. Ajouter les tags
Les tags permettent aux joueurs de filtrer la liste selon leurs préférences. Bien choisis, ils vous amènent exactement le public que vous visez.
sets tags "roleplay, esx, francophone, serious-rp, custom"
| Catégorie | Tags possibles |
|---|---|
| Type de gameplay | roleplay, racing, freeroam, pvp, economy, survival |
| Framework | esx, qbcore, qbox, vrp |
| Langue | francophone, english, spanish, portuguese |
| Spécificités | custom, realistic, whitelist, serious-rp, hardcore |
Cinq à dix tags pertinents suffisent. Trop de tags dilue votre référencement, et des tags trompeurs attirent des joueurs déçus qui repartent aussitôt. Écrivez-les en minuscules, sans accent ni caractère spécial, séparés par des virgules.
4. Définir la langue du serveur
Cette information sert au filtre par langue de la liste Cfx.re. Indiquez la langue principale de votre serveur.
sets locale "fr-FR"
| Code | Langue |
|---|---|
fr-FR |
Français |
en-US |
Anglais (États-Unis) |
en-GB |
Anglais (Royaume-Uni) |
es-ES |
Espagnol |
pt-BR |
Portugais (Brésil) |
de-DE |
Allemand |
5. Ajouter une icône
Une icône personnalisée rend votre serveur immédiatement reconnaissable dans la liste. Elle s'affiche à gauche du nom dans les résultats.
Votre icône doit être un fichier PNG de 96x96 pixels, léger, et nommé exactement icon.png. Téléversez-le à la racine de votre serveur, au même niveau que le server.cfg, puis redémarrez. Aucune ligne n'est à ajouter dans le server.cfg, FiveM détecte automatiquement le fichier.
Créez une icône simple, lisible même en petit format. Un logo ou une initiale stylisée fonctionne souvent mieux qu'une image chargée de détails.
6. Ajouter des bannières
Les bannières s'affichent sur la fiche de votre serveur dans la liste et pendant l'écran de connexion. Deux paramètres distincts se configurent dans le server.cfg.
| Paramètre | Affichage |
|---|---|
sets banner_detail |
Fiche du serveur dans la liste Cfx.re |
sets banner_connecting |
Écran de connexion d'un joueur |
sets banner_detail "https://votreserveur.fr/banner.png"
sets banner_connecting "https://votreserveur.fr/banner.png"
Vous pouvez utiliser la même image pour les deux, ou en choisir deux différentes. Les dimensions recommandées sont de 1865 x 108 pixels, au format PNG ou JPG, pour un poids inférieur à 500 Ko.
L'URL doit pointer directement vers le fichier image, terminée par .png, .jpg ou .gif. Une page d'aperçu comme imgur.com/xxx ne fonctionne pas, il faut le lien direct de type i.imgur.com/xxx.png.
Pour héberger votre bannière durablement, notre hébergement web vous permet de stocker vos images sur votre propre nom de domaine, ce qui garde le contrôle total sur vos fichiers et donne une image plus crédible à votre serveur. Pour un test rapide, des services comme ImgBB ou Imgur en URL directe font l'affaire.
N'utilisez pas Discord comme hébergeur d'images. Discord modifie régulièrement les URLs de ses fichiers attachés, ce qui casse les bannières au bout de quelques jours. C'est l'erreur la plus fréquente chez les nouveaux administrateurs.
7. Vérifier que sv_master1 est bien commenté
Le paramètre sv_master1 est un piège classique. Dans le server.cfg généré par défaut, il figure sous cette forme.
#sv_master1 ""
Le # en début de ligne est essentiel. Si vous le retirez, FiveM interprète la directive comme un ordre de ne plus contacter les master servers, et votre serveur disparaît de la liste publique.
| Configuration | Effet sur le listing |
|---|---|
#sv_master1 "" (commenté) |
✅ Serveur listé sur Cfx.re |
sv_master1 "" (sans #) |
❌ Serveur invisible ou marqué privé |
| Ligne absente | ✅ Serveur listé par défaut |
Si vous avez retiré le # par erreur, c'est très probablement la cause de votre problème. Remettez-le, sauvegardez et redémarrez.
8. Vérifier que sv_lan est désactivé
Le paramètre sv_lan true bascule votre serveur en mode réseau local et empêche totalement le référencement. Assurez-vous que cette ligne n'est pas présente, ou qu'elle est réglée sur false.
| Configuration | Effet sur le listing |
|---|---|
| Ligne absente | ✅ Serveur listé (mode public par défaut) |
sv_lan false |
✅ Serveur listé |
sv_lan true |
❌ Serveur invisible (mode LAN) |
Le mode LAN ne sert que pour jouer en local entre amis sur le même réseau. Pour un serveur public, laissez-le toujours désactivé.
9. Activer sv_useDirectListing
Ce paramètre indique à FiveM de s'enregistrer directement auprès des master servers, sans proxy intermédiaire. Combiné à sv_listingIPOverride, il garantit un bon référencement chez un hébergeur gaming.
sv_useDirectListing true
Beaucoup de serveurs hébergés sur panel restent invisibles précisément parce que cette ligne manque. C'est souvent le dernier paramètre qui débloque la situation quand tout le reste semble correct.
10. Configurer sv_listingIPOverride
Ce paramètre est indispensable chez nous pour que votre serveur apparaisse avec la bonne adresse. Sans lui, FiveM tente de deviner l'adresse et échoue souvent à cause de l'infrastructure gaming, ce qui rend le serveur invisible ou injoignable.
sv_listingIPOverride "gm1-whXX.wh-game.fr:30XXX"
Remplacez la valeur par l'adresse exacte de votre serveur, visible sur sa page principale dans le panel.
C'est la cause numéro un des problèmes de référencement chez les hébergeurs gaming. Une adresse absente ou incorrecte laisse vos joueurs devant un bouton Connect qui ne mène nulle part.
11. Régler sv_scriptHookAllowed
Ce paramètre contrôle si vos joueurs peuvent utiliser des trainers basés sur ScriptHookV.
sv_scriptHookAllowed 0
| Valeur | Effet |
|---|---|
0 |
ScriptHook désactivé, recommandé sur un serveur public |
1 |
ScriptHook autorisé, à réserver au développement |
Laissez la valeur à 0 sur un serveur public. L'autoriser ouvre la porte aux trainers et à la triche, ce qui ruine l'expérience de votre communauté très vite.
12. Définir le nombre de slots
Le nombre maximum de joueurs simultanés, affiché dans la liste sous la forme 12/64.
sv_maxclients 64
Choisissez un nombre adapté aux capacités de votre offre. Déclarer plus de slots que votre serveur ne peut réellement encaisser provoque des ralentissements dès qu'il se remplit.
13. Redémarrer votre serveur
Une fois les paramètres en place, sauvegardez votre server.cfg, puis cliquez sur Restart sur la page principale de votre serveur. Surveillez la console au démarrage, vous devriez y voir les messages confirmant l'ajout à la liste Cfx.re et l'envoi des heartbeats.
14. Vérifier la visibilité
Quelques minutes après le démarrage, cherchez votre serveur par son hostname sur servers.fivem.net, ou directement dans la liste du client FiveM.
Comptez un à cinq minutes avant l'apparition, la liste n'est pas mise à jour instantanément. Si rien n'apparaît après ce délai malgré une configuration correcte, reprenez les points 7 à 10.
Configuration complète en exemple
Voici une base prête à l'emploi à adapter à votre serveur, en remplaçant les valeurs par les vôtres.
# Identité du serveur
sv_hostname "^1[FR] ^7Mon Serveur RP ^2| ^3ESX ^7| ^5discord.gg/monserveur"
sv_projectName "Mon Serveur RP"
sv_projectDesc "Serveur RP francophone basé sur ESX, économie réaliste, jobs custom, ambiance immersive."
# Bannières
sets banner_detail "https://votreserveur.fr/banner.png"
sets banner_connecting "https://votreserveur.fr/banner.png"
# Référencement Cfx.re
sets tags "roleplay, esx, francophone, serious-rp, custom"
sets locale "fr-FR"
#sv_master1 ""
sv_useDirectListing true
sv_listingIPOverride "gm1-whXX.wh-game.fr:30XXX"
# Sécurité et capacité
sv_scriptHookAllowed 0
sv_maxclients 64
Pensez à remplacer gm1-whXX.wh-game.fr:30XXX par l'adresse exacte de votre serveur. C'est l'erreur qui empêche le plus souvent un serveur d'apparaître correctement.
En cas de problème
❌ Mon serveur n'apparaît pas sur la liste Cfx.re
- Votre License Key est valide, dédiée à ce serveur et générée sur
portal.cfx.re, une clé partagée ou issue d'un revendeur tiers empêche le listing - La ligne
sv_master1 ""est commentée avec un#devant - La ligne
sv_lan trueest absente du fichier - La ligne
sv_useDirectListing trueest bien présente - La ligne
sv_listingIPOverridecontient l'adresse exacte de votre serveur - Votre serveur démarre sans erreur dans la console
❌ Mon serveur apparaît mais les joueurs ne peuvent pas se connecter
- Vérifiez l'adresse affichée sur la fiche du serveur, elle doit correspondre à votre vraie adresse
- Si elle est incorrecte,
sv_listingIPOverrideest mal renseigné ou absent - Corrigez la ligne avec l'adresse exacte du panel et redémarrez
❌ Ma bannière ne s'affiche pas
- L'URL pointe directement vers l'image, par exemple
i.imgur.com/xxx.pnget nonimgur.com/xxx - L'image se charge sans erreur quand vous ouvrez l'URL dans un navigateur
- L'image est accessible publiquement, sans login ni mot de passe
- Vous utilisez bien
sets banner_detailetsets banner_connecting, avecsetset nonset
❌ L'icône de mon serveur n'apparaît pas
- Le fichier s'appelle exactement
icon.png, en minuscules - Il se trouve à la racine du serveur et non dans un sous-dossier
- Ses dimensions sont bien de 96x96 pixels
- Vous avez redémarré complètement le serveur
❌ Les tags ne sont pas pris en compte
- Vous utilisez
sets tagset nonset tags - Les tags sont entre guillemets, séparés par des virgules
- Ils sont en minuscules, sans accent ni caractère spécial
❌ Le hostname affiche des caractères comme ^1 ou ^7
- N'ajoutez pas d'espace après un code couleur (
^1Texteet non^1 Texte) - Évitez de cumuler trop de codes sur un même mot
- Certaines plateformes n'interprètent pas toujours les couleurs, c'est sans gravité
Bonnes pratiques
- Soignez votre hostname, c'est lui qui déclenche le clic dans la liste
- Faites une icône reconnaissable pour vous démarquer visuellement
- Choisissez vos tags avec précision, cinq tags pertinents valent mieux que quinze génériques
- Mettez à jour votre description au fil de l'évolution de votre serveur
- Évitez les promesses exagérées dans le nom, un joueur déçu à l'arrivée repart vite et laisse une mauvaise réputation
- Communiquez votre hostname exact à votre communauté pour qu'elle vous retrouve facilement
Besoin d'aide ?
Si votre serveur n'apparaît pas sur la liste Cfx.re malgré une configuration correcte, notre équipe est là. Ouvrez un ticket dans le département Technique depuis votre espace client, renseignez le champ Produit lié avec le serveur concerné, et joignez les logs de démarrage relevés dans la console.
Votre serveur FiveM est maintenant référencé sur Cfx.re, prêt à accueillir ses premiers joueurs 🎮
