FiveM

How to enable OneSync and choose the game build of your FiveM server

Check OneSync, choose the game build with sv_enforceGameBuild and confirm both settings on a Winheberg FiveM server, with or without txAdmin. Error messages and fixes.

November 1, 2026 Winheberg
Documentation›FiveM›How to enable OneSync and choose the game build of your FiveM server

Context

Two settings shape what your FiveM server can do. OneSync is the sync system that lets the server track the state of every player and entity, and host more players than it could without OneSync. Many recent resources need it to start, such as ox_lib, ox_inventory or the Qbox framework. The game build sets which version of GTA V your players load, and therefore which vehicles, maps and content from GTA Online updates are available on your server.

This guide shows you how to check OneSync and choose the game build of your Winheberg FiveM server, with or without txAdmin, then how to make sure both settings are applied.

Prerequisites

1. Find out whether your server uses txAdmin

Where you set OneSync depends on whether your server uses txAdmin. In the panel, open Startup and look at the ENABLE TXADMIN switch.

ENABLE TXADMIN switch in the Startup tab of the Winheberg panel
Where each option is set
ENABLE TXADMIN OneSync Game build
False server.cfg file server.cfg file
True txAdmin Settings page server.cfg file managed by txAdmin

To switch from one mode to the other, follow our guide "How to enable txAdmin on your FiveM server?".

2. Check that OneSync is enabled

On recent artifacts, OneSync is enabled by default in on mode. In most cases there is nothing to change. Just make sure no setting turns it off.

Open Files, then the server.cfg file at the root of the server. The file created by Winheberg already contains the following line, near the end. If it says off or legacy, change the value to on. If the line is gone, OneSync stays enabled by default, but you can add it back so the setting is visible.

set onesync on
set onesync on and sv_enforceGameBuild lines in the server.cfg file

Click Save Content, then restart the server from Console.

As long as a onesync line is in server.cfg, the console shows this message on startup. You can ignore it. Despite what it says, the value on the line is applied.

Warning: 'onesync' is an internal ConVar and cannot be changed.
The three OneSync modes
Value Effect
on Recommended mode, the server knows the state of everyone and can host up to 2048 players depending on your subscription
legacy Compatibility mode for older scripts, discouraged by Cfx.re (performance issues and graphical glitches)
off No OneSync, the server only acts as a relay between players

The free License Key allows up to 48 players with OneSync. Beyond that, you need a FiveM Element Club Argentum subscription or higher on the Cfx.re portal. Then simply raise the MAX PLAYERS variable in Startup.

3. Choose the game build

The game build is set with the sv_enforceGameBuild line in server.cfg. Without txAdmin, this is the server.cfg at the root of the server. With txAdmin, open the file from CFG Editor in the txAdmin menu. Add the line with the build number you want, for example right under set onesync on, or edit it if it is already there.

sv_enforceGameBuild 3751

Each build includes all the content of the previous builds. Here are the main ones, with the name of the GTA Online update they bring.

Game builds available for FiveM
Build GTA Online update
1 Base game without DLC
1604 Arena War
2060 Los Santos Summer Special
2189 Cayo Perico Heist
2372 Los Santos Tuners
2545 The Contract
2699 The Criminal Enterprises
2802 Los Santos Drug Wars
2944 San Andreas Mercenaries
3095 The Chop Shop
3258 Bottom Dollar Bounties
3407 Agents of Sabotage
3570 Money Fronts
3751 A Safehouse in the Hills
3889 The Kortz Center Heist

The game build is only applied when the server starts. After each change, save the file then fully restart the server. The next time they connect, your players automatically load the content of the chosen build.

Always set a specific build. Without the sv_enforceGameBuild line, the server loads the default build of your artifacts, which is not necessarily the latest one (3258 in our tests) and can change after an artifacts update. Resources that expect a given build can then stop working.

If your server runs FiveM for GTAV Enhanced, only the latest build is available, and it is loaded by default. You can still set the value 1 to go back to the base game without DLC. On this version, OneSync is always enabled.

4. Check that the settings are applied

Once the server has started, open the following address in your browser. Replace ADDRESS:PORT with the address shown at the top of your server's page in the panel, in the gm1-whXX.wh-game.fr:30XXX format.

http://ADDRESS:PORT/info.json

The server answers with its public settings, on a single line. Look for these two values with Ctrl+F.

"onesync_enabled":"true"
"sv_enforceGameBuild":"3751"

onesync_enabled is true when OneSync is enabled, and sv_enforceGameBuild shows the build the server actually loaded.

If you run into trouble

When a resource does not get the OneSync setting or game build it needs, the console shows a red error at server startup and the resource is not started.

Winheberg panel console showing Resource can't run errors related to OneSync and the game build

❌ A resource refuses to start because of OneSync

The console shows this message when the resource starts, here with ox_lib.

Resource 'ox_lib' can't run:
  1. onesync: OneSync needs to be enabled
Couldn't start resource ox_lib.
  • Set OneSync to on by following step 2
  • With txAdmin, check the setting in Settings. A onesync line in server.cfg has no effect, since txAdmin comments it out
  • Fully restart the server

❌ A resource asks for a more recent game build

Some resources set a minimum build in their fxmanifest.lua, for example /gameBuild:h4 for build 2189. If your build is older, the console shows a message like this one.

Resource 'vehicle_pack' can't run:
  1. gameBuild(3889): sv_enforceGameBuild needs to be at least 3889 (current is 3751)
  • Raise the sv_enforceGameBuild value to the requested build or higher
  • Restart the server

❌ Players can no longer join after a build change

The server accepts any number in sv_enforceGameBuild, without showing an error on startup. A typo therefore goes unnoticed on the server side.

  • Check that the value is in the official list of game builds (FiveM documentation, Server Commands page)
  • Check the value actually loaded with info.json (step 4)
  • Update the artifacts from the Artifacts tab of the panel if you are aiming for a very recent build

❌ Unable to go beyond 48 players

  • Check that your Cfx.re account has a FiveM Element Club Argentum subscription or higher
  • Check that OneSync is set to on, legacy mode cannot go beyond 64 players
  • Raise MAX PLAYERS in Startup, then restart

Best practices

  • Choose the game build before installing your resources, then stick with it, since changing builds can alter the available vehicles and maps
  • Keep OneSync set to on, since Cfx.re considers the legacy and off modes deprecated
  • Update your artifacts regularly, recent builds are only recognized by recent artifacts
  • Take a backup from the Backups tab before editing server.cfg

Need help?

If a resource still refuses to start, our team can help. Open a ticket in the Technical department from your client area, fill in the Related Product field with the server in question, and include the message shown in the console.

Your FiveM server is ready for the latest resources 🎮

Need a FiveM server?

Discover our offers tailored to your needs and get started now.

View offers