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.