Obtenir et configurer votre licence Cfx.re (clé serveur FiveM)

Pourquoi une clé Cfx.re est-elle nécessaire ?

Une licence Cfx FiveM, aussi appelée clé serveur ou clé d’enregistrement, permet d’authentifier votre instance FXServer auprès de l’infrastructure Cfx.re. Sans clé valide, un serveur public FiveM ne peut pas démarrer normalement.

Cette clé permet notamment de :

• rattacher le serveur à votre compte Cfx.re ;
• authentifier FXServer au démarrage ;
• appliquer les droits associés à votre abonnement ;
• déterminer la limite de slots autorisée ;
• rendre possible le référencement public du serveur.

La clé Cfx.re ne remplace pas votre clé de licence GTA V et ne donne pas accès au jeu. Elle concerne uniquement l’instance serveur FiveM.

La présence d’une clé valide ne garantit pas à elle seule l’apparition dans la liste publique. Les ports, le pare-feu, le nom du projet et les paramètres de visibilité doivent également être correctement configurés.

La création d’une clé standard est gratuite. Un abonnement devient nécessaire lorsque vous souhaitez dépasser la limite gratuite de joueurs ou utiliser certains avantages réservés aux abonnés.

Créer sa clé sur le portail Cfx.re

La gestion des clés s’effectue désormais depuis le portail Cfx.re. L’ancienne adresse keymaster.fivem.net, encore mentionnée dans de nombreux tutoriels, peut rediriger vers ce portail.

Pour créer votre clé serveur FiveM :

1. ouvrez le portail Cfx.re ;
2. connectez-vous avec le compte Cfx.re qui doit posséder le serveur ;
3. accédez à la gestion des clés ou des serveurs ;
4. cliquez sur l’option de création d’une clé ;
5. saisissez un nom permettant d’identifier le serveur ;
6. renseignez les informations demandées par le portail ;
7. générez la clé ;
8. copiez-la dans un emplacement sécurisé.

Choisissez un nom explicite :

TalCloud - Serveur RP principal

ou :

Serveur FiveM de test

Le nom affiché dans le portail sert uniquement à organiser vos clés. Il ne correspond pas nécessairement au nom public visible dans FiveM.

Si le portail demande une adresse IP, utilisez l’adresse publique attribuée à votre serveur TalCloud. N’indiquez pas :

• le nom de domaine ;
• l’adresse de votre ordinateur personnel ;
• le port FiveM ;
• une adresse privée comme 127.0.0.1 ;
• une adresse locale commençant par 192.168.

Exemple de valeur attendue :

203.0.113.20

Si une option adaptée aux adresses dynamiques est proposée, utilisez-la uniquement lorsque l’adresse publique du serveur peut réellement changer. Sur un hébergement disposant d’une IP fixe, choisissez la configuration correspondant à cette IP.

Créez la clé avec votre propre compte Cfx.re. Une clé fournie par un tiers peut être révoquée sans votre accord et ne vous donne pas la maîtrise de l’abonnement associé.

Ajouter sv_licenseKey dans server.cfg

Ouvrez le fichier suivant depuis le gestionnaire de fichiers du panel TalCloud :

server.cfg

Ajoutez la clé avec la directive exacte :

sv_licenseKey "cfxk_VOTRE_CLE"

Exemple fictif :

sv_licenseKey "cfxk_abcd1234exemple5678"

Vous pouvez placer cette ligne dans la partie générale du fichier, en dehors d’une section de commentaires.

Une configuration simplifiée peut ressembler à ceci :

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

sets sv_projectName "Mon serveur RP"
sets sv_projectDesc "Une communauté RP francophone"

set onesync on
sv_maxclients 48

sv_licenseKey "cfxk_VOTRE_CLE"

Enregistrez le fichier, puis redémarrez complètement FXServer depuis txAdmin ou le panel.

Pour configurer le lancement et consulter la console, reportez-vous au guide pour démarrer avec txAdmin.

Ne jamais publier sa clé

La clé Cfx.re doit rester privée. Ne l’intégrez pas dans :

• un dépôt GitHub public ;
• une capture d’écran ;
• une archive distribuée à votre équipe ;
• un message Discord public ;
• un tutoriel ;
• un fichier server.cfg partagé sans nettoyage.

Masquez toujours sa valeur dans vos captures :

sv_licenseKey "cfxk_************************"

Une clé exposée doit être considérée comme compromise. Révoquez-la depuis le portail Cfx.re et générez-en une nouvelle.

Avant toute modification importante, des sauvegardes automatiques sont incluses pour vous aider à restaurer. Conservez aussi vos propres exports réguliers : vous restez responsable de vos données.

Licence gratuite, Argentum et abonnements supérieurs

La clé gratuite permet d’exploiter un serveur FiveM avec OneSync jusqu’à 48 joueurs simultanés. Au-delà de 48 slots, un abonnement Cfx.re compatible est nécessaire.

Formule	Limite de joueurs	Usage
Clé gratuite	Jusqu’à 48 slots	Serveur privé, test ou communauté de taille moyenne
Element Club Argentum	Jusqu’à 64 slots	Premier palier pour dépasser 48 joueurs
Aurum et paliers supérieurs	Selon l’offre active	Serveurs nécessitant davantage de slots ou d’avantages

Les offres, leurs noms, leurs avantages et leurs limites peuvent évoluer. Vérifiez toujours les conditions affichées dans le portail Cfx.re au moment de souscrire.

Pour utiliser plus de 48 slots, vous devez généralement :

