Die server.cfg Datei ist das Herzstück jedes FiveM Servers. Sie definiert, wie dein Server funktioniert: Slots, Netzwerk, Game-Build, OneSync, Logging und Sichtbarkeit in der Serverliste. Dieser Guide richtet sich an Serverbetreiber und Entwickler, die sichere Standardkonfigurationen, Production-Hardening und Performance-Best-Practices wollen. Erstelle immer Backups und nutze Versionskontrolle. Wenn du neu dabei bist, starte mit unserem Guide: Wie man einen FiveM Server erstellt. Für tiefere Optimierungen, sieh dir unser Performance-Hub an.

Dieser Guide ist Teil unseres vollständigen FiveM Server-Management-Hubs, der alles vom ersten Setup bis zum Skalieren deiner Community abdeckt.

---

Auf dieser Seite

• TL;DR: Production-ready Baseline (kommentiert)
  • Minimale Dev-Konfiguration
  • Gehärtete Production-Konfiguration
  • Serverinformationen & Listing
  • Netzwerk & Slots
  • Game-Build & Artifacts
  • OneSync-Konfiguration
  • Ressourcen-Startreihenfolge & Abhängigkeiten
  • Sicherheit & Missbrauchs-Hardening
  • CDN & Asset-Streaming
  • Mythen & veraltete Flags
  • Validierung & Fehlerbehebung
  • Interne Ressourcen & nächste Schritte
  • FAQ

---

TL;DR: Production-ready Baseline (kommentiert)

Eine saubere server.cfg ist die Grundlage der Stabilität. Hier sind zwei Beispiele: eine minimale Dev-Konfiguration und eine gehärtete Production-Konfiguration.

Minimale Dev-Konfiguration

# server.cfg (Development)

Basiskonfiguration für lokale Tests

Netzwerk

endpoint_add_tcp "0.0.0.0:30120"   # TCP-Port-Binding
endpoint_add_udp "0.0.0.0:30120"   # UDP-Port-Binding

Serverinfo

sv_hostname "Mein Dev Server" sv_maxclients 8

OneSync

set onesync on

Ressourcen (Basisbeispiel)

ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure baseevents

Berechtigungen (Standard-ACL)

exec permissions.cfg

Gehärtete Production-Konfiguration

# server.cfg (Production)

Netzwerk

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

Sicherheit

sv_endpointPrivacy true # IP in Serverliste verstecken sv_scriptHook 0 # Client-Mods deaktivieren rcon_password "StarkesPwd123" # Deaktivieren wenn nicht benötigt

Slots

sv_maxclients 64 # An Host-Kapazität anpassen

Game-Build (neueste empfohlene Version verwenden)

sv_enforceGameBuild 2944 # Oder Alias: "mp2024_02"

Projektinfo

sv_hostname "FIVEMX Roleplay | Serious RP" sets sv_projectName "FIVEMX RP Server" sets sv_projectDesc "Realistisches RP mit QBCore & Custom Scripts" sets tags "roleplay, seriousrp, qbcore" sets locale "de-DE" load_server_icon mylogo.png sets banner_detail "https://cdn.example.com/banner.png" sets banner_connecting "https://cdn.example.com/loading.png"

OneSync

set onesync on

Ressourcen (Ressourcenliste verwenden)

exec resources.cfg

Logging & ACL

set sv_logLevel 2

exec permissions.cfg

txAdmin-Integration

set mysql_connection_string "mysql://user:pass@localhost/fivemdb"

Tipp: Validiere deine Konfiguration nach Änderungen immer mit txAdmin Health-Checks und Console-Logs. Siehe txAdmin Logs.

---

Serverinformationen & Listing

Die folgenden Convars steuern, wie dein Server im Server-Browser und der API erscheint:	Convar	Zweck
Beispiel	Wann ändern	Hinweise
sv_hostname	Öffentlicher Name in der Serverliste	sv_hostname "Mein RP Server [DE]"
Immer setzen	Sonderzeichen vermeiden	sets sv_projectName
Interner Projektanzeigename	sets sv_projectName "MyCommunityRP"	Branding, Multi-Server-Setups
Nur im Listen-UI sichtbar	sets sv_projectDesc	Beschreibung in der Liste
sets sv_projectDesc "QBCore RP Server"	Regeln, Sprache, Features hinzufügen	< 100 Zeichen halten
sets tags	Serverlisten-Tags	sets tags "roleplay, cars, qbcore"
Auffindbarkeit verbessern	Nur offizielle Tags verwenden	sets locale
Standardsprache	sets locale "de-DE"	Serversprache anpassen
Falsche Locale kann Server verstecken	sv_endpointPrivacy	Öffentliche IP im Browser verstecken
sv_endpointPrivacy true	Für Production empfohlen	Spieler verbinden via Cfx Relay
load_server_icon	96×96 PNG Icon	load_server_icon mylogo.png
Für Branding	Muss quadratisch sein, max. 96×96 Pixel	sets banner_detail
Großes Banner in der Serverliste	sets banner_detail "url"	Optional, aber empfohlen
Muss HTTPS-URL sein	sets banner_connecting	Banner beim Verbinden
sets banner_connecting "url"	Gut für Branding/Loading	CDN verwenden für schnelles Laden

---

Netzwerk & Slots

FiveM-Server verwenden TCP/UDP-Endpoints. Standardmäßig wird Port 30120 genutzt.

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

sv_maxclients 64

• Mehrere Server auf einer Maschine mit Port-Offsets betreiben: z.B. 30121, 30122.
• Firewall-Regeln anpassen, um TCP/UDP-Ports zu öffnen.
• sv_maxclients beeinflusst direkt CPU- & RAM-Auslastung – nicht höher als die Hardware verkraften kann. Siehe Server-Hosting-Anbieter

Warnung: MySQL oder RCON-Ports niemals ins Internet exponieren.

---

Game-Build & Artifacts

Jeder Server-Build (Artifact) entspricht einem GTA V Game-Build. Immer einen spezifischen Build pinnen, um unerwartete Änderungen zu vermeiden.

# Beispiel: Build 2944 erzwingen (Los Santos Drug Wars Update) sv_enforceGameBuild 2944

oder Alias verwenden

enforce_game_build mp2024_02

• Setze den Build in server.cfg oder in txAdmin → Einstellungen → FXServer → Zusätzliche Argumente:

+set sv_enforceGameBuild 2944

• Neueste Artifacts von runtime.fivem.net herunterladen (Windows) oder der Linux-Build-Seite.
• Client- und Server-Builds niemals mischen.

Server optimieren

---

OneSync-Konfiguration

Screenshot einer server.cfg

OneSync aktiviert serverseitigen Entity-Sync: mehr Spieler, genaue Zustände, besseres Streaming. Immer OneSync on für moderne Frameworks (QBCore, ESX) verwenden.

Einstellung	Effekt	Typischer Wert	Einfluss auf CPU/Memory
onesync	Aktiviert OneSync	on	Höhere CPU-Auslastung
onesync_population	Steuert lokale NPCs/Traffic	on (optional)	Erhöht CPU-Last
onesync_distanceCullVehicles	Streamt Fahrzeuge effizient	true	Bessere Perf, spart Bandbreite

Tipp: sv_maxclients mit Hardware skalieren. Resmon Guide nutzen, um Ressourcen-Impact zu messen.

---

Ressourcen-Startreihenfolge & Abhängigkeiten

Ressourcen werden in der durch ensure definierten Reihenfolge geladen. Immer Abhängigkeiten zuerst starten.

# resources.cfg (separate Datei)

ensure oxmysql
ensure qb-core
ensure qb-adminmenu
ensure qb-inventory
ensure qb-policejob
ensure my-custom-scripts

In server.cfg:

exec resources.cfg

• Frameworks und DB-Konnektoren immer zuerst laden.
• Verwandte Ressourcen gruppieren.
• ensure * in Production vermeiden – verursacht nicht-deterministischen Ladeort.

---

Sicherheit & Missbrauchs-Hardening

Eine sichere server.cfg verhindert Leaks und Missbrauch.

Checkliste:

• sv_endpointPrivacy true
• sv_scriptHook 0 (Client-Mods blockieren)
• Starkes oder deaktiviertes rcon_password
• add_principal und add_ace für ACLs verwenden
• API-Keys in .env verstecken, nicht in server.cfg
• Artifacts regelmäßig aktualisieren
• txAdmin Logs überwachen
• Resmon Guide nutzen, um schwere Scripts zu finden

ACL-Beispiel:

add_ace group.admin command allow add_principal identifier.steam:110000112345678 group.admin

---

CDN & Asset-Streaming (wann verwenden)

Für große MLOs, Custom-Cars und Texturen, CDN nutzen, um Join-Zeiten zu reduzieren.

• Dateien auf einem CDN wie Cloudflare R2 hosten (CORS-Header setzen).
• Für hohe Performance unterstützt BunnyCDN Range-Requests (benötigt für .rpf-Streaming).
• Versionierte URLs hinzufügen, um Cache-Konflikte zu vermeiden.

Sieh unseren Ladezeiten optimieren Guide.

---

Mythen & veraltete Flags

Viele Online-Konfigurationen zeigen noch immer Source Engine CVars wie:

sv_maxrate 0 sv_minrate 30000 sv_maxupdaterate 60

Nicht verwenden. Diese werden in FiveM nicht unterstützt und haben keinerlei Wirkung.

Veraltete/Legacy-Convars:

• sv_master1 → nicht mehr benötigt.
• sv_useDirectListing → ersetzt durch sv_endpointPrivacy.

---

Validierung & Fehlerbehebung

Wichtige Prüfungen nach dem Bearbeiten der server.cfg:

Symptom	Wahrscheinliche Ursache	Lösung	Zeit
Server startet nicht	Syntaxfehler in der Config	Console prüfen, ungültige Zeilen entfernen	5 min
Nicht in der Serverliste	Fehlendes sv_hostname/Tags	Hostname/Tags hinzufügen, Firewall prüfen	10 min
Spieler können nicht verbinden	Ports geschlossen / falsche IP	30120 TCP+UDP öffnen, endpoint_add_* prüfen	15 min
Hohe CPU-Auslastung	Zu viele Slots / schlechte Scripts	sv_maxclients senken, Performance-Tuning	20 min
Lange Ladezeiten	Große unkomprimierte Assets	Ladezeiten optimieren + CDN verwenden	20 min
Abstürze nach Update	Build-Mismatch	sv_enforceGameBuild pinnen, Artifacts aktualisieren	15 min

---

Interne Ressourcen & nächste Schritte

• Wie man einen FiveM Server erstellt
• FiveM Server Management: Der vollständige Guide

---

FAQ

1. Was ist die server.cfg in FiveM? Es ist die Hauptkonfigurationsdatei, die Servername, Slots, Ressourcen, Netzwerk, Sicherheit und Sichtbarkeit definiert.

2. Wo sollte ich die server.cfg ablegen? Im Root-Ordner des Servers (neben server.exe oder dem FXServer-Einstiegspunkt). txAdmin lädt sie automatisch.

3. Was ist der Unterschied zwischen set, sets und setr?

• set: Nur Server-Variable.
• sets: Erscheint in der Serverliste (öffentliche Info).
• setr: Wird an Clients synchronisiert.

4. Mein Server erscheint nicht in der Liste. Warum? sv_hostname, sets tags, sets locale und sv_endpointPrivacy prüfen. Auch sicherstellen, dass Ports offen sind.

5. Wie erhöhe ich die Spieler-Slots? sv_maxclients ändern. Schrittweise erhöhen und mit dem Resmon Guide überwachen. Sicherstellen, dass Hardware und Netzwerk das verkraften.

6. Was ist sv_enforceGameBuild? Ein Convar, der Clients zwingt, einen spezifischen GTA V Game-Build zu verwenden. Verhindert Abstürze durch nicht übereinstimmende Versionen.

7. Sollte ich Build-Nummern oder Aliase verwenden? Beides funktioniert. Numerisch (2944) ist explizit; Alias (mp2024_02) ist leichter nachzuverfolgen. Beide werden unterstützt.

8. Wo setze ich sv_enforceGameBuild in txAdmin? In txAdmin → Einstellungen → FXServer → Zusätzliche Argumente. Beispiel: +set sv_enforceGameBuild 2944.

9. Was ist OneSync? Ein System, das mehr Spieler, genaues Entity-Streaming und Server-Autorität ermöglicht. Erforderlich für moderne Frameworks.

10. Infinity vs. Legacy OneSync? Legacy = bis zu 64 Slots. Infinity = unterstützt 128+, erweiterter Entity-Sync. Immer onesync on (standardmäßig Infinity) verwenden.

11. Wie organisiere ich Ressourcen? exec resources.cfg verwenden. DB-Konnektoren zuerst starten, dann Frameworks, dann Jobs/Scripts. ensure * vermeiden.

12. Meine Banner erscheinen nicht in der Serverliste. Sicherstellen, dass URLs HTTPS, öffentlich zugänglich und auf korrekte Bildgrößen zeigen. CDN für Zuverlässigkeit verwenden.

13. Wofür sind txAdmin Logs? Sie zeigen Fehler, Abstürze und Ressourcenprobleme. Siehe txAdmin Logs.

14. Wie prüfe ich Performance-Probleme? resmon 1 in der Console verwenden. Sieh unseren Resmon Guide für Details.

15. Werden Source Engine Rate-Flags benötigt? Nein. sv_maxrate, sv_minrate, sv_maxupdaterate haben in FiveM keine Wirkung.

---

Quellen:

• Convars – Cfx.re Docs
• Server Commands – Cfx.re Docs
• OneSync – Cfx.re Docs
• Artifacts (Windows Builds) – runtime.fivem.net