Logo

Enable OneSync on a FiveM Server

Enable OneSync on a FiveM Server

This article helps you understand and easily activate OneSync on your FiveM server.

Enable OneSync on a FiveM Server

OneSync allows you to increase the number of players connected simultaneously on a FiveM server and improves entity synchronization (NPCs, vehicles, etc.).
There are two main ways to enable it: via txAdmin or directly in the server.cfg file.


1. Enable OneSync via txAdmin

  1. Open txAdmin in your browser (usually: http://localhost:40120).
  2. Go to the Settings tab.
  3. In the FXServer Settings section, look for the OneSync option.
  4. Enable OneSync (Legacy, Infinity, or Plus) depending on your FiveM plan:
    • Legacy: free version, limited to 48 slots.
    • Infinity: premium version, better synchronization and more players.
    • Plus: reserved for FiveM Patreon Tier 3+ servers.
  5. Click Save & Restart Server to apply the changes.

2. Enable OneSync via the server.cfg file

If you prefer to modify the configuration file directly:

  1. Open your server.cfg file.
  2. Add or edit the following line depending on your OneSync type:
    For OneSync Legacy (free):
    set onesync legacy
    

    For OneSync Infinity:
    set onesync on
    

    For OneSync Plus (Patreon):
    set onesync_enableInfinity 1
    set onesync_forceMigration 1
    
  3. Save the file, then restart your server.

3. Verify that OneSync is active

Once your server is running, you can check if OneSync is enabled:

  • Look in the server console: you should see a line saying
    OneSync enabled.
  • Connect and type the following command in the console:
    onesync_status
    
    It should return OneSync status: enabled.

4. Common Issues

IssuePossible CauseSolution
"OneSync not enabled" errorIncorrect syntax in server.cfgCheck the set onesync ... line
Player slots limited to 32OneSync Legacy enabledSwitch to OneSync Infinity (Premium)
Desynced NPCs or vehiclesIncompatible scriptUpdate the script or check its OneSync compatibility

5. Additional Tips

  • Do not mix multiple OneSync options in the same file.
  • Always restart the server after modifying server.cfg.
  • Some older mods may not be compatible with OneSync Infinity — check their documentation.

Join our Discord community server

For any questions, suggestions, or just to chat with the community, join us on Discord!

900+Members