Skip to main content

Enable OneSync

This guide explains how to enable OneSync on your FiveM server via txAdmin or server.cfg.

What is OneSync?​

OneSync is a network synchronization technology that allows:

  • More than 32 players on the server
  • Better entity synchronization
  • Improved performance

Important

If you use txAdmin, you must use it to enable OneSync.

Steps​

  1. Log in to your txAdmin
  2. Go to Settings
  3. Click on FxServer
  4. Find the OneSync option
  5. Select the desired mode:
    • Legacy: Recommended for most servers
    • On: Standard mode
    • Infinity: For very large servers (2048+ players)
  6. Click Save
  7. Restart your server
Which mode to choose?

In general, use Legacy. The mode depends on your base, number of players, and resources.


Method 2: Enable via server.cfg​

If you don't use txAdmin, you can enable OneSync directly in the server.cfg file.

OneSync Legacy​

Add this line to your server.cfg:

set onesync legacy

OneSync On (Standard)​

set onesync on

OneSync Infinity​

set onesync infinity

OneSync Modes​

ModeDescriptionMax players
offDisabled32
legacyOneSync Legacy (recommended)64
onOneSync standard64
infinityOneSync Infinity2048+

Advanced configuration​

Add these lines to your server.cfg to customize OneSync:

# Ambient population
set onesync_population true

# Vehicle culling distance
setr onesync_distanceCullVehicles 500

# General culling distance
setr onesync_distanceCulling 500

Compatibility​

Some resources are not compatible with OneSync. Check:

  • Vehicle scripts
  • NPC scripts
  • Spawn systems
OneSync Infinity

OneSync Infinity requires a Cfx.re Patreon license.


Common problems​

ProblemSolution
Desynchronized playersCheck resource compatibility
Entities disappearAdjust onesync_distanceCulling
Reduced performanceSwitch from Infinity to Legacy
info

After modifying OneSync settings, always restart your server.