Obtenir et configurer sa license key FiveM (Cfx.re Keymaster)
Chaque serveur FiveM a besoin d'une license key, aussi petit que soit votre projet. Sans clé valide, le serveur refuse tout simplement de démarrer. Bonne nouvelle : cette clé est gratuite et vous l'obtenez en quelques minutes via Keymaster, le portail officiel de Cfx.re, les créateurs de FiveM. Nous parcourons ci-dessous tout le processus : de la création du compte à l'ajout de la clé dans votre server.cfg, avec en prime les solutions aux messages d'erreur les plus connus.
Pourquoi FiveM impose une license key
La license key relie votre serveur à votre compte Cfx.re. Elle permet à la plateforme d'identifier les serveurs, de lutter contre les abus et d'écarter les serveurs qui enfreignent les règles. Pour vous en tant qu'administrateur, cela a aussi des avantages : la liste des serveurs reste plus propre et votre serveur est incontestablement le vôtre.
Une clé standard ne coûte rien et suffit largement à la plupart des serveurs. Si vous voulez plus de slots de joueurs ou des fonctions supplémentaires de la plateforme, Cfx.re propose des abonnements payants. Pour un serveur qui débute, inutile de vous en préoccuper : vous pourrez toujours passer à la version supérieure plus tard.
Important à savoir : une clé est liée à l'adresse IP de votre serveur et ne peut être active que sur un seul serveur en fonctionnement à la fois. Si vous déménagez chez un autre hébergeur ou si votre serveur reçoit une nouvelle adresse IP, mettez-la à jour dans Keymaster. Sinon, votre serveur refusera de démarrer.
Créer un compte Cfx.re
Keymaster fonctionne avec votre compte Cfx.re, le même compte que celui du forum officiel FiveM. Si vous n'en avez pas encore, c'est vite réglé :
- Rendez-vous sur le forum Cfx.re et créez un compte avec une adresse e-mail que vous utilisez réellement.
- Confirmez votre adresse e-mail via le message de confirmation que vous recevez.
- Connectez-vous ensuite avec ce même compte au portail Keymaster via keymaster.fivem.net.
Utilisez un mot de passe fort et unique et activez si possible une sécurité supplémentaire sur votre compte. Votre license key, et donc tout votre serveur, dépend de ce seul compte. Un compte Cfx.re piraté signifie dans le pire des cas que quelqu'un d'autre part avec l'identité de votre serveur.
Étape par étape : générer votre clé dans Keymaster
- Connectez-vous à Keymaster et choisissez d'enregistrer un nouveau serveur.
- Donnez à votre serveur un nom reconnaissable, pour le retrouver facilement si vous gérez plusieurs clés plus tard.
- Renseignez l'adresse IP de votre serveur. Si vous louez un serveur chez un hébergeur, vous trouverez cette adresse IP dans votre panneau de contrôle ou dans l'e-mail contenant les informations de votre serveur.
- Remplissez les autres champs que Keymaster vous demande à propos de votre serveur et de votre projet.
- Générez la clé et copiez-la immédiatement dans un endroit sûr, par exemple un gestionnaire de mots de passe.
Traitez votre clé comme un mot de passe : ne la partagez jamais dans des captures d'écran, des messages Discord ou des fichiers de configuration publics. Quelqu'un qui possède votre clé peut faire tourner un serveur sous votre compte, et c'est vous qui devrez ensuite en assumer les conséquences. Faites-y attention aussi quand vous demandez de l'aide sur un Discord ou un forum : les gens collent étonnamment souvent leur server.cfg complet dans un canal de support, clé incluse. Retirez cette ligne avant de partager quoi que ce soit.
Si vous faites tourner un serveur de test ou de développement en plus de votre serveur principal, créez simplement une deuxième clé pour celui-ci ; les clés sont gratuites, après tout. Donnez à chaque clé un nom clair dans Keymaster, par exemple le nom du serveur plus sa fonction. Vous éviterez ainsi de vous retrouver dans six mois avec trois clés sans plus savoir laquelle tourne où.
Placer la clé dans votre server.cfg
Ouvrez votre server.cfg et ajoutez cette ligne (ou remplacez la ligne existante) :
sv_licenseKey "votre_cle_ici"
Faites attention à ces points :
- Collez la clé exactement comme Keymaster l'affiche, sans espace avant ou après et sans caractères manquants à la fin.
- Placez la clé sur une seule ligne ; une clé coupée n'est pas reconnue.
- Enregistrez le fichier, puis redémarrez complètement le serveur. Enregistrer ne suffit pas : la clé n'est lue qu'au démarrage.
Si votre serveur tourne chez un hébergeur avec un panneau de contrôle, il existe souvent un champ dédié à la license key dans les paramètres ou les paramètres de démarrage de votre serveur. Ce champ remplit automatiquement la clé au démarrage, sans que vous ayez à toucher au server.cfg. Si vous utilisez un tel champ, ne mettez pas la clé aussi dans server.cfg : la définir en double garantit la confusion lors d'un futur changement de clé quant à la valeur réellement utilisée.
Si vous gérez votre serveur avec txAdmin, l'assistant de configuration vous demande lui-même la license key lors de la création de votre serveur et la place au bon endroit. Là aussi, une seule place suffit. Choisissez consciemment où vit votre clé (panneau, txAdmin ou server.cfg) et tenez-vous-y.
Résoudre les messages d'erreur courants
Si votre serveur ne démarre pas et que la console pointe vers la licence, le problème se cache presque toujours dans l'un de ces recoins :
| Symptôme | Cause probable | Solution |
|---|---|---|
| La clé est refusée comme invalide | Faute de frappe, espace en trop ou clé collée incomplètement | Recopiez la clé depuis Keymaster et remplacez entièrement l'ancienne |
| La clé ne fonctionne plus après un déménagement | L'adresse IP dans Keymaster n'est plus correcte | Mettez à jour l'IP du serveur dans Keymaster et redémarrez votre serveur |
| La clé est déjà utilisée | Un autre serveur (de test) tourne encore avec la même clé | Arrêtez ce serveur ou créez une clé distincte pour votre environnement de test |
| Une nouvelle clé ne fonctionne pas immédiatement après création | L'enregistrement n'est pas encore propagé partout | Attendez quelques minutes, puis redémarrez le serveur |
| Le serveur tourne, mais n'apparaît pas dans la liste des serveurs | Généralement pas un problème de clé, mais de ports ou de pare-feu | Vérifiez que les bons ports sont ouverts chez votre hébergeur |
Si vous êtes bloqué, regardez toujours d'abord dans la console du serveur : FiveM y indique assez précisément ce qui coince lors de la vérification de la licence. En cas de problème persistant, vérifiez aussi dans Keymaster que l'enregistrement de votre serveur est encore actif et que vous ne regardez pas par erreur une ancienne clé.
Une dernière possibilité, moins agréable : Cfx.re peut révoquer les clés des serveurs qui enfreignent les conditions d'utilisation, par exemple à cause de contenu illégal ou d'abus de la plateforme. Si votre clé a été révoquée, générer une nouvelle clé ne résout généralement pas le problème durablement ; il faut d'abord régler le problème sous-jacent. Respectez les règles de la plateforme et vous n'aurez en pratique jamais affaire à cela.
Directement en ligne avec votre serveur FiveM
Une fois votre clé en poche, il vous faut évidemment un endroit où l'utiliser. Chez MC-Node, votre serveur FiveM tourne sur du matériel dédié avec stockage NVMe dans le datacenter Previder à Hengelo, protection anti-DDoS incluse. Vous collez votre license key dans le panneau, vous téléversez vos resources et vous êtes en ligne. Toutes les offres sont résiliables mensuellement et commencent dès 1,75 € par mois pour une offre Small ; il existe même une offre Free gratuite pour tester tranquillement avant que votre communauté ne se lance. Découvrez les offres de serveurs FiveM de MC-Node et mettez votre clé au travail dès ce soir.