FiveM server.cfg Zeile für Zeile erklärt (einschließlich OneSync)

Die server.cfg ist die Hauptkonfigurationsdatei eines FiveM-Servers: Sie legt Port, Namen in der Serverliste, License Key, Game Build, OneSync, die zu startenden Resources und die Admin-Berechtigungen fest. Wir gehen sie Zeile für Zeile durch und erklären zu jeder Einstellung, was sie tut und welchen Wert Sie wählen sollten.

Wo Sie die server.cfg finden#

• Server mit txAdmin: Die server.cfg liegt in dem Ordner, den Sie beim Deployment des Rezepts gewählt haben (txAdmin schlägt txData/<NAME>_<CODE>.base vor). Am einfachsten bearbeiten Sie sie im CFG Editor im linken Menü von txAdmin; speichern mit Strg+S. Den Pfad finden Sie in txAdmin unter Settings › FXServer (Feld Server Data Folder; das Feld CFG File Path erscheint, wenn Sie die erweiterten Optionen einblenden).
• Server ohne txAdmin: Die server.cfg liegt im Hauptordner des Servers. Bearbeiten Sie sie im Kundenbereich in der Registerkarte Dateien (Anleitung).

Änderungen an der server.cfg wirken erst nach einem Neustart des Servers.

Wie die server.cfg gelesen wird#

• Die Datei wird von oben nach unten gelesen, Zeile für Zeile. Jede Zeile ist ein Befehl für die Serverkonsole.
• Text nach # ist ein Kommentar, den der Server ignoriert. Eine Zeile „schalten Sie aus“, indem Sie # an ihren Anfang setzen.
• Werte mit Leerzeichen setzen Sie in Anführungszeichen: sv_hostname "Muj server".
• Kommt dieselbe Einstellung zweimal in der Datei vor, gewinnt die letzte.
• Der Befehl exec datei.cfg lädt eine weitere Konfigurationsdatei (zum Beispiel exec permissions.cfg). Praktisch, um Ordnung zu halten.

Variablen (Convars) werden mit drei Befehlen gesetzt:

Beispiel-server.cfg#

Dieses Beispiel basiert auf der Standardkonfiguration von FiveM und den txAdmin-Rezepten. Jeder Block wird unten erklärt.

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

# --- Serverliste ---
sv_hostname "Muj RP server"
sets sv_projectName "Muj RP server"
sets sv_projectDesc "Roleplay-Server mit eigenen Skripten"
sets tags "roleplay, deutsch, esx"
sets locale "de-DE"
load_server_icon logo.png
#sv_master1 ""

# --- Schlüssel ---
sv_licenseKey "<LICENSE_KEY>"
set steam_webApiKey "none"

# --- Spiel und Sicherheit ---
sv_enforceGameBuild 3258
sv_scriptHookAllowed 0
sv_enableNetworkedSounds false
sv_enableNetworkedScriptEntityStates false
sv_filterRequestControl 2

# --- OneSync (nur ohne txAdmin, siehe unten) ---
set onesync on

# --- Datenbank ---
set mysql_connection_string "mysql://<BENUTZER>:<PASSWORT>@<DATENBANK_IP>:3306/<DATENBANKNAME>"

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

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

Ersetzen Sie die Werte in spitzen Klammern durch Ihre eigenen Angaben (Klammern löschen): <LICENSE_KEY> ist der Schlüssel aus dem Cfx.re Portal, die Datenbankdaten stehen in der Registerkarte Datenbank, und <FIVEM_ID> ist die numerische ID Ihres Cfx.re-Kontos (wie Sie sie finden, erklärt der Abschnitt zu Berechtigungen).

Netzwerk und Slots#

30120 ist der Standardport von FiveM. Auf unseren Servern ist der Port Ihres Servers der, den Sie in der Registerkarte Netzwerk sehen, und er muss in beiden endpoint_add_*-Zeilen stehen. Vorsicht nach dem Deployment mit einem txAdmin-Rezept: Wenn txAdmin den Port des Servers nicht kennt, schreibt es den Standard 30120 in die server.cfg. Prüfen Sie ihn und ändern Sie ihn bei Bedarf.

