Récupérer et configurer ta licence Cfx.re pour FiveM

Introduction

Sans license key Cfx.re valide, ton serveur FiveM refuse les connexions. La clé est gratuite mais limitée : 1 serveur par clé. Elle authentifie ton serveur auprès des master servers Cfx.re et lui donne accès aux features comme OneSync.

Prérequis

• Un compte Cfx.re (gratuit, lié à ton compte Forum FiveM)
• Un serveur FiveM chez VeryCloud
• Accès Startup dans le panel Wisp

Étape 1 : Créer un compte Cfx.re

Va sur https://portal.cfx.re/

Clique Sign in → utilise ton Discord ou crée un compte. Le portail Cfx.re sert à gérer tes licenses, deals Patreon, et bans.

Étape 2 : Générer une license key

1. Connecté au portal, clique Server Keys
2. Generate New Key
3. Renseigne :
   • IP : 0.0.0.0 (autoriser n'importe quelle IP) ou ton IP fixe VeryCloud pour plus de sécurité
   • Server Name : libre, pour ton identification
4. Clique Generate

Tu obtiens une clé au format :

cfxk_AbCdEfGhIjKlMnOpQrStUvWxYz_xyz123

Ne la partage jamais publiquement.

Étape 3 : Recommandé : IP-locked ou Any-IP

Pour un serveur stable hébergé chez VeryCloud, IP-locked est recommandé. L'IP est dans Wisp → Network.

Étape 4 : Configurer la clé dans Wisp

Dans Wisp → Startup :

1. Trouve la variable SV_LICENSEKEY ou similaire
2. Colle ta clé cfxk_...
3. Save

Sinon (cas où Wisp ne l'expose pas), édite /server.cfg directement :

sv_licenseKey cfxk_AbCdEfGhIjKlMnOpQrStUvWxYz_xyz123

Étape 5 : Restart et vérifier

Restart depuis la console. Logs attendus :

[FXServer] Connecting to keymaster.fivem.net...
[FXServer] License key validated
[FXServer] Server registered as <hostname>

Si tu vois License key invalid ou Authentication failed, la clé est mauvaise ou révoquée.

Étape 6 : Vérifier l'apparition dans la liste

Lance FiveM côté client, va dans le browser de serveurs et cherche ton hostname. Avec une clé valide, ton serveur apparaît dans les 30 secondes.

Si non visible :

• Vérifie sv_endpointPrivacy false dans server.cfg (si tu veux le serveur public)
• Vérifie sv_master1 "" n'est PAS désactivé

Étape 7 : Gérer plusieurs serveurs

Une clé = un serveur. Si tu as plusieurs FiveM (prod + staging par exemple), génère une clé par serveur.

Le portal Cfx.re affiche tes clés actives avec leur IP. Tu peux :

• Supprimer une clé non utilisée
• Régénérer si compromise
• Changer l'IP associée

Étape 8 : Lier ton Patreon Cfx.re (optionnel)

Si tu es Patreon Cfx.re (ElementClub Argentum / Aurum), tu peux lier le boost à un serveur spécifique :

1. Portal → Server Keys → ta clé → Element Club
2. Sélectionne le tier
3. Ta clé donne maintenant accès à OneSync Infinity, plus de slots, priorité queue, etc.

💡 Le boost suit la clé. Si tu changes de serveur, transfère le boost (clic-clac, c'est dans le portal).

Étape 9 : Régénérer une clé compromise

Si tu soupçonnes que ta clé a fuité (commit Git par mégarde, partage Discord) :

1. Portal → ta clé → Delete ou Regenerate
2. Mets à jour Wisp/server.cfg avec la nouvelle
3. Restart

L'ancienne clé est immédiatement invalidée côté Cfx.re.

Étape 10 : Bans Cfx.re et appels

Si ton serveur est banni par Cfx.re (violation des Terms of Service : contenu illégal, leaks, spam), tu reçois un email avec le motif.

• Lis attentivement les ToS : https://forum.cfx.re/tos
• Appel possible via le forum, section adminship
• Pas de garantie de retour, à éviter

Dépannage

License key invalid au boot

• Recopie sans espace ni saut de ligne
• Vérifie qu'elle est active sur le portal (pas révoquée)

License key IP mismatch

• Ta clé est IP-locked sur la mauvaise IP
• Va sur le portal, change l'IP, ou régénère en "any IP"

Serveur n'apparaît pas dans la liste mais clé OK

• sv_endpointPrivacy true → masque le serveur de la liste publique
• Vérifie sv_master1 "" ou un fichier de config qui le désactive

Plusieurs serveurs avec la même clé = un seul fonctionne

• Normal, une clé = un serveur
• Génère des clés séparées

Commandes utiles

# Verifier la cle dans server.cfg
grep sv_licenseKey /server.cfg

# Voir la requete vers keymaster (console FXServer au boot)
# Logs Wisp / Console

Conclusion

Cfx.re license key = obligatoire, gratuite, simple à générer. IP-lock recommandé pour un serveur stable. Une clé par serveur. Régénère sans hésiter si tu as un doute sur une fuite.

Pour aller plus loin : Patreon ElementClub pour OneSync Infinity, gestion multi-serveurs, automatisation de la rotation.

Ressources

• Cfx.re Portal — Server Keys
• FiveM Docs — Server License Key
• Cfx.re Terms of Service
• Element Club — Patreon Cfx.re