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
- Open txAdmin in your browser (usually:
http://localhost:40120). - Go to the Settings tab.
- In the FXServer Settings section, look for the OneSync option.
- 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.
- 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:
- Open your
server.cfgfile. - 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 - 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:
It should returnonesync_statusOneSync status: enabled.
4. Common Issues
| Issue | Possible Cause | Solution |
|---|---|---|
| "OneSync not enabled" error | Incorrect syntax in server.cfg | Check the set onesync ... line |
| Player slots limited to 32 | OneSync Legacy enabled | Switch to OneSync Infinity (Premium) |
| Desynced NPCs or vehicles | Incompatible script | Update 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.


