Name und Serverliste#

sets sv_projectName und sets sv_projectDesc sind Pflicht. Fehlen sie, gibt der Server beim Start einen Fehler aus und erscheint möglicherweise nicht in der Liste.

Farben im Namen schreiben Sie mit den Codes ^0 bis ^9 (zum Beispiel ^1 für Rot). Übertreiben Sie es nicht; die Serverliste kürzt einen übermäßig „verzierten“ Namen möglicherweise.

Schlüssel#

Spiel und Sicherheit#

Ausgewählte Game Builds (jeder enthält auch alle älteren DLCs):

Die vollständige, aktuelle Liste steht in der FiveM-Dokumentation (Link unten). Ein höherer Build bedeutet einen größeren Download für Spieler beim ersten Verbinden.

OneSync#

OneSync ist das Synchronisationssystem von FiveM: Der Server kennt Position und Zustand aller Spieler und Entitäten (Autos, Peds, Objekte) und entscheidet selbst, was er wem sendet. Dadurch kann er mehr Spieler bewältigen, und Skripte können direkt auf dem Server mit Entitäten arbeiten. Moderne Frameworks (ESX Legacy, QBCore, Qbox) erfordern OneSync.

Slot-Grenzen:

• OneSync ist bis 48 Slots kostenlos. Mehr Slots erfordern ein Abonnement FiveM Element Club Argentum oder höher im Cfx.re Portal (öffnet sich in einem neuen Fenster).
• sv_maxclients ab 32 erfordert OneSync on oder legacy; mehr als 64 erfordert on.
• Das Abonnement allein erhöht die Slot-Anzahl nicht. Nach dem Kauf müssen Sie sv_maxclients erhöhen und den Server neu starten.

Wo Sie OneSync einschalten:

• Mit txAdmin: nur in txAdmin, Settings › FXServer › erweiterte Optionen › OneSync (OneSync On empfohlen). txAdmin kommentiert alle set onesync-Zeilen in der server.cfg selbst aus, mit dem Hinweis onesync MUST only be set in the txAdmin settings page.
• Ohne txAdmin: mit der Zeile set onesync on in der server.cfg.

Die Plattform FiveM for GTAV Enhanced verwendet keine Peer-to-Peer-Synchronisation (P2P) mehr; das Spiel läuft immer über den Server.

Resources und ensure-Reihenfolge#

Resources starten in der Reihenfolge, in der sie in der Datei stehen. Also:

1. Standard-FiveM-Resources ganz oben (mapmanager, chat, spawnmanager …).
2. Dann die Bibliotheken, von denen die anderen abhängen: oxmysql, ox_lib.
3. Dann der Framework-Kern (es_extended, qb-core, qbx_core).
4. Zuletzt die Framework-Skripte und Ihre eigenen Skripte.

Steht ein Skript vor seiner Abhängigkeit, startet es nicht. Details in FiveM-Resources.

ACE-Berechtigungen#

FiveM hat ein eingebautes Berechtigungssystem (ACL). Es besteht aus zwei Befehlen:

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 – die Gruppe group.admin darf alle Befehle verwenden (command ist die allgemeine Berechtigung für Befehle).
• add_ace group.admin command.quit deny – außer dem Befehl quit, der den Server herunterfährt.
• add_principal identifier.fivem:<FIVEM_ID> group.admin – der Spieler mit diesem Identifikator gehört zur Gruppe group.admin und erbt ihre Berechtigungen.

Allgemein: add_ace <WER> <WAS> allow|deny erteilt eine Berechtigung, und add_principal <WER> <GRUPPE> ordnet einen Spieler einer Gruppe zu. Die Gegenbefehle sind remove_ace und remove_principal. Ob jemand eine Berechtigung hat, prüfen Sie mit dem Befehl test_ace <WER> <WAS> in der Konsole.