1. souscrire l’abonnement avec le compte propriétaire de la clé ;
2. utiliser une version récente des artifacts FXServer ;
3. activer OneSync ;
4. définir une limite compatible dans server.cfg ;
5. redémarrer le serveur.

Exemple pour une clé Argentum autorisant 64 joueurs :

set onesync on
sv_maxclients 64
sv_licenseKey "cfxk_VOTRE_CLE"

Définir sv_maxclients 64 sans abonnement compatible ne contourne pas la limite Cfx.re. Le serveur refusera la configuration ou empêchera les joueurs de se connecter.

TalCloud ne bride pas artificiellement le nombre de slots configurables dans FXServer. En revanche, les limites liées à la clé et à l’abonnement sont appliquées par Cfx.re. L’abonnement doit donc être souscrit et géré directement par le client depuis son compte Cfx.re.

La puissance nécessaire dépend également de vos scripts, de OneSync et du nombre réel de joueurs. Une licence autorisant davantage de slots ne garantit pas que votre configuration soit suffisamment dimensionnée.

Lier, remplacer ou révoquer une clé

Vos clés sont administrées depuis le portail Cfx.re associé à votre compte. Vous pouvez y identifier les serveurs enregistrés et gérer les clés existantes.

Révoquez une clé lorsque :

• elle apparaît dans une capture publique ;
• elle a été publiée sur GitHub ;
• un ancien prestataire la connaît ;
• vous cédez ou supprimez le serveur ;
• vous suspectez une utilisation non autorisée ;
• vous changez de compte propriétaire.

La procédure générale est la suivante :

1. arrêtez le serveur ;
2. ouvrez la gestion des clés Cfx.re ;
3. sélectionnez la clé concernée ;
4. révoquez-la ou supprimez-la ;
5. générez une nouvelle clé ;
6. remplacez la valeur dans server.cfg ;
7. redémarrez FXServer ;
8. vérifiez la console.

Ancienne configuration :

sv_licenseKey "cfxk_ANCIENNE_CLE"

Nouvelle configuration :

sv_licenseKey "cfxk_NOUVELLE_CLE"

Une clé révoquée ne doit plus rester dans vos sauvegardes partagées, vos fichiers de démonstration ou vos dépôts de code.

Dépanner une licence Cfx FiveM

Aucune clé n’est détectée

La console peut signaler qu’aucune clé de licence n’a été spécifiée. Vérifiez que FXServer charge bien le fichier contenant :

sv_licenseKey "cfxk_VOTRE_CLE"

Contrôlez également que la commande de lancement exécute le bon fichier :

+exec server.cfg

La clé est invalide

Recopiez la clé directement depuis le portail Cfx.re. Vérifiez :

• l’absence d’espace avant ou après ;
• la présence du préfixe attendu ;
• les guillemets correctement fermés ;
• l’absence de retour à la ligne au milieu de la clé ;
• le statut actif de la clé dans le portail.

Le serveur reste limité à 48 slots

Vérifiez que :

• l’abonnement est actif ;
• il est rattaché au même compte que la clé ;
• le palier autorise la valeur choisie ;
• OneSync est activé ;
• les artifacts FXServer sont récents ;
• sv_maxclients contient la bonne valeur.

Exemple :

set onesync on
sv_maxclients 64
sv_licenseKey "cfxk_VOTRE_CLE_ARGENTUM"

La clé semble déjà utilisée ou liée au mauvais serveur

Vérifiez dans le portail que vous utilisez la bonne clé et qu’elle correspond à l’instance concernée. Si l’adresse du serveur a changé, mettez à jour l’enregistrement lorsque cette option est disponible ou créez une nouvelle clé.

Évitez de lancer simultanément plusieurs instances publiques avec une configuration qui n’est pas prévue pour cela.

Le serveur démarre mais n’apparaît pas publiquement

Contrôlez les paramètres suivants :

sets sv_projectName "Mon serveur RP"
sets sv_projectDesc "Serveur RP francophone"

Vérifiez également que cette ligne reste commentée :

#sv_master1 ""

Enfin, contrôlez l’ouverture des ports TCP et UDP, ainsi que les erreurs affichées dans la console. L’apparition dans la liste publique peut demander quelques minutes après le démarrage.

En résumé

• Une licence Cfx FiveM authentifie votre instance FXServer auprès de Cfx.re.
• Créez gratuitement votre clé depuis le portail Cfx.re avec votre propre compte.
• Utilisez l’IP publique du serveur lorsque le portail la demande.
• Ajoutez la clé dans server.cfg avec sv_licenseKey "cfxk_VOTRE_CLE".
• Ne publiez jamais votre clé sur Discord, GitHub ou dans une capture d’écran.
• La formule gratuite permet d’utiliser jusqu’à 48 slots avec OneSync.
• Un abonnement Argentum ou supérieur est nécessaire pour dépasser 48 joueurs.
• Argentum permet généralement de configurer jusqu’à 64 slots ; vérifiez les limites actuelles dans le portail.
• TalCloud fournit l’hébergement, mais l’abonnement Cfx.re reste à souscrire par le client.
• Révoquez immédiatement toute clé compromise et remplacez-la dans server.cfg.
• En cas d’erreur, vérifiez la clé, le compte propriétaire, OneSync, sv_maxclients et les artifacts.
• Pour utiliser votre licence Cfx FiveM sur une infrastructure hébergée en France avec panel de gestion, stockage NVMe, Anti-DDoS L3/L4/L7 inclus et support francophone, consultez l’offre serveur FiveM TalCloud.