Skip to main content
OneSync is FiveM’s server-side sync system: the server, not the players’ PCs, keeps track of players, vehicles and objects. Set it with the onesync convar: on (recommended, formerly “Infinity”, up to 2048 players), legacy (old, not recommended) or off (up to 32 players). On FREAKHOSTING, choose it under Server config > OneSync and restart.

What does OneSync do?

Without OneSync, players’ games talk to each other and the server only passes messages on. With OneSync, the server is “state aware”: it knows where every player and entity is. This allows:
  • more than 32 players on one server,
  • server-side scripts that see players, vehicles and objects,
  • more networked objects (up to 65,535 object IDs instead of 8,192 in the on mode).
Most modern scripts and all major frameworks expect OneSync. The QBCore, Qbox and ESX Legacy txAdmin recipes set onesync on.

OneSync On vs Legacy vs Off

What is OneSync Infinity?

“OneSync Infinity” is the older name for what is now simply onesync on. In this mode the game only syncs players and vehicles within a focus zone around each player (424 units by default), which is how it supports up to 2048 players. Because far-away players are culled, scripts must loop over players on the server side, not the client side.

How to turn on OneSync

1

Open Server config

Open your server in the Game Panel and click Server config under FIVEM in the sidebar.
2

Pick a mode

Under Gameplay and security, set OneSync to On (recommended).
Gameplay and security section of the FiveM Server config page with the OneSync selector set to On (recommended), a Game build drop-down and Allow Script Hook and Hide player IP addresses toggles

The OneSync setting on the Server config page

3

Save

Click Review and save, check the change, then click Save changes. The old file is kept as server.cfg.bak.
4

Restart

Restart the server. A OneSync change only applies after a restart.
If Server config shows the check txAdmin runs this server, txAdmin uses a server.cfg in another folder. Set OneSync there instead. See how to configure server.cfg.

Do I have to buy OneSync?

No. According to Cfx.re, OneSync is free up to 48 slots. For more than 48 slots, your licence key needs a FiveM Element Club subscription from Argentum upwards, bought on portal.cfx.re. You set your player slots with Max Players in Startup. See how to change slots.

What changes for scripts with OneSync On?

If you write or edit scripts, keep these points from the Cfx.re OneSync documentation in mind:
  • Players far away are culled. A client only knows players and vehicles near it, so loops over “all players” belong on the server.
  • The culling radius is 424 units by default. Cfx.re says the natives that change it are deprecated and have known, unfixable issues.
  • Scope events (playerEnteredScope, playerLeftScope) scale poorly. Cfx.re recommends state bags for data that players near each other need.
  • Entities belong to the server’s view of the world, so server scripts can find and manage vehicles and objects.
Older scripts written for OneSync Off sometimes assume every player exists on every client. Those are the scripts that need Legacy, or better, an update.

How do I check which OneSync mode my server runs?

Open Server config and look at OneSync under Gameplay and security. It shows the value in server.cfg, or not in the file if there is no onesync line. You can also open the raw file with Advanced: open the raw file and search for onesync.

Frequently asked questions

Is OneSync on by default?

Check Server config: it shows the current OneSync value, or not in the file when server.cfg has no onesync line. Set it to On (recommended) to be sure.

Should I use OneSync Legacy?

No, unless an old script needs it. Cfx.re doesn’t recommend it because of performance issues and graphical glitches.

Why does my server stop at 48 players?

More than 48 slots needs Element Club Argentum or higher on your licence key, and Max Players set that high in Startup.

Do I need OneSync for QBCore or ESX?

Yes. Their txAdmin recipes set onesync on, and many of their scripts need it.

Can OneSync cause lag?

Rarely. Cfx.re’s documentation says the Infinity (on) mode performs slightly better than the original OneSync. Lag usually comes from scripts. See server thread hitch warnings.

FiveM server guide

Every FiveM guide in one place.

Configure server.cfg

Every Server config setting.

Change player slots

Max Players and the 48-slot limit.

Licence key

Get your key from portal.cfx.re.
Checked by the FREAKHOSTING team against the official FiveM OneSync documentation and server commands reference on 29 October 2026. Details may change when FiveM or the resource is updated.

Need Extra Help?

If you encounter any issues, our support team is ready to assist:

Save on Your Hosting

Ready to upgrade your hosting? Use code KB20 at checkout for 20% off your first order!

Last Updated: October 2026