Spieler-Identifikatoren:

Die Identifikatoren eines bestimmten Spielers finden Sie in txAdmin: Players, auf den Spieler klicken und die Registerkarte IDs öffnen. txAdmin fügt den Admin selbst hinzu (die Zeile {{addPrincipalsMaster}} im Rezept). Frameworks haben eigene Admin-Gruppen, siehe ESX, QBCore oder Qbox?.

Überprüfung#

1. Speichern Sie die server.cfg und starten Sie den Server neu.
2. Prüfen Sie in der Konsole (Kundenbereich oder Live Console in txAdmin), dass beim Start keine Fehler erschienen sind und die Resources gestartet sind (Started resource …).
3. Öffnen Sie http://<IP_ADRESSE>:<PORT>/info.json in Ihrem Browser (Adresse aus der Registerkarte Netzwerk). Sie sehen JSON mit den öffentlichen Einstellungen des Servers, einschließlich der mit sets gesetzten Werte (sv_projectName, locale, tags).
4. Prüfen Sie den Server mit dem Werkzeug CFX Resolver: Es zeigt Name, Slots, OneSync und den erzwungenen Build.

Fehlerbehebung#

Meldungen, die Sie hier nicht finden, schlagen Sie in Häufige Fehler des FiveM-Servers nach.

Der Server ist nicht in der Serverliste oder wird als „privat“ angezeigt#

• Die Zeile sv_master1 "" darf nicht aktiv sein. Kommentieren Sie sie mit # aus.
• Prüfen Sie, dass Sie sowohl sets sv_projectName als auch sets sv_projectDesc haben.
• Es kann nach dem Start bis zu 8 Minuten dauern, bis der Server in der Liste erscheint.
• Prüfen Sie, dass Sie sich direkt mit dem Server verbinden können: Drücken Sie im Spiel F8 und geben Sie connect <IP_ADRESSE>:<PORT> ein.

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

Spieler und Server haben unterschiedliche Build-Revisionen, typischerweise kurz nach einem Spielupdate. Aktualisieren Sie die Server-Artifacts (Anleitung). Spieler können im FiveM-Client den Update Channel umstellen (Zahnradsymbol › Game).

Spieler brauchen lange zum Verbinden oder bleiben beim Download hängen#

Nachdem Sie sv_enforceGameBuild geändert haben, lädt jeder Spieler die DLC-Daten herunter. Das passiert nur einmal. Bleiben sie wiederholt hängen, prüfen Sie, dass der Build existiert (Tabelle oben) und kein Tippfehler vorliegt.

In der server.cfg ist eine Zeile ## [txAdmin CFG validator]: … erschienen#

txAdmin hat eine Zeile auskommentiert, die in der server.cfg nicht erlaubt ist, und den Grund hinter den Doppelpunkt geschrieben. Meist ist es onesync MUST only be set in the txAdmin settings page. (OneSync gehört in die txAdmin-Einstellungen) oder you MUST NOT start/stop/ensure txadmin resources. (txAdmin startet von selbst; löschen Sie ensure monitor).

Sie können nicht mehr als 48 Slots einstellen#

Ohne Abonnement Element Club Argentum liegt die Grenze bei 48. Auf einem Server ohne txAdmin kann die Slot-Anzahl auch von einer Variable in der Registerkarte Einstellungen › Variablen gesteuert werden.

Eine Änderung wurde nach einem Neustart zurückgesetzt#

Sie haben eine Zeile bearbeitet, die eine Variable aus der Registerkarte Einstellungen beim Start überschreibt, oder eine andere Datei als die, die der Server lädt. Prüfen Sie bei txAdmin CFG File Path unter Settings › FXServer.

Weiterführende Links#

• FiveM: Server Commands (öffnet sich in einem neuen Fenster)
• FiveM: OneSync (öffnet sich in einem neuen Fenster)
• FiveM: Convars (set, setr, sets) (öffnet sich in einem neuen Fenster)
• FiveM: Server Issues (öffnet sich in einem neuen Fenster)