FiveM server.cfg: Vollständiger Konfigurationsguide
Lerne, wie du deine server.cfg richtig konfigurierst. Mit Schritt-für-Schritt-Anleitung, Sicherheits-Hardening und Performance-Best-Practices für 2026.
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, <96×96 Pixel sein
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_maxclientsbeeinflusst 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.cfgoder 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.
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_maxclientsmit 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 truesv_scriptHook 0(Client-Mods blockieren)- Starkes oder deaktiviertes
rcon_password add_principalundadd_acefür ACLs verwenden- API-Keys in
.envverstecken, nicht inserver.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 durchsv_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
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:
