OneSync sur un serveur FiveM : modes, slots et culling

Ce que OneSync change réellement

Le code réseau d'origine de GTA V est pensé pour une session de 32 joueurs où chaque client fait autorité sur ce qui l'entoure. OneSync déplace cette autorité vers le serveur : c'est lui qui détient l'état des véhicules, des PNJ et des objets, et qui décide ce que chaque client reçoit.

La conséquence pratique dépasse le nombre de joueurs. Un serveur en OneSync peut créer des entités côté serveur, les faire persister sans qu'un joueur soit à proximité, et empêcher un client de déclarer ce qu'il veut. C'est ce qui rend possible une économie RP cohérente — et ce qui ferme la porte à une bonne partie des triches historiques.

Les trois modes, et lequel choisir

OneSync s'active par une seule variable dans server.cfg. Trois valeurs sont acceptées : `on`, `legacy` et `infinity`.

`infinity` est le mode à utiliser aujourd'hui. `legacy` ne subsiste que pour des serveurs anciens qui n'ont jamais été portés ; `on` est la valeur historique. Sur FiveM pour GTA V Enhanced, la question ne se pose plus : la documentation Cfx.re indique que le mode « big » est le seul disponible, le mode non-big n'existant plus.

set onesync infinity
sv_maxclients 64

Les plafonds de joueurs, sans approximation

C'est le point sur lequel circulent le plus de chiffres faux, y compris chez des hébergeurs. Les valeurs ci-dessous sont celles publiées par Cfx.re sur fivem.net/server-hosting, relevées le 5 novembre 2026.

Sans OneSync, le moteur plafonne à 32 joueurs. Avec OneSync Infinity — gratuit, aucun abonnement requis — un serveur monte à 48. L'Element Club Argentum porte le plafond à 64 : c'est la clé que nous incluons dans toutes nos offres FiveM. Au-delà, il faut un palier Cfx.re supérieur, souscrit et facturé directement chez Cfx.re : Aurum pour 128 joueurs, Platinum pour 2048.

Deux conséquences à retenir. D'abord, les « 2048 joueurs » qu'on lit partout sont le plafond du moteur au palier Platinum, pas celui d'un serveur ordinaire. Ensuite, `sv_maxclients` ne peut pas dépasser le plafond de votre licence : déclarer 128 avec une clé Argentum ne crée pas 128 places.

Le culling, ou pourquoi 2048 joueurs ne coûtent pas 2048 fois plus

Infinity ne tiendrait pas à cette échelle s'il envoyait tout à tout le monde. Il n'envoie à chaque client que ce qui l'entoure : c'est le culling. Le rayon par défaut est de 424 unités autour de l'entité, et sous Infinity la zone de focus est fixée en dur à 424 unités autour du joueur.

Les natives historiques de culling sont dépréciées et portent des défauts connus que Cfx.re ne corrigera pas. Pour modifier un rayon, la documentation renvoie vers SET_ENTITY_DISTANCE_CULLING_RADIUS et SET_PLAYER_CULLING_RADIUS.

Côté scripts, les événements `playerEnteredScope` et `playerLeftScope` permettent de suivre les entrées et sorties de portée, mais Cfx.re avertit qu'ils passent mal à l'échelle. Quand c'est possible, les state bags et ADD_STATE_BAG_CHANGE_HANDLER sont la bonne réponse.

Ce qui limite vraiment votre serveur

Dans la quasi-totalité des cas, le plafond de licence n'est pas la contrainte qui se manifeste en premier. Ce sont les ressources : une boucle de script qui tourne chaque frame, un inventaire qui interroge la base à chaque mouvement, une centaine de ressources dont dix font 80 % de la charge.

FiveM exécute l'essentiel de la logique serveur sur un seul cœur. C'est pour cette raison que la fréquence du processeur compte plus que son nombre de cœurs, et pourquoi nos nodes FiveM tournent sur Ryzen 9 7950X3D à 5,7 GHz. Un serveur à 64 joueurs mal optimisé tombera avant un serveur à 128 bien écrit.