OneSync sur FiveM
DOG&DEV · 25/01/2025
Monitoring
Open Source
OneSync sur FiveM
OneSync est un mode de synchronisation des entités (joueurs, véhicules, objets, peds) entre le serveur et les clients. Il améliore la stabilité et la précision pour les scripts avancés (inventaires, porte-à-porte, MLO, ESX, QBCore). Ce guide décrit set onesync (on, legacy, infinity), l’impact sur la synchro et les prérequis.
Prérequis
- Serveur FiveM (fivem-windows-vps)
- Accès à server.cfg
Modes OneSync
- off (ou absent) : mode historique, limite d’entités synchronisées (≈ 64 joueurs max, netteté moins bonne).
- legacy : évolution du mode classique, meilleure synchro que off.
- on : mode OneSync « classique », recommandé pour la plupart des serveurs (64–128 joueurs, scripts modernes).
- infinity : évolution de on, conçue pour des capacités plus élevées (joueurs, entités). À activer si votre build FiveM et vos scripts le supportent.
En pratique : on ou infinity selon la doc FiveM et vos ressources.
Activation dans server.cfg
Placer avant les ensure (en tête ou juste après les convars globales) :
set onesync on
Ou :
set onesync infinity
Un seul set onesync ; la dernière valeur lue prévaut, mais mélanger les modes n’a pas de sens. Redémarrer le serveur après modification.
Impact
- Joueurs : meilleure synchro des positions, des animations, des véhicules (passagers, porte-à-porte).
- Entités : peds, véhicules, objets (props) gérés de façon plus fiable côté serveur ; moins de « disparitions » ou de doublons.
- Scripts : beaucoup de jobs (ESX, QBCore), inventaires, MLO et portes reposent sur OneSync. Sans on (ou infinity), dysfonctionnements ou bugs.
Prérequis pour les ressources
- ESX / QBCore : conçus pour OneSync on. esx-qbcore-setup.
- Mappings (MLO, intérieurs) : souvent plus stables avec OneSync. fivem-mapping.
- Vérifier la doc ou le README de chaque ressource : quelques vieux scripts peuvent supposer off ; dans ce cas, les mettre à jour ou les remplacer.
Dépannage
| Symptôme | Cause possible | Correctif |
|---|---|---|
| Inventaire / porte-à-porte qui bug | OneSync off ou legacy | set onesync on (ou infinity) et redémarrer |
| « OneSync must be enabled » | Ressource qui exige OneSync | Activer set onesync on (ou infinity) |
| Perfs ou crash avec infinity | Build ou scripts non compatibles | Revenir à on ; mettre à jour le serveur et les ressources |
Bonnes pratiques
- Toujours utiliser on (ou infinity si supporté) pour un serveur ESX ou QBCore.
- Ne pas repasser à off sauf contrainte avérée (ressource legacy non modifiable).
- Pour le framework : esx-qbcore-setup. Pour les permissions et le durcissement : ace-fivem. Pour le serveur : fivem-windows-vps.
Ressources
Cet article s’inscrit dans notre série de guides hébergement et gaming. Pour un serveur sur-mesure, contact.