Activer OneSync sur un serveur FiveM

OneSync permet d’augmenter le nombre de joueurs connectés simultanément sur un serveur FiveM et d’améliorer la synchronisation des entités (PNJ, véhicules, etc.).
Il existe deux méthodes principales pour l’activer : via txAdmin ou directement dans le fichier server.cfg.


1. Activer OneSync via txAdmin

  1. Ouvre txAdmin depuis ton navigateur (en général : http://localhost:40120).
  2. Va dans l’onglet Settings (Paramètres).
  3. Dans la section FXServer Settings, cherche l’option OneSync.
  4. Active OneSync (Legacy, Infinity ou Plus) selon ton plan FiveM :
    • Legacy : version gratuite, limitée à 48 slots.
    • Infinity : version premium, meilleure synchronisation et plus de joueurs.
    • Plus : réservé aux serveurs FiveM Patreon Tier 3+.
  5. Clique sur Save & Restart Server pour appliquer les changements.

2. Activer OneSync via le fichier server.cfg

Si tu préfères modifier directement le fichier de configuration :

  1. Ouvre ton fichier server.cfg.
  2. Ajoute ou modifie la ligne suivante selon ton type de OneSync :
    Pour OneSync Legacy (gratuit) :
    set onesync legacy
    

    Pour OneSync Infinity :
    set onesync on
    

    Pour OneSync Plus (Patreon) :
    set onesync_enableInfinity 1
    set onesync_forceMigration 1
    
  3. Sauvegarde le fichier, puis redémarre ton serveur.

3. Vérifier que OneSync est actif

Une fois ton serveur lancé, tu peux vérifier que OneSync est bien activé :

  • Regarde dans la console du serveur : tu devrais voir une ligne indiquant
    OneSync enabled.
  • Connecte-toi et tape la commande suivante dans la console :
    onesync_status
    
    Cela devrait renvoyer OneSync status: enabled.

4. Problèmes fréquents

ProblèmeCause possibleSolution
Erreur "OneSync not enabled"Mauvaise syntaxe dans server.cfgVérifie la ligne set onesync ...
Slots limités à 32 joueursOneSync Legacy activéPasse sur OneSync Infinity (Premium)
PNJ ou véhicules désynchronisésScript incompatibleMets à jour le script ou vérifie sa compatibilité OneSync

5. Conseils supplémentaires

  • Ne mélange pas plusieurs options OneSync dans le même fichier.
  • Toujours redémarrer le serveur après toute modification de server.cfg.
  • Certains mods anciens ne sont pas compatibles avec OneSync Infinity — vérifie leur documentation.