Changer de license key FiveM sur un serveur en production touche trois couches distinctes : l’authentification côté Cfx.re, la configuration locale (server.cfg, txAdmin) et les données persistantes (base SQL, fichiers resources). Confondre ces couches, c’est risquer un blocage au redémarrage ou, pire, une désactivation définitive de la clé par les contrôles automatisés de Cfx.re.
Entitlements CFX.re et license key FiveM : ce que la clé embarque vraiment
Une license key n’est pas un simple jeton d’accès réseau. Elle est juridiquement liée à un owner CFX.re précis et porte avec elle un ensemble d’entitlements : accès Patreon, early access sur certains assets, niveau OneSync autorisé, plafond de slots.
A lire également : Découvrez la nouvelle adresse de FR1Lib et ses alternatives
Lors d’une migration vers une nouvelle clé, ces entitlements ne suivent pas automatiquement. Si le nouveau compte CFX.re ne dispose pas des mêmes droits que l’ancien, certains scripts ou assets payants cessent de fonctionner après le changement. Nous observons régulièrement des serveurs qui perdent l’accès à des resources Tebex-locked sans comprendre pourquoi : le problème vient de là.
Depuis 2024, Cfx.re a durci les contrôles de cohérence licence/IP/slots. Une même license key utilisée sur plusieurs IP publiques déclenche une suspension automatique. Avant toute manipulation, il faut donc s’assurer que l’ancienne clé est bien retirée du server.cfg de l’ancien hôte, et que le serveur précédent est arrêté.
A découvrir également : Gérer son compte Mon Intraparis simplement et sans complication
Vérifier les droits avant de générer la nouvelle clé
Connectez-vous sur le portail Keymaster (keymaster.fivem.net) avec le compte qui deviendra le nouvel owner. Contrôlez dans la section « Servers » les éléments suivants :
- Le tier Patreon actif sur ce compte (il conditionne le plafond OneSync et le nombre de slots débloqués)
- Les assets liés au compte via Tebex : un script acheté sur l’ancien compte ne sera pas transférable par simple copie de fichiers
- L’absence de clé déjà active sur la même IP cible, pour éviter un conflit d’authentification
Préparer le serveur FiveM avant le changement de clé
La migration de clé ne nécessite aucune réinstallation de FXServer. Les binaires, les resources et la base de données sont indépendants de la license key. Toute la chaîne de données persistantes (tables SQL, fichiers de configuration des scripts, inventaires, véhicules, identités joueurs) reste intacte si vous ne touchez qu’au paramètre d’authentification.
Sauvegarde ciblée des fichiers critiques
Nous recommandons de sauvegarder trois éléments avant toute intervention :
- Le fichier server.cfg complet (contient la directive sv_licenseKey, les convars, les paramètres OneSync, les ACL txAdmin)
- Le dump SQL de la base de données (mysqldump complet, compressé) : c’est lui qui porte les données joueurs, pas la clé
- Le dossier txData si vous utilisez txAdmin, car il stocke les profils d’administration, les backups programmés et les logs d’audit
Le dossier cache peut être ignoré. Il sera recréé au prochain démarrage de FXServer et ne contient aucune donnée joueur.
Modifier la license key dans server.cfg et txAdmin
La directive concernée est sv_licenseKey dans le fichier server.cfg. Remplacez la valeur existante par la nouvelle clé générée sur Keymaster. La syntaxe reste identique :
sv_licenseKey « votre_nouvelle_cle_ici »
Si votre hébergeur expose un champ « License Key » dans l’onglet Startup du panneau Pterodactyl, la modification à cet endroit écrase la valeur du server.cfg au démarrage. Dans ce cas, modifiez les deux emplacements pour éviter une incohérence au prochain redéploiement.
Cas txAdmin avec recipe
txAdmin stocke la clé dans sa propre couche de configuration. Après avoir modifié server.cfg, ouvrez l’interface txAdmin, accédez à la section « CFG Editor » et vérifiez que la valeur affichée correspond bien à la nouvelle clé. Un décalage entre les deux fichiers provoque un refus de démarrage silencieux, sans message d’erreur explicite dans la console.
Redémarrez FXServer (pas un simple restart de resource) pour que la nouvelle clé soit prise en compte par le processus principal. Un restart partiel ne recharge pas les convars système.
Vérification post-migration et pièges fréquents sur serveur FiveM
Le serveur redémarre, la liste FiveM l’affiche, les joueurs se connectent. La migration semble terminée. Trois points méritent une vérification explicite.
Le premier concerne l’identité serveur dans la server list. Le changement de clé modifie l’identifiant unique du serveur côté Cfx.re. Si vous aviez configuré des liens directs (cfx.re/join/xxxxx), l’ancien lien ne fonctionnera plus. Générez le nouveau lien depuis le portail Keymaster et mettez à jour vos canaux Discord, votre site web et vos widgets.
Le second piège touche les scripts qui vérifient la license key côté serveur. Certaines resources anti-triche ou de gestion de whitelist stockent la clé en dur dans leur configuration. Après migration, ces scripts rejettent les connexions ou génèrent des erreurs d’authentification silencieuses. Parcourez les fichiers config.lua et .env de vos resources pour traquer toute référence à l’ancienne clé.
Le troisième point concerne la rétention des données joueurs. Les identifiants utilisateur FiveM (license:xxxx, steam:xxxx, discord:xxxx) sont indépendants de la server key. Les données joueurs en base SQL ne sont pas affectées par un changement de clé. Les inventaires, véhicules, comptes en banque RP et progressions restent intacts à condition que la base de données n’ait pas été modifiée pendant la manipulation.
Surveiller les logs au premier redémarrage
Consultez la sortie console de FXServer dans les premières minutes. Deux messages signalent un problème de clé : « Invalid license key » (clé mal formatée ou déjà utilisée sur une autre IP) et « License key authentication failed » (le compte CFX.re associé est suspendu ou la clé a été révoquée). Dans les deux cas, retournez sur Keymaster pour vérifier le statut de la clé et l’IP déclarée.
La migration d’une license key FiveM reste une opération rapide quand les couches sont bien séparées. La clé gère l’authentification réseau, pas les données. Le seul vrai risque porte sur les entitlements du compte CFX.re et les scripts qui codent la clé en dur. Vérifiez ces deux points, et le serveur reprend son activité sans interruption perceptible pour les joueurs.
