Wie konfiguriert man die FiveM server.cfg-Datei richtig?
Par Benjamin D. · PDG
· Mis à jour le 6. August 2026 · Lecture 9 min
Inhaltsverzeichnis
Die FiveM server.cfg konfigurieren ist der erste und wichtigste Schritt, um einen stabilen, performanten und sicheren Roleplay-Server zu betreiben. Diese zentrale Konfigurationsdatei steuert alle grundlegenden Parameter – von der Serveridentität über Netzwerkeinstellungen bis hin zu Sicherheits- und Performance-Optionen. In diesem umfassenden Guide 2025 zeigen wir dir Schritt für Schritt, wie du deine server.cfg optimal einrichtest, typische Fehler vermeidest und das Maximum aus deinem FiveM-Server herausholst.
Grundlegende Struktur und Pfad der server.cfg
Die server.cfg befindet sich im Hauptverzeichnis deines FiveM-Servers, direkt neben den Ordnern resources und cache. Bei einem Hosting über Nexus Games FiveM-Server kannst du diese Datei bequem über das Panel-Interface oder per FTP bearbeiten. Die Datei ist im INI-ähnlichen Format aufgebaut: Jede Zeile enthält entweder einen Befehl (set, exec, start, endpoint_add_tcp etc.) oder einen Kommentar (eingeleitet mit #).
Ein typischer Aufbau sieht folgendermaßen aus:
# Server-Identität
set sv_hostname "Mein Roleplay Server 2025"
set sv_projectName "RP-City"
set sv_projectDesc "Dein neues Zuhause in Los Santos"
# Netzwerk
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
# Lizenz & Patreon
set sv_licenseKey "dein_cfxre_lizenzschlüssel"
# Sicherheit
set sv_maxclients 64
set sv_endpointprivacy true
# OneSync & Performance
set onesync on
set sv_enforceGameBuild 2802
# Ressourcen starten
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
Wichtige Hinweise zur Syntax
- set: Setzt eine Konsolenvariable (ConVar).
- ensure: Startet eine Ressource; wenn sie fehlt, wird ein Fehler geloggt, aber der Server startet weiter.
- start: Startet eine Ressource zwingend; Fehler stoppen den Serverstart.
- exec: Führt eine weitere Konfigurationsdatei aus (z. B.
exec permissions.cfg). - #: Kommentarzeile, wird ignoriert.
Server-Identität und Branding konfigurieren
Die ersten Zeilen deiner server.cfg definieren, wie dein Server in der FiveM-Serverliste erscheint. Diese Werte sind entscheidend für das First-Impression deiner Community.
Hostname und Projektname
set sv_hostname "^4[DE] Mein RP-Server | Whitelisted | Jobs | Events"
set sv_projectName "CityLife RP"
set sv_projectDesc "Deine neue Heimat in Los Santos – Whitelisted Roleplay"
Der sv_hostname unterstützt FiveM-Farbcodes (z. B. ^1 für Rot, ^4 für Blau). Halte ihn prägnant (max. 100 Zeichen), aber informativ: Land, Servertyp, Besonderheiten.
Tags und Master-Liste
sets tags "roleplay, deutsch, whitelisted, economy, jobs"
sets locale "de-DE"
set sv_master1 ""
Tags helfen Spielern, deinen Server zu finden. Nutze relevante Keywords wie „roleplay”, „economy”, „whitelist”, „police”, „esx” oder „qbcore”. Die locale-Einstellung signalisiert die Hauptsprache.
Banner und Social Links
sets banner_detail "https://deine-webseite.de/banner.png"
sets Discord "https://discord.gg/deinserver"
sets Website "https://deine-webseite.de"
Ein professionelles Banner (1200×400 px) und aktive Social-Media-Links erhöhen die Glaubwürdigkeit und Conversion-Rate neuer Spieler.
Netzwerk, Performance und OneSync optimieren
Die richtige Netzwerkkonfiguration ist kritisch für Stabilität und Latenz. Bei einem FiveM-Server auf Nexus Games mit AMD Ryzen 9 7950X3D (16 Kerne, bis zu 5,7 GHz) und DDR5 ECC RAM kannst du maximale Performance erwarten – vorausgesetzt, die server.cfg ist korrekt gesetzt.
Endpoint und Ports
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
Standardport ist 30120. Wenn du mehrere Server auf derselben IP betreibst, nutze abweichende Ports (30121, 30122…). 0.0.0.0 bindet an alle verfügbaren Netzwerkinterfaces.
OneSync aktivieren
set onesync on
set onesync_enableInfinity 1
set onesync_enableBeyond 1
set onesync_population 1
OneSync ist Pflicht für mehr als 32 Spieler. enableInfinity und enableBeyond erlauben bis zu 2048 Slots (je nach Framework und Skripten). onesync_population synchronisiert NPCs und Verkehr serverseitig – wichtig für Roleplay-Immersion.
Max. Spielerzahl und Hardcap
set sv_maxclients 64
ensure hardcap
set sv_endpointprivacy true
Passe sv_maxclients an deine Zielgruppe an. Für Whitelisted RP empfehlen wir 32–64 Slots. Das Skript hardcap verhindert Überbuchung. sv_endpointprivacy verbirgt IPs in der Serverliste – Schutz vor DDoS-Angriffen.
Game-Build festlegen
set sv_enforceGameBuild 2802
Dieser Wert legt die minimale GTA V-Spielversion fest. Build 2802 (aktuell Anfang 2025) garantiert Zugang zu neuen Spiel-Assets und Bugfixes. Prüfe regelmäßig die offizielle FiveM-Forum für Updates.
Performance-Tuning
set sv_threadCount 4
set sv_timeout 120
set sv_scriptHookAllowed 0
- sv_threadCount: Nutzt mehrere CPU-Kerne (max. 16 auf einem Ryzen 9 7950X3D). Optimal: 4–8.
- sv_timeout: Zeit in Sekunden, bevor ein inaktiver Spieler gekickt wird. Standard: 120 (2 Min.).
- sv_scriptHookAllowed: 0 = ScriptHook V verboten (empfohlen für Anti-Cheat).
Sicherheit, Lizenzen und Admin-Zugriff
Sicherheit beginnt in der server.cfg. Ohne korrekte Lizenz, Patreon-Key und Admin-Rechte läuft dein Server entweder gar nicht oder ist angreifbar.
FiveM-Lizenzschlüssel
set sv_licenseKey "dein_cfxre_lizenzschlüssel"
Jeder FiveM-Server benötigt einen kostenlosen Lizenzschlüssel von Cfx.re Keymaster. Bei Nexus Games ist der Patreon-Key für FiveM bereits inklusive, sodass du sofort loslegen kannst – ohne Wartezeiten oder zusätzliche Kosten.
Steam Web API Key (optional)
set steam_webApiKey "dein_steam_api_key"
Erlaubt erweiterte Steam-Integration (Avatare, Spielernamen). Schlüssel erhältst du unter steamcommunity.com/dev/apikey.
Admin-Berechtigungen (ACE-System)
add_ace group.admin command allow
add_ace group.admin command.quit deny
add_principal identifier.steam:110000xxxxxxxx group.admin
Das ACE-System (Access Control Entry) verwaltet Rechte. Ersetze 110000xxxxxxxx durch deine Steam-Hex-ID (findest du z. B. auf steamid.io). Weitere Gruppen definierst du in einer separaten permissions.cfg, die du per exec permissions.cfg einbindest.
RCon-Passwort
set rcon_password "sicheres_passwort_2025!"
Ermöglicht Remote-Administration via Tools wie IceCon oder RconCLI. Nutze ein starkes Passwort (min. 16 Zeichen, Zahlen, Sonderzeichen).
Ressourcen laden: ensure vs. start
Die Reihenfolge und Methode, mit der du Ressourcen lädst, entscheidet über Stabilität und Ladezeiten.
Basis-Ressourcen (immer zuerst)
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
Diese Core-Ressourcen müssen immer geladen werden. ensure ist hier sicherer als start, weil der Server auch bei Fehlen weiterläuft (wenn auch ohne Funktion).
Framework-Ressourcen (ESX, QBCore, vRP…)
ensure es_extended
ensure esx_menu_default
ensure esx_menu_list
ensure esx_menu_dialog
# Weitere ESX-Ressourcen...
Bei ESX gilt: Core zuerst, dann Menüs, dann Jobs/Shops. Prüfe die __resource.lua jeder Ressource auf Abhängigkeiten.
Custom-Ressourcen und MLOs
start my_custom_carpack
start gabz_mrpd
start esx_policejob
start esx_ambulancejob
Nutze start für kritische Ressourcen (Jobs, Garagen), ensure für optionale (Dekorationen, Events). Das verhindert Server-Crashes bei fehlenden Dateien.
Ladereihenfolge optimieren
- 1. Basis (mapmanager, chat…)
- 2. Framework (ESX, QB…)
- 3. Datenbank-Wrapper (oxmysql, ghmattimysql…)
- 4. Jobs, Shops, Inventory
- 5. Autos, Waffen, MLOs
- 6. UI/HUD-Skripte
Falsche Reihenfolge führt zu nil-Fehlern und Crashes.
Beispiel: Vollständige server.cfg für Roleplay 2025
Hier ist eine praxiserprobte, produktionsreife Konfiguration für einen Whitelisted RP-Server mit 48 Slots, ESX-Framework und modernen Standards:
## Server-Identität
set sv_hostname "^4[DE] NexusRP | Whitelist | ESX | Economy | Jobs"
set sv_projectName "NexusRP"
set sv_projectDesc "Deine neue Heimat in Los Santos – Realistisches Roleplay"
sets tags "roleplay, deutsch, esx, whitelist, jobs, economy, polizei"
sets locale "de-DE"
sets banner_detail "https://nexus-games.com/banner.png"
sets Discord "https://discord.gg/nexusrp"
## Netzwerk
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
set sv_maxclients 48
set sv_endpointprivacy true
## Lizenz & API
set sv_licenseKey "dein_cfxre_lizenzschlüssel_hier"
set steam_webApiKey "dein_steam_api_key_hier"
## OneSync & Performance
set onesync on
set onesync_enableInfinity 1
set onesync_enableBeyond 1
set onesync_population 1
set sv_enforceGameBuild 2802
set sv_threadCount 6
set sv_scriptHookAllowed 0
## Sicherheit
set rcon_password "SuperSicher2025!#abc"
add_ace group.admin command allow
add_ace group.admin command.quit deny
add_principal identifier.steam:110000xxxxxxxx group.admin
## Basis-Ressourcen
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
## Framework ESX
ensure es_extended
ensure esx_menu_default
ensure esx_menu_list
ensure esx_menu_dialog
ensure esx_identity
ensure esx_skin
ensure esx_vehicleshop
ensure esx_policejob
ensure esx_ambulancejob
ensure esx_mecanojob
## Custom & MLOs
start gabz_mrpd
start gabz_pillbox
start my_custom_carpack
## Performance-Tweaks (optional)
exec server_performance.cfg
Speichere diese Datei als server.cfg im Root-Verzeichnis deines Servers. Nach jedem Edit: Server neu starten!
Häufige Fehler und Troubleshooting
Server startet nicht / „License key missing”
Überprüfe, ob sv_licenseKey korrekt gesetzt ist. Keine Leerzeichen, keine Anführungszeichen außen herum (außer in der CFG selbst). Bei Nexus Games ist der Patreon-Key vorinstalliert – kontaktiere den Support, falls Probleme auftreten.
„Failed to start resource XYZ”
Ressource fehlt oder fxmanifest.lua ist defekt. Prüfe den resources/-Ordner und Logs (server.log, console). Nutze ensure statt start, um den Server trotzdem hochzufahren.
Spieler können nicht joinen / Timeout
- Firewall: Port 30120 TCP/UDP öffnen (bei Nexus Games automatisch konfiguriert).
sv_maxclientszu niedrig.- OneSync fehlt oder falsch konfiguriert.
- Anti-DDoS blockiert Traffic (überprüfe Game Anti-DDoS-Einstellungen im Panel).
Lag / Performance-Probleme
- Zu viele Ressourcen gleichzeitig geladen.
sv_threadCountzu hoch (max. Anzahl CPU-Kerne).- Ineffiziente Skripte (z. B. unoptimierte ESX-Addons).
- Datenbank-Überlastung (MySQL-Tuning erforderlich).
Bei einem Nexus Games FiveM-Server mit AMD Ryzen 9 7950X3D und NVMe SSD sind Hardware-Engpässe quasi ausgeschlossen – Optimierung liegt meist auf Skript-Ebene.
Erweiterte Konfiguration: exec-Dateien und Modularität
Für große Server empfiehlt sich eine modulare Struktur:
## server.cfg (Hauptdatei)
exec server_network.cfg
exec server_security.cfg
exec server_resources.cfg
exec server_performance.cfg
Jede .cfg-Datei behandelt einen Bereich:
- server_network.cfg: Endpoints, OneSync, Ports
- server_security.cfg: ACE, RCon, Lizenzen
- server_resources.cfg: Alle
ensure/start-Befehle - server_performance.cfg: Tweaks, ConVars
So behältst du Übersicht und kannst gezielt debuggen.
Backup und Versionierung der server.cfg
Die server.cfg ist das Herz deines Servers. Erstelle vor jeder Änderung ein Backup! Bei Nexus Games kannst du direkt im Panel Snapshots erstellen oder per FTP eine Kopie sichern:
server_backup_2025-01-15.cfg
server_backup_2025-01-20.cfg
Nutze Tools wie Git oder ein simples Versionierungs-Skript, um Änderungen nachzuvollziehen. Bei größeren Teams: Google Docs oder Confluence für gemeinsame Dokumentation.
Mit einer sauber konfigurierten server.cfg legst du den Grundstein für einen stabilen, performanten und sicheren FiveM-Server. Nutze moderne Hardware wie den AMD Ryzen 9 7950X3D mit DDR5 ECC RAM bei Nexus Games, um maximale Leistung zu garantieren. Achte auf saubere Syntax, logische Reihenfolge der Ressourcen und regelmäßige Updates. So schaffst du eine optimale Basis für deine Roleplay-Community – egal ob 32 oder 512 Spieler.
FAQ
Wo genau befindet sich die server.cfg und wie bearbeite ich sie sicher?Die server.cfg liegt im Hauptverzeichnis deines FiveM-Servers, direkt neben den Ordnern resources und cache. Bei Nexus Games kannst du sie über das Web-Panel (File Manager) oder per FTP bearbeiten. Nutze einen Editor mit Syntax-Highlighting (z. B. Notepad++, VS Code) und erstelle immer ein Backup vor Änderungen. Speichere im UTF-8-Format ohne BOM, um Encoding-Fehler zu vermeiden.
Ja, OneSync ist auch für 32 Spieler empfohlen. Es verbessert die Synchronisation von Entities (Fahrzeuge, NPCs, Objekte) und ist Voraussetzung für viele moderne ESX/QBCore-Skripte. Ohne OneSync limitierst du dich auf veraltete Ressourcen. Setze set onesync on in jedem Fall – die Performance-Einbußen sind auf modernen Systemen (wie dem Ryzen 9 7950X3D bei Nexus Games) vernachlässigbar.
Prüfe die fxmanifest.lua jeder Ressource auf dependencies-Einträge. Frameworks (ESX, QB) müssen immer zuerst geladen werden, danach Datenbank-Wrapper (oxmysql), dann Jobs/Shops, zuletzt UI/HUD. Starte mit einer minimalen Config (nur Core-Ressourcen), füge schrittweise hinzu und teste nach jedem Schritt. Nutze ensure für optionale, start für kritische Ressourcen. Bei Fehlern hilft die server.log im Serververzeichnis.