OneSync FiveM est la technologie de synchronisation multijoueur développée par l’équipe Cfx.re qui permet à un serveur FiveM de dépasser la limite de 32 joueurs simultanés et d’offrir une synchronisation des entités bien plus précise. Si vous avez entendu parler de OneSync sans vraiment comprendre ce que ça change concrètement pour votre serveur, ce guide vous explique tout — et en particulier ce qu’il vous faut pour l’activer.
Qu’est-ce que OneSync FiveM exactement ?
OneSync FiveM est un système de synchronisation côté serveur qui remplace le modèle peer-to-peer originel de FiveM. Sans OneSync, chaque joueur synchronise directement sa position et ses actions avec tous les autres joueurs dans son rayon — ce qui limite la fiabilité de la synchronisation et plafonne le nombre de joueurs. Avec OneSync, le serveur prend en charge toute la synchronisation des entités (joueurs, véhicules, peds, objets), ce qui permet à la fois d’avoir plus de joueurs et une synchronisation plus précise.
Il existe deux versions de OneSync : OneSync Legacy (anciennement appelé OneSync activé) qui permet jusqu’à 64 joueurs, et OneSync Infinity qui supprime la limite maximale (en pratique, la limite est déterminée par les ressources de votre serveur). OneSync Infinity est la version recommandée pour tout serveur public sérieux en 2026.
Ce que OneSync change concrètement pour votre serveur
Au-delà du nombre de joueurs, OneSync FiveM apporte plusieurs améliorations techniques importantes pour un serveur RP. La synchronisation des entités distantes est bien meilleure — les véhicules et personnages à distance se comportent de façon plus prévisible, ce qui réduit les situations où un joueur voit quelqu’un traverser un mur ou apparaître d’un coup. La gestion des peds (personnages non-joueurs) est également améliorée, ce qui profite aux scripts qui utilisent beaucoup de NPCs comme les systèmes de trafic ou les scènes scriptées.
OneSync Infinity active aussi le state bags system — un mécanisme de synchronisation d’état partagé entre le serveur et les clients qui permet des scripts beaucoup plus précis. La majorité des scripts modernes ESX Legacy et QBCore sont conçus pour tirer parti de ce système.
Faut-il une clé Patreon pour OneSync ?
Oui — et c’est souvent là que la confusion s’installe. OneSync Infinity nécessite une clé Patreon FiveM, obtenue en soutenant le projet Cfx.re sur Patreon. En 2026, le tier qui débloque OneSync Infinity est le tier Element Club Argentum à 15€/mois.
OneSync Legacy (limite 64 joueurs) est disponible gratuitement avec n’importe quelle clé Keymaster standard. Si votre serveur n’a pas besoin de dépasser 64 joueurs — ce qui est le cas de la majorité des serveurs RP français — vous pouvez activer OneSync Legacy sans aucun coût supplémentaire.
| Version | Joueurs max | Clé requise | Coût |
|---|---|---|---|
| Sans OneSync | 32 joueurs | Keymaster standard | Gratuit |
| OneSync Legacy | 64 joueurs | Keymaster standard | Gratuit |
| OneSync Infinity | Illimité* | Clé Patreon Argentum+ | ~15€/mois |
* La limite réelle dépend des ressources de votre serveur. En pratique, la plupart des serveurs FiveM RP plafonnent à 64-128 joueurs pour des raisons de performances, pas de licence.
Comment activer OneSync FiveM sur votre serveur
Activer OneSync Legacy (gratuit)
Dans votre server.cfg, ajoutez simplement la ligne suivante :
set onesync legacy
Redémarrez votre serveur. C’est tout. Votre serveur peut désormais accueillir jusqu’à 64 joueurs simultanément avec une meilleure synchronisation des entités.
Activer OneSync Infinity (Patreon requis)
Obtenez d’abord votre clé Patreon en rejoignant le tier Argentum sur le Patreon Cfx.re. Rendez-vous ensuite sur keymaster.fivem.net et générez une nouvelle clé en liant votre compte Patreon. Remplacez votre ancienne clé Keymaster dans votre server.cfg par cette nouvelle clé, puis ajoutez :
set onesync on
Redémarrez le serveur. OneSync Infinity est actif.
OneSync et les performances — ce qu’il faut savoir
Activer OneSync FiveM augmente légèrement la charge serveur par rapport à un serveur sans OneSync, parce que le serveur prend en charge plus de calculs de synchronisation. Sur un serveur bien dimensionné, cet impact est négligeable. Sur un serveur déjà à la limite de ses ressources, l’activation de OneSync peut aggraver les problèmes de TPS existants.
La règle pratique : si votre serveur tourne correctement sans OneSync, il tournera correctement avec OneSync Legacy sans modification de plan. Si vous activez OneSync Infinity et prévoyez de dépasser 64 joueurs régulièrement, prévoyez d’augmenter votre RAM de 2 Go. Pour un serveur FiveM de 64 joueurs avec OneSync, 8 Go de RAM est la configuration recommandée. Consultez notre guide hébergeur FiveM pour les options disponibles.
Questions fréquentes
OneSync FiveM est-il obligatoire pour un serveur RP en 2026 ?
Non, mais OneSync Legacy (gratuit) est fortement recommandé même si vous n’avez pas besoin de dépasser 32 joueurs. La synchronisation des entités est meilleure, le state bags system permet des scripts plus précis, et la majorité des scripts modernes ESX Legacy et QBCore sont optimisés pour OneSync.
Peut-on activer OneSync sans clé Patreon ?
Oui — OneSync Legacy est disponible gratuitement avec n’importe quelle clé Keymaster standard. Il permet jusqu’à 64 joueurs simultanés. Seul OneSync Infinity (joueurs illimités) nécessite une clé Patreon Argentum à environ 15€/mois.
OneSync Infinity vaut-il 15€/mois ?
Cela dépend de la taille de votre communauté. Si votre serveur dépasse régulièrement 64 joueurs simultanés, la clé Patreon est un investissement rentable. Si vous restez sous 64 joueurs, OneSync Legacy gratuit offre exactement les mêmes bénéfices techniques à l’exception de la limite de joueurs.
OneSync est-il compatible avec tous les scripts ESX et QBCore ?
Les scripts ESX Legacy et QBCore modernes sont tous compatibles avec OneSync. Les anciens scripts ESX 1.2 peuvent avoir des problèmes de compatibilité avec OneSync Infinity — c’est l’une des raisons supplémentaires de migrer vers ESX Legacy si vous utilisez encore l’ancienne version.
OneSync impacte-t-il le TPS du serveur ?
Légèrement. OneSync transfère une partie du calcul de synchronisation vers le serveur, ce qui peut augmenter marginalement la charge. Sur un serveur bien dimensionné, cet impact est imperceptible. Si votre TPS était déjà bas avant d’activer OneSync, résolvez d’abord les problèmes de performance existants avant d’activer OneSync.