FiveM server.cfg regel voor regel uitgelegd (inclusief OneSync)

server.cfg is het belangrijkste configuratiebestand van een FiveM-server: het bepaalt de poort, de naam in de serverlijst, de license key, de game build, OneSync, welke resources starten en de rechten van admins. We lopen het regel voor regel door en leggen bij elke instelling uit wat die doet en welke waarde je kiest.

Waar je server.cfg vindt#

• Server met txAdmin: server.cfg staat in de map die je bij het deployen van het recept hebt gekozen (txAdmin stelt daarvoor txData/<NAME>_<CODE>.base voor). Je bewerkt het bestand het makkelijkst in txAdmin via CFG Editor in het linkermenu, opslaan doe je met Ctrl+S. Het pad vind je in txAdmin onder Settings › FXServer (het veld Server Data Folder, het veld CFG File Path zie je nadat je de geavanceerde opties hebt weergegeven).
• Server zonder txAdmin: server.cfg staat in de hoofdmap van de server. Je bewerkt het in je klantaccount op het tabblad Bestanden (handleiding).

Wijzigingen in server.cfg worden pas actief na een herstart van de server.

Hoe server.cfg wordt gelezen#

• Het bestand wordt van boven naar beneden gelezen, regel voor regel. Elke regel is één commando van de serverconsole.
• Tekst na # is commentaar en wordt door de server genegeerd. Je zet een regel “uit” door er # voor te zetten.
• Zet waarden met spaties tussen aanhalingstekens: sv_hostname "Muj server".
• Staat dezelfde instelling twee keer in het bestand, dan geldt de laatste.
• Met het commando exec bestand.cfg laad je nog een configuratiebestand (bijvoorbeeld exec permissions.cfg). Handig om het overzichtelijk te houden.

Variabelen (convars) stel je in met drie commando's:

Voorbeeld van een server.cfg#

Het voorbeeld is gebaseerd op de standaardconfiguratie van FiveM en de recepten van txAdmin. De afzonderlijke blokken lichten we hieronder toe.

# --- Netwerk ---
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
sv_maxclients 48
sv_endpointPrivacy true

# --- Serverlijst ---
sv_hostname "Muj RP server"
sets sv_projectName "Muj RP server"
sets sv_projectDesc "Tsjechische roleplayserver met eigen scripts"
sets tags "roleplay, czech, esx"
sets locale "cs-CZ"
load_server_icon logo.png
#sv_master1 ""

# --- Sleutels ---
sv_licenseKey "<LICENSE_KEY>"
set steam_webApiKey "none"

# --- Spel en beveiliging ---
sv_enforceGameBuild 3258
sv_scriptHookAllowed 0
sv_enableNetworkedSounds false
sv_enableNetworkedScriptEntityStates false
sv_filterRequestControl 2

# --- OneSync (alleen zonder txAdmin, zie hieronder) ---
set onesync on

# --- Database ---
set mysql_connection_string "mysql://<USER>:<PASSWORD>@<DATABASE_IP>:3306/<DATABASE_NAME>"

# --- Resources ---
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
ensure oxmysql
ensure [standalone]

# --- Rechten ---
add_ace group.admin command allow
add_ace group.admin command.quit deny
add_principal identifier.fivem:<FIVEM_ID> group.admin

Vervang de waarden tussen punthaken door je eigen gegevens (haal de haken weg): <LICENSE_KEY> is de sleutel uit de Cfx.re Portal, de databasegegevens vind je op het tabblad Databases, <FIVEM_ID> is het numerieke ID van je Cfx.re-account (hoe je dat vindt, staat in het gedeelte over rechten).

Netwerk en slots#

30120 is de standaardpoort van FiveM. Bij ons heeft je server de poort die je op het tabblad Netwerk ziet, en die moet in beide endpoint_add_*-regels staan. Let op na het deployen met een txAdmin-recept: als txAdmin de poort van de server niet kent, schrijft het juist de standaardwaarde 30120 naar server.cfg. Controleer de poort en pas hem zo nodig aan.

Naam en serverlijst#

sets sv_projectName en sets sv_projectDesc zijn verplicht. Als ze ontbreken, geeft de server bij het opstarten een foutmelding en verschijnt hij mogelijk niet in de lijst.

Kleuren in de naam schrijf je met de codes ^0 tot en met ^9 (bijvoorbeeld ^1 voor rood). Overdrijf het niet, een te “versierde” naam kan door de serverlijst worden ingekort.

Sleutels#

Spel en beveiliging#

Een selectie van game builds (elke build bevat ook alle oudere DLC's):

De volledige en actuele lijst staat in de documentatie van FiveM (link onderaan). Een hogere build betekent een grotere download voor spelers bij hun eerste verbinding.

OneSync#

OneSync is het synchronisatiesysteem van FiveM: de server kent de positie en de status van alle spelers en entiteiten (auto's, personages, objecten) en bepaalt zelf wat hij naar wie stuurt. Daardoor kan hij meer spelers aan en kunnen scripts rechtstreeks op de server met entiteiten werken. Moderne frameworks (ESX Legacy, QBCore, Qbox) vereisen OneSync.

Limieten voor slots:

• OneSync is gratis tot 48 slots. Voor meer slots heb je een abonnement FiveM Element Club Argentum of hoger nodig op de Cfx.re Portal (opent in een nieuw venster).
• sv_maxclients van 32 of meer vereist OneSync on of legacy, meer dan 64 alleen on.
• Het abonnement verhoogt het aantal slots niet vanzelf. Na de aankoop moet je sv_maxclients verhogen en de server herstarten.

Waar je OneSync inschakelt:

• Met txAdmin: alleen in txAdmin, Settings › FXServer › geavanceerde opties › OneSync (aanbevolen: OneSync On). Regels met set onesync in server.cfg commentarieert txAdmin zelf uit, met de opmerking onesync MUST only be set in the txAdmin settings page.
• Zonder txAdmin: met de regel set onesync on in server.cfg.

Het platform FiveM for GTAV Enhanced gebruikt geen synchronisatie via spelers (P2P) meer, het spel loopt altijd via de server.

Resources en de volgorde van ensure#

Resources starten in de volgorde waarin ze in het bestand staan. Daarom:

1. Bovenaan de standaardresources van FiveM (mapmanager, chat, spawnmanager …).
2. Daarna de bibliotheken waar de rest van afhangt: oxmysql, ox_lib.
3. Daarna de kern van het framework (es_extended, qb-core, qbx_core).
4. Tot slot de scripts van het framework en je eigen scripts.

Staat een script vóór zijn afhankelijkheid, dan start het niet. Details staan in de handleiding FiveM resources.

ACE-rechten#

FiveM heeft een ingebouwd rechtensysteem (ACL). Het bestaat uit twee commando's:

add_ace group.admin command allow
add_ace group.admin command.quit deny
add_principal identifier.fivem:<FIVEM_ID> group.admin

• add_ace group.admin command allow – de groep group.admin mag alle commando's gebruiken (command is het algemene recht op commando's).
• add_ace group.admin command.quit deny – behalve het commando quit, dat de server uitschakelt.
• add_principal identifier.fivem:<FIVEM_ID> group.admin – de speler met deze identifier hoort bij de groep group.admin en erft de rechten ervan.

In het algemeen: add_ace <WHO> <WHAT> allow|deny geeft een recht, add_principal <WHO> <GROUP> plaatst een speler in een groep. De omgekeerde commando's zijn remove_ace en remove_principal. Of iemand een recht heeft, controleer je in de console met het commando test_ace <WHO> <WHAT>.

Identifiers van spelers:

De identifiers van een bepaalde speler vind je in txAdmin: Players, klik op de speler en open het tabblad IDs. Het toevoegen van de admin doet txAdmin zelf (de regel {{addPrincipalsMaster}} in het recept). Frameworks hebben hun eigen admingroepen, zie ESX, QBCore of Qbox?.

Controle#

1. Sla server.cfg op en herstart de server.
2. Controleer in de console (klantaccount of Live Console in txAdmin) of er bij het opstarten geen fouten zijn verschenen en of de resources zijn gestart (Started resource …).
3. Open in je browser http://<IP_ADDRESS>:<PORT>/info.json (het adres van het tabblad Netwerk). Je ziet JSON met de openbare instellingen van de server, waaronder de waarden die met sets zijn ingesteld (sv_projectName, locale, tags).
4. Controleer de server met de tool CFX Resolver: die toont de naam, de slots, OneSync en de afgedwongen build.

Als iets niet werkt#

Meldingen die je hier niet vindt, zoek je op in het overzicht Veelvoorkomende fouten van een FiveM-server.

De server staat niet in de serverlijst of is “privé”#

• De regel sv_master1 "" mag niet actief zijn. Commentarieer hem uit met #.
• Controleer of je zowel sets sv_projectName als sets sv_projectDesc hebt.
• Na het opstarten kan het tot 8 minuten duren voordat de server in de lijst verschijnt.
• Controleer of je rechtstreeks met de server kunt verbinden: in het spel F8 en connect <IP_ADDRESS>:<PORT>.

Connection rejected by server: Client/Server game build revision mismatch#

De speler en de server hebben een verschillende revisie van de build, meestal kort na een update van het spel. Update de artifacts van de server (handleiding). Spelers kunnen in de FiveM-client het Update Channel omzetten (tandwiel › Game).

Spelers doen er lang over om te verbinden of blijven hangen bij het downloaden#

Na een wijziging van sv_enforceGameBuild downloadt elke speler de DLC-gegevens. Dat gebeurt maar één keer. Blijven spelers herhaaldelijk hangen, controleer dan of de build bestaat (tabel hierboven) en of je geen typfout hebt gemaakt.

In server.cfg is een regel ## [txAdmin CFG validator]: … verschenen#

txAdmin heeft een regel uitgecommentarieerd die niet in server.cfg mag staan en heeft de reden achter de dubbele punt gezet. Meestal is dat onesync MUST only be set in the txAdmin settings page. (OneSync hoort in de instellingen van txAdmin) of you MUST NOT start/stop/ensure txadmin resources. (txAdmin start vanzelf, verwijder ensure monitor).

Meer dan 48 slots instellen lukt niet#

Zonder een abonnement Element Club Argentum is de limiet 48. Bij een server zonder txAdmin kan het aantal slots ook worden bepaald door een variabele op het tabblad Instellingen › Variabelen.

Een wijziging is na een herstart teruggedraaid#

Je hebt een regel aangepast die bij het opstarten wordt overschreven door een variabele van het tabblad Instellingen, of een ander bestand dan het bestand dat de server laadt. Controleer bij txAdmin CFG File Path onder Settings › FXServer.

Meer bronnen#

• FiveM: Server Commands (opent in een nieuw venster)
• FiveM: OneSync (opent in een nieuw venster)
• FiveM: Convars (set, setr, sets) (opent in een nieuw venster)
• FiveM: Server Issues (opent in een nieuw venster)