Clé Patreon FiveM : à quoi sert-elle vraiment ?

La clé Patreon FiveM (license key) est l'identifiant technique qui autorise un serveur à rejoindre l'infrastructure Cfx.re et à être visible dans la liste des serveurs. Sans elle, l'exécutable FXServer refuse de démarrer la session réseau. Cet article détaille son rôle, sa génération et son intégration dans server.cfg.

Clé Patreon FiveM : rôle technique dans le démarrage du serveur

La clé Patreon FiveM n'a plus de lien direct avec un compte Patreon actif depuis que Cfx.re a généralisé la distribution via le Keymaster, mais le nom est resté dans le jargon communautaire car la fonctionnalité provenait historiquement d'un financement participatif du projet. Techniquement, cette clé est un identifiant unique au format alphanumérique qui sert à :

• authentifier le serveur auprès des serveurs maîtres Cfx.re ;
• autoriser l'ouverture du port de jeu et la diffusion de l'annonce dans la liste publique ;
• rattacher les statistiques de connexion (joueurs, uptime, ressources) à un compte Cfx.re précis ;
• débloquer l'accès à txAdmin pour la supervision à distance.

Sans clé valide renseignée dans la configuration, FXServer lève une erreur au démarrage et refuse d'écouter sur le port réseau, même si tous les autres paramètres (ressources, maxclients, scripts) sont corrects. C'est donc un prérequis bloquant, pas une option de confort.

Si tu gères une communauté FiveM et que tu veux déléguer la partie infrastructure (performances CPU, anti-DDoS, panel Pterodactyl) pour te concentrer sur les scripts et les ressources, l'hébergeur FiveM de Fly-Serv prend en charge la machine pendant que tu restes maître de ta configuration et de ta clé.

Générer sa clé Patreon FiveM depuis le Keymaster

La génération se fait exclusivement via le portail Keymaster, accessible avec un compte Cfx.re connecté (Steam, Epic Games ou e-mail). Voici la procédure :

Étapes de création

1. Connecte-toi sur le portail Keymaster avec ton compte Cfx.re.
2. Clique sur "New" puis sélectionne "FiveM server registration" (ou "RedM" si tu administres un serveur RedM).
3. Donne un nom lisible à ta clé pour la retrouver facilement si tu gères plusieurs instances.
4. Valide : la clé apparaît immédiatement sous forme de chaîne alphanumérique longue.
5. Copie la clé en entier, sans espace ni retour à la ligne parasite.

Points de vigilance

Une clé Patreon FiveM est liée à un compte Cfx.re unique. Si tu modères une équipe, ne partage pas tes identifiants Cfx.re pour générer la clé : crée plutôt la clé toi-même puis transmets uniquement la chaîne aux autres administrateurs via un canal sécurisé. Une clé compromise peut être régénérée depuis le Keymaster, ce qui invalide instantanément l'ancienne sur tous les serveurs qui l'utilisaient.

Si plusieurs instances (production, test, staging) tournent en parallèle, génère une clé distincte par instance. Cela évite les conflits d'annonce sur la liste des serveurs et simplifie le suivi des statistiques dans le Keymaster.

Intégrer la clé Patreon FiveM dans server.cfg

Une fois la clé générée, elle doit être placée dans le fichier server.cfg via la variable sv_licenseKey. C'est généralement l'une des premières lignes du fichier, avant la déclaration des ressources.

# server.cfg - extrait minimal
sv_licenseKey "cfxk_XXXXXXXXXXXXXXXXXXXXXXXXXXXX"
sv_hostname "^1Mon serveur FiveM"
sv_maxclients 48
sv_endpointprivacy true

# Ressources de base
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
ensure rconlog

Quelques règles à respecter pour que la clé soit prise en compte correctement :

• la ligne sv_licenseKey doit contenir la chaîne entre guillemets, sans espace avant ou après ;
• le fichier server.cfg doit être encodé en UTF-8 sans BOM, sinon FXServer peut mal interpréter les premiers caractères ;
• la clé ne doit jamais être poussée sur un dépôt Git public : place-la dans un fichier séparé ignoré par .gitignore si tu versionnes ta configuration.

Démarrage sur une machine Linux

Sur une machine Linux (VPS ou autre), le lancement du binaire FXServer se fait en pointant vers le server.cfg contenant la clé :

cd /home/fivem/server
./run.sh +exec server.cfg

Si tu administres toi-même l'infrastructure sur un VPS Linux, pense à ouvrir le port UDP/TCP du jeu dans ton pare-feu (ufw) et à vérifier les logs de démarrage : une clé invalide ou mal copiée génère un message explicite dans la console avant que le processus ne se ferme.

sudo ufw allow 30120/tcp
sudo ufw allow 30120/udp

Variante via txAdmin

Si tu passes par txAdmin pour administrer l'instance, la clé Patreon FiveM se renseigne directement dans l'interface, section "Configuration", champ dédié à la license key. txAdmin génère ensuite le server.cfg final en y injectant automatiquement la valeur, ce qui évite les erreurs de syntaxe manuelles.

Erreurs fréquentes autour de la clé Patreon FiveM

Symptôme	Cause probable	Correction
FXServer se ferme juste après le démarrage	Clé absente ou mal formatée dans server.cfg	Vérifier la ligne sv_licenseKey, guillemets et absence d'espace
Message "Invalid license key"	Clé copiée partiellement ou regénérée côté Keymaster	Régénérer puis recopier l'intégralité de la chaîne
Serveur invisible dans la liste publique	sv_endpointprivacy mal configuré ou clé non authentifiée	Contrôler la connectivité réseau et la validité de la clé
Deux instances partagent la même clé	Clé réutilisée sur plusieurs machines simultanément	Générer une clé distincte par instance

Dans la grande majorité des cas, un problème de clé Patreon FiveM se résout en consultant la console au démarrage : FXServer affiche un message clair indiquant si la clé est manquante, invalide ou déjà utilisée par une autre session active. Une sauvegarde régulière du server.cfg (hors clé, stockée séparément) permet de revenir rapidement à une configuration fonctionnelle après un test raté.

Pour la documentation officielle complète sur la mise en place d'un serveur et le format du server.cfg, la référence reste la documentation FiveM.

Besoin d'étendre ton projet vers d'autres univers roleplay ? Consulte aussi Serveur RedM ou parcours Tous nos serveurs de jeu pour comparer les ressources CPU disponibles selon les jeux.

La clé Patreon FiveM reste un passage obligé avant tout démarrage : sans elle, aucune annonce réseau n'est possible. Génère-la via le Keymaster, place-la correctement dans server.cfg, et garde-la hors de tout dépôt public pour éviter les conflits entre instances.

FAQ

Faut-il un compte Patreon actif pour obtenir une clé Patreon FiveM ?

Non, la clé se génère désormais via le Keymaster avec un simple compte Cfx.re (Steam, Epic ou e-mail), aucun lien avec un compte Patreon actif n'est requis.

Peut-on utiliser la même clé Patreon FiveM sur deux serveurs différents ?

Techniquement possible mais déconseillé : cela provoque des conflits d'annonce réseau et mélange les statistiques. Génère une clé distincte par instance active.

Pourquoi FXServer refuse-t-il de démarrer malgré une clé renseignée ?

Vérifie l'absence d'espace ou de retour à la ligne parasite autour de la valeur dans sv_licenseKey, et confirme que la clé n'a pas été régénérée depuis le Keymaster entre-temps.