Clé Patreon FiveM : comprendre les slots et OneSync

La clé Patreon FiveM conditionne directement le nombre de joueurs que ton instance peut accepter au-delà du seuil historique de 32 slots. Sans ce lien entre ton compte Cfx.re et un palier Patreon actif, impossible de dépasser certains plafonds, même en poussant sv_maxclients à 128. Cet article détaille le rôle exact de cette clé, la configuration d'OneSync et les réglages techniques nécessaires pour stabiliser une forte population de joueurs.

La clé Patreon FiveM et le déverrouillage des slots au-delà de 32

Par défaut, une instance FiveM accepte 32 connexions simultanées. Ce chiffre n'est pas arbitraire : il correspond au comportement natif du moteur réseau avant l'activation d'OneSync. Dès que tu dépasses ce seuil, le projet Cfx.re impose une vérification côté compte : ton profil doit être relié à un palier Patreon actif pour que le serveur de session accepte une population supérieure.

Concrètement, la clé Patreon FiveM n'est pas un fichier de licence classique à copier dans un dossier. C'est une liaison effectuée via Keymaster (le portail de gestion des clés Cfx.re), où ton compte développeur se synchronise avec ton compte Patreon. Une fois cette liaison active, le service de matchmaking autorise des valeurs de sv_maxclients plus élevées : 48, 64, 96, 128 et au-delà selon le palier choisi.

Population	Mode OneSync requis	Condition
Jusqu'à 32	Aucun (legacy)	Aucune liaison nécessaire
33 à 48	OneSync (standard)	Compte Cfx.re vérifié
49 à 128+	OneSync Infinity	Compte lié à un palier Patreon actif

Sans cette liaison, même un fichier server.cfg parfaitement rédigé avec sv_maxclients 128 se verra rejeté ou plafonné silencieusement par le service de session. C'est la source la plus fréquente d'incompréhension chez les administrateurs qui pensent avoir un problème de configuration alors que le blocage vient du compte.

Si tu préfères déléguer la partie infrastructure plutôt que de gérer toi-même les artifacts, les droits root et la liaison Patreon, un hébergeur FiveM clé en main simplifie la bascule vers 128 slots en gardant la main sur la configuration OneSync et les ressources du serveur.

Configurer sv_maxclients et OneSync pour une population de 128 slots

Une fois la clé Patreon FiveM liée à ton compte, la configuration technique reste entièrement de ton ressort. OneSync Infinity doit être activé explicitement, et sv_maxclients doit être ajusté de façon progressive pour éviter les instabilités réseau.

Activer OneSync Infinity dans server.cfg

Le fichier server.cfg doit contenir les directives suivantes, placées avant le chargement des ressources :

# server.cfg
set onesync on
set onesync_population true
set sv_maxclients 128
set sv_endpointprivacy true

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

set sv_enforceGameBuild 2802

Le paramètre onesync_population permet de synchroniser les entités (NPC, véhicules, objets) sur une population étendue, indispensable dès que tu dépasses 48 joueurs simultanés. Sans lui, les scripts qui gèrent le trafic, la faune ou les events custom affichent des comportements incohérents sur une carte comme celle de FiveM.

Ajuster sv_maxclients progressivement

Plutôt que de passer directement de 32 à 128, teste par paliers : 48, puis 64, puis 96, puis 128. Chaque palier doit être validé pendant plusieurs sessions réelles avant d'augmenter encore, car la charge CPU et la bande passante montante augmentent de façon non linéaire avec le nombre de connexions actives et de scripts synchronisés côté serveur.

Vérifier la liaison Keymaster avant chaque montée en charge

Avant de pousser sv_maxclients au-delà de 48, confirme que ton artifact est à jour et que ton compte Cfx.re affiche bien le badge Patreon actif dans Keymaster. Un artifact obsolète combiné à une liaison expirée provoque des rejets de connexion silencieux, souvent confondus avec un problème de pare-feu ou de ports.

# Vérifier la version de l'artifact en cours
./run.sh +exec server.cfg

# Dans la console FiveM, confirmer le statut OneSync
status onesync

Optimiser la stabilité d'un serveur FiveM à forte population

Passer à 128 slots sans adapter l'infrastructure sous-jacente aboutit presque toujours à des latences en dents de scie et des déconnexions aléatoires. Le moteur FiveM reste très dépendant de la fréquence d'un cœur CPU pour la boucle principale du jeu, bien plus que du nombre total de cœurs disponibles.

Pourquoi la fréquence CPU prime sur le nombre de cœurs

La majorité de la logique serveur FiveM (synchronisation des entités, exécution des ressources Lua/JS/C#) tourne sur un thread principal. Un processeur Ryzen à haute fréquence réduit le temps de traitement par tick, ce qui limite les micro-saccades ressenties par les joueurs connectés simultanément, surtout au-delà de 64 slots où le volume d'événements réseau explose.

Surveiller les ressources en continu

Le panel Pterodactyl permet de suivre en direct la charge CPU, la mémoire et les logs console sans passer par une connexion SSH séparée. C'est particulièrement utile pour repérer une ressource mal optimisée qui sature le thread principal avant même d'atteindre la population maximale visée.

# Dans la console du panel, identifier les ressources gourmandes
resmon

# Lister les ressources actives et leur consommation
ensure monitor-resources

Anti-DDoS et sauvegardes pour une instance exposée publiquement

Une communauté qui grandit vers 128 slots devient une cible plus visible. Une protection anti-DDoS active en permanence évite qu'une attaque volumétrique coupe l'accès au moment où la population est la plus élevée. Couplée à des sauvegardes automatiques régulières, elle permet de restaurer rapidement l'état de la base de données et des fichiers de configuration en cas d'incident, plutôt que de reconstruire manuellement les ressources et les permissions.

Pour comparer les configurations entre plusieurs titres de l'écosystème Cfx.re, le fonctionnement du Serveur RedM suit des principes très proches en matière de OneSync et de montée en charge, ce qui facilite la transposition des réglages si tu gères plusieurs instances. Tu peux aussi consulter Tous nos serveurs de jeu pour situer les écarts de ressources nécessaires selon le titre hébergé.

Erreurs fréquentes lors du passage à 128 slots

Certaines erreurs reviennent systématiquement chez les administrateurs qui tentent de dépasser 32 ou 48 joueurs sans avoir validé chaque étape de la clé Patreon FiveM.

• Connexions rejetées au-delà de 48 : la liaison Keymaster n'est pas active ou le palier Patreon a expiré depuis la dernière vérification.
• Désynchronisation des entités : onesync_population n'est pas activé alors que sv_maxclients dépasse 48.
• Chute de FPS côté joueurs : scripts non optimisés qui exécutent des boucles lourdes à chaque tick sur une population étendue.
• Déconnexions aléatoires : bande passante montante insuffisante pour synchroniser le volume d'entités généré par OneSync Infinity.
• Artifact obsolète : version du build FiveM trop ancienne pour supporter correctement les paliers de population élevés.

Dans la majorité des cas, revenir à un palier inférieur (64 plutôt que 128) le temps d'auditer les ressources actives résout le problème plus vite qu'une recherche prolongée côté réseau.

FAQ

Faut-il reconfigurer OneSync à chaque redémarrage du serveur FiveM ?

Non, tant que les directives restent dans server.cfg, OneSync Infinity et sv_maxclients se chargent automatiquement à chaque démarrage de l'instance via le panel.

Pourquoi sv_maxclients 128 ne fonctionne pas malgré la bonne syntaxe ?

Vérifie d'abord que ton compte Cfx.re est bien relié à un palier Patreon actif dans Keymaster : sans cette liaison, le service de session plafonne la population indépendamment du fichier de configuration.

Combien de cœurs CPU sont nécessaires pour tenir 128 joueurs sur FiveM ?

Le nombre de cœurs compte moins que la fréquence d'un cœur unique, car la boucle principale du jeu reste largement mono-thread ; privilégie un processeur Ryzen cadencé haut plutôt qu'un grand nombre de cœurs peu fréquents.