Clé de licence FiveM : enregistrer un serveur sur le portail Cfx.re
Pour démarrer, votre serveur FiveM a besoin d'une clé d'enregistrement de serveur délivrée par Cfx.re (couramment appelée clé de licence). Cette clé s'obtenait autrefois sur le site Keymaster ; c'est désormais le portail Cfx.re (portal.cfx.re) qui remplit ce rôle. Dans ce guide, vous allez apprendre à créer la clé gratuite, à la transmettre au serveur avec sv_licenseKey et à corriger les erreurs d'authentification, et vous verrez ce qu'apporte un abonnement Element Club.
Avant de commencer
- Un compte Cfx.re : vous vous connectez au portail avec votre compte Cfx.re ; c'est le compte que vous utilisez sur le forum Cfx.re. Si vous n'en avez pas, créez d'abord un compte.
- Un FXServer installé : la clé n'est utile qu'une fois les fichiers du serveur prêts. Si vous ne l'avez pas encore installé, suivez d'abord le guide d'installation de FXServer.
- Un accès au serveur : vous vous connecterez à un VDS Windows via RDP et à un VDS Linux via SSH. L'adresse IP et le mot de passe administrateur initial figurent sur la page de votre service et dans l'e-mail d'activation ; si vous ne les trouvez pas, consultez le guide sur l'adresse IP et le mot de passe du VDS.
- L'autorisation des connexions sortantes : à chaque démarrage, le serveur vérifie la clé auprès des serveurs de Cfx.re. Si le pare-feu de votre système d'exploitation empêche FXServer de se connecter vers l'extérieur, l'authentification échoue.
La clé elle-même est gratuite ; l'abonnement payant Element Club ne modifie que la limite de slots et quelques avantages supplémentaires. Si vous hésitez sur le serveur à choisir, la gamme que nous recommandons pour FiveM est le VDS AMD Ryzen 9 9950X, aux performances monocœur élevées ; les offres sont présentées sur la page Location de serveur FiveM.
1. Se connecter au portail Cfx.re
Dans votre navigateur, rendez-vous sur portal.cfx.re et connectez-vous avec votre compte Cfx.re. Le portail est l'interface de gestion que l'équipe Cfx.re a conçue en réécrivant entièrement Keymaster : les clés de serveur, les ressources que vous avez achetées (assets) et votre abonnement Element Club se gèrent au même endroit. Keymaster, quant à lui, a été progressivement abandonné.
N'utilisez pas l'adresse keymaster.fivem.net citée dans les anciens guides pour une nouvelle clé. Si vous avez déjà créé une clé sur Keymaster, consultez la page Registration Keys du portail : si votre clé y apparaît avec le statut Active, vous pouvez continuer à l'utiliser ; sinon, créez une nouvelle clé en suivant les étapes ci-dessous.
2. Créer une clé de serveur
- Dans le portail, ouvrez la section Registration Keys (clés d'enregistrement) de la page Servers. L'adresse directe est
portal.cfx.re/servers/registration-keys. - Cliquez sur le bouton Generate Key (générer une clé).
- La fenêtre qui s'ouvre ne demande qu'un nom d'affichage (display name). Ce nom vous permet de reconnaître la clé par la suite, par exemple « Serveur RP 1 ».
- Confirmez avec Generate. La nouvelle clé apparaît dans votre liste de clés d'enregistrement ; copiez-la depuis cette liste.
À l'époque de Keymaster, le formulaire demandait aussi l'adresse IP du serveur et le type d'hébergement (VPS, serveur dédié, connexion domestique), et la clé était liée à cette IP. Le portail a supprimé ces champs et ne demande plus qu'un nom ; l'étape des anciens guides « relevez d'abord l'IP de votre VDS et saisissez-la dans le formulaire » n'existe plus. Vous pouvez détenir au maximum trois clés actives (Active) par compte. Utilisez une clé distincte pour chaque serveur et ne faites pas tourner la même clé sur deux serveurs en même temps.
La clé est une valeur secrète qui relie votre serveur à votre compte Cfx.re ; conservez-la comme un mot de passe. Ne la partagez pas sur Discord, sur un forum, dans une capture d'écran ou dans un dépôt GitHub public. Si vous soupçonnez une fuite, cliquez sur la valeur Server ID de la clé dans la page Registration Keys, puis choisissez Regenerate et ensuite Yes. La clé est renouvelée ; n'oubliez pas de reporter la nouvelle valeur dans la configuration de votre serveur.
3. Placer la clé dans le fichier server.cfg
La clé se définit dans le fichier server.cfg du dossier de données du serveur, avec la variable sv_licenseKey. Dans l'exemple de configuration de Cfx.re, cette ligne se présente sous la forme sv_licenseKey changeme ; remplacez changeme par votre propre clé. L'emplacement du fichier dépend de votre installation :
| Installation | Fichier | Comment le modifier |
|---|---|---|
| Windows (vanilla) | C:\FXServer\server-data\server.cfg | Ouvrez-le dans le « Notepad » (Bloc-notes), modifiez la ligne et enregistrez |
| Linux (vanilla) | ~/FXServer/server-data/server.cfg | Modifiez-le via SSH avec nano ou vim |
| txAdmin | Le server.cfg créé par txAdmin | Collez la clé dans le champ prévu de l'assistant d'installation (voir ci-dessous) |
Voici un exemple correct des lignes liées à la licence (les chemins de dossiers correspondent à l'exemple d'installation de docs.fivem.net) :
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
sv_hostname "Your server name"
sets sv_projectName "Your community name"
sets sv_projectDesc "Short description"
set onesync on
sv_maxclients 48
sv_licenseKey "YOUR_LICENSE_KEY"
Points à surveiller :
- Mettez la clé entre guillemets ; ne laissez pas d'espace au début ni à la fin.
- Ne mettez pas de
#en début de ligne ;#transforme la ligne en commentaire et la clé n'est pas lue. - Ne gardez qu'une seule ligne
sv_licenseKeydans le fichier. S'il y en a deux, c'est la dernière qui s'applique, ce qui sème la confusion lors d'un dépannage. - Si vous ne voulez pas écrire la clé dans le fichier, vous pouvez ajouter
+set sv_licenseKey "YOUR_LICENSE_KEY"à la commande de démarrage. Dans ce cas, supprimez la ligne deserver.cfgqui définitsv_licenseKey, afin que les deux valeurs ne se mélangent pas.
Si vous utilisez txAdmin
Si vous avez installé le serveur avec txAdmin, vous n'avez pas besoin de modifier le fichier server.cfg à la main. Dans l'assistant d'installation, passez à la section Recipe Deployer (déploiement de la recette), examinez la recette et continuez ; collez la clé copiée depuis le portail dans le champ de l'étape « Before you begin », puis cliquez sur le bouton Run Recipe. txAdmin écrit lui-même la clé dans la configuration qu'il crée. Si vous voulez la modifier plus tard, vous retrouverez la même ligne sur la page CFG Editor (éditeur de configuration) du panel txAdmin. Pour plus de détails, consultez le guide txAdmin.
4. Démarrer le serveur et vérifier l'authentification
Sous Windows, dans le « Command Prompt » (cmd, l'invite de commandes) :
cd /d C:\FXServer\server-data
C:\FXServer\server\FXServer.exe +exec server.cfg
Sous Linux :
cd ~/FXServer/server-data && bash ~/FXServer/server/run.sh +exec server.cfg
Au démarrage, la console affiche d'abord la ligne Authenticating server license key.... Si l'authentification réussit, la ligne Server license key authentication succeeded. Welcome! suit ; si vous voyez cette ligne, la clé ne pose aucun problème. Si l'authentification échoue, le serveur affiche une erreur et s'arrête ; vous trouverez les causes possibles dans la section « Erreurs fréquentes ».
Pour que les joueurs puissent se connecter, le port 30120 doit être ouvert en TCP et en UDP dans le pare-feu du système d'exploitation. Le pare-feu est entre vos mains : c'est vous qui ouvrez les ports depuis le système d'exploitation. Pour la marche à suivre, consultez le guide du pare-feu et de l'ouverture de ports.
5. Element Club : qu'apporte l'abonnement payant ?
Avec la clé gratuite, votre serveur accueille au maximum 48 joueurs avec OneSync Infinity (onesync on). Pour davantage de slots et le droit au streaming de packs de vêtements personnalisés (EUP et similaires), il faut un abonnement Element Club. L'abonnement s'achetait autrefois via Patreon, le compte Patreon étant lié au compte du forum. Cfx.re n'accepte plus de nouvelles adhésions Patreon ; l'abonnement s'achète désormais dans la section Subscriptions du portail (portal.cfx.re/subscriptions) et s'applique directement à votre compte Cfx.re. L'étape des anciens guides « liez votre compte Patreon au forum » n'existe pas dans le portail.
| Palier | Joueurs maximum | Avantages supplémentaires |
|---|---|---|
| Clé gratuite | 48 (OneSync Infinity) | Aucun avantage supplémentaire |
| Argentum | 64 (OneSync et Infinity) | Accès à Element Club, streaming de vêtements personnalisés |
| Aurum | 64 (OneSync), 128 (Infinity) | Identiques à Argentum |
| Platinum | 128 (OneSync), 2048 (Infinity) | Identiques à Argentum ; en plus, une icône de serveur animée et une mise en évidence magenta dans la liste publique |
Les prix sont mensuels et affichés hors taxes (HT) ; vous pouvez consulter le montant actuel sur la page Element Club de Cfx.re et dans le portail. Après la souscription, l'application des avantages à votre compte peut prendre jusqu'à 6 heures ; les avantages supplémentaires ne sont pas actifs avant ce délai. Lorsque vous augmentez le nombre de slots, sv_maxclients et onesync doivent être réglés ensemble : à partir de 32 joueurs, onesync doit valoir on ou legacy, et au-delà de 64, obligatoirement on. Pour installer un pack de vêtements, consultez le guide d'installation d'EUP.
Réglages de licence et de slots
| Réglage | Rôle | Exemple |
|---|---|---|
sv_licenseKey | La clé obtenue sur le portail ; vérifiée au démarrage du serveur | sv_licenseKey "YOUR_LICENSE_KEY" |
sv_maxclients | Limite de joueurs, de 1 à 2048 ; ne dépassez pas la valeur autorisée par votre abonnement | sv_maxclients 48 |
onesync | Mode de suivi d'état (state awareness) ; on ou legacy à partir de 32, on au-delà de 64. legacy est déconseillé en raison de problèmes de performances | set onesync on |
sv_hostname | Le nom d'hôte du serveur ; sv_projectName et sv_projectDesc doivent être définis en même temps | sv_hostname "RP Server" |
sets sv_projectName / sets sv_projectDesc | Nom de la communauté et description en une phrase ; les noms longs sont tronqués dans la liste | sets sv_projectName "Community" |
sv_master1 | Une valeur vide marque le serveur comme « private » (privé) dans la liste ; elle ne retire pas complètement le serveur de la liste principale | sv_master1 "" |
Erreurs fréquentes
- « no license key was specified » : le serveur n'a jamais lu la ligne
sv_licenseKey. Le plus souvent, le serveur a été démarré depuis le mauvais dossier ou+exec server.cfgmanque dans la commande. Démarrez le serveur depuis le dossierserver-dataavec la commande de l'étape 4. - « Could not authenticate server license key » ou « An error occurred while checking the server license key » : vérifiez d'abord la ligne dans
server.cfg:changemey figure-t-il encore, la clé a-t-elle été collée avec des caractères en moins ou en trop, la ligne a-t-elle été commentée avec#? Vérifiez ensuite sur la page Registration Keys que la clé figure dans la liste avec l'état Active ; vous pouvez sélectionner une clé désactivée et la réactiver avec Re-Activate en bas de la page. Assurez-vous enfin que votre pare-feu ne bloque pas les connexions sortantes de FXServer. Les anciennes versions du serveur (artifacts) n'affichent que ce message générique ; les versions actuelles écrivent la cause réelle dans la console. Sauvegardez votre dossierserver-dataavant de mettre à jour. - « Your key is not matching the initial IP address sufficiently » : ce message signifie qu'une ancienne clé Keymaster, créée en étant liée à une adresse IP, est utilisée depuis une autre IP ; il apparaît par exemple lorsque vous déplacez le serveur vers un nouveau VDS. Créez une nouvelle clé dans le portail (le portail ne demande pas d'IP) et remplacez la valeur dans la configuration.
- La clé est correcte mais n'est pas lue : vous modifiez peut-être le mauvais fichier. Si vous utilisez txAdmin, c'est la configuration créée par txAdmin qui s'applique, et non le fichier
server.cfgde l'installation vanilla. Si le fichier contient deux lignessv_licenseKey, supprimez-en une. - « You lack the required entitlement to use ... » : une ressource chiffrée (escrow) que vous avez achetée ne démarre pas. La clé du serveur doit appartenir au compte qui a acheté la ressource. Redémarrez le serveur et vérifiez la clé ; si vous avez acheté la ressource avec un autre compte, vous pouvez la transférer vers votre compte actuel via le portail.
- Le serveur démarre mais n'apparaît pas dans la liste FiveM : même si la clé a été authentifiée, si le port 30120 n'est pas joignable depuis l'extérieur, les joueurs ne peuvent pas se connecter et le serveur peut ne pas apparaître dans la liste. Ouvrez le port 30120 en TCP et en UDP dans le pare-feu.
- Impossible de dépasser 48 joueurs, ou les vêtements ne s'affichent pas : soit vous n'avez pas d'abonnement Element Club, soit les avantages n'ont pas encore été appliqués à votre compte (jusqu'à 6 heures). Vérifiez que l'abonnement apparaît comme actif dans le portail et que le serveur tourne avec une clé appartenant à ce compte ; une clé d'un autre compte ne bénéficie pas des avantages de l'abonnement.
Questions fréquentes
La clé de licence est-elle payante ?
Non. La clé que vous créez dans le portail est gratuite et suffit pour faire tourner le serveur. Vous ne payez que l'abonnement Element Club, qui s'adresse à ceux qui veulent relever la limite de slots et streamer des vêtements personnalisés.
Mon ancienne clé obtenue sur Keymaster est-elle encore valable ?
Si elle apparaît comme Active sur la page Registration Keys et que l'authentification réussit au démarrage du serveur, vous pouvez continuer à l'utiliser. Une ancienne clé liée à une adresse IP provoque l'erreur « initial IP address » lorsque vous déplacez le serveur ; dans ce cas, créer une nouvelle clé dans le portail est la solution la plus rapide.
Puis-je faire tourner plusieurs serveurs avec un seul compte ?
Oui, mais vous pouvez détenir au maximum trois clés actives par compte. Créez une clé distincte pour chaque serveur et donnez-lui un nom explicite pour ne pas confondre quelle clé se trouve sur quel serveur. Désactiver une clé que vous n'utilisez pas libère une place dans la limite.
Un nom de serveur en couleur est-il inclus dans Element Club ?
Les anciens guides mentionnaient un « nom en couleur » pour Platinum. La liste actuelle des avantages de Cfx.re ne contient aucun élément de ce nom ; l'avantage de visibilité de Platinum dans la liste consiste en une icône de serveur animée et en la mise en évidence de votre serveur en magenta dans la liste publique. Vérifiez les avantages dans la liste actuelle du portail avant de vous abonner.
J'avais une adhésion Patreon : que dois-je faire ?
Cfx.re a transféré les abonnements de Patreon vers le portail ; les nouvelles adhésions ne sont plus acceptées via Patreon, et la prise en charge des anciennes adhésions Patreon a pris fin. Pour continuer à profiter des avantages, choisissez de nouveau le même palier dans la section Subscriptions du portail ; l'abonnement s'applique directement à votre compte Cfx.re.
Guides associés
- Installer FXServer : un serveur FiveM de zéro (Windows et Linux)
- Utiliser txAdmin : guide de gestion d'un serveur FiveM
- Installer EUP sur FiveM : l'exigence Element Club et l'ajout de vêtements personnalisés
- Comment ouvrir un port sur un VDS ? Pare-feu Windows, ufw et firewalld
- Optimiser un serveur FiveM : lire resmon et augmenter les FPS
- Tous les guides FiveM : catégorie des guides FiveM
Commentaires0
Pas encore de commentaire
Soyez le premier à partager votre avis.
Veuillez vous connecter ou vous inscrire pour laisser un commentaire.