Die FiveM-server.cfg Zeile für Zeile erklärt (2026)

Die Datei server.cfg ist das Konfigurationszentrum Ihres FiveM-Servers. Sie definiert die öffentliche Identität (Name, Beschreibung, Banner), die beim Start geladenen Ressourcen, die verfügbaren Slots, die Admin-Berechtigungen und mehr. Diese Anleitung erklärt jede Zeile der vorkonfigurierten Datei, die mit Ihrem Lordhosting-FiveM-Hosting auf Pterodactyl geliefert wird.

⚙️ Wo finde ich die server.cfg-Datei?

In Ihrem Lordhosting-Pterodactyl-Panel:

Wählen Sie Ihren FiveM-Server aus
Klicken Sie auf den Tab « File Manager » (linkes Menü)
Öffnen Sie im Root die Datei server.cfg

Eine Beispiel-server.cfg ist mit Basis-Parametern und den Slots je nach Ihrem Angebot vorkonfiguriert. Sie können sie direkt im Panel bearbeiten — jede Speicherung erfordert einen Server-Neustart, um wirksam zu werden.

⚠️ Nicht anfassen: die Zeilen endpoint_add_tcp und endpoint_add_udp, die mit dem Port zusammenhängen. Pterodactyl überschreibt sie automatisch beim Start mit dem Ihrem Server zugewiesenen Port. Manuelle Änderungen werden überschrieben.

⚙️ Server-Identität

Diese Zeilen definieren, wie Ihr Server in der öffentlichen FiveM-Liste erscheint.

sv_hostname

sv_hostname "^4[DE] ^7Mein toller RP-Server ^2| ^1Discord.gg/example"

In der FiveM-Serverliste angezeigter Name. Sie können die FiveM-Farbcodes verwenden:

Code	Farbe
`^0`	Schwarz
`^1`	Rot
`^2`	Grün
`^3`	Gelb
`^4`	Blau
`^5`	Cyan
`^6`	Magenta
`^7`	Weiß
`^8`	Dunkelrot
`^9`	Grau

Tipp: Beginnen Sie den Namen mit [DE], [FR], [EN] oder [ES], um die Hauptsprache des Servers anzuzeigen.

sv_projectName

sv_projectName "Mein toller RP-Server"

Kurzname Ihres Projekts, in bestimmten FiveM-Oberflächen angezeigt. Keine Farbcodes.

sv_projectDesc

sv_projectDesc "Deutschsprachiger GTA-RP-Server, realistische Wirtschaft, Custom-Jobs, 100 Slots."

In der detaillierten Server-Karte angezeigte Beschreibung. Auf etwa 1 Zeile begrenzt.

sv_maxClients

sv_maxClients 64

Maximale Slot-Anzahl (gleichzeitige Spieler). Muss der von Ihrem Lordhosting-Angebot vorgesehenen Slot-Anzahl entsprechen: Ein Überschreiten blockiert den Server-Start.

Typische Werte:

Start / kleiner RP: 32
mittlere RP-Community: 64
große RP-Community: 128 bis 200

load_server_icon icon.png

Bild, das neben dem Server-Namen in der FiveM-Liste angezeigt wird. Erforderliches Format: PNG genau 96x96 Pixel. Laden Sie die Datei icon.png über den Pterodactyl-File-Manager ins Server-Root hoch.

Game Build (GTA-V-DLC)

sets sv_enforceGameBuild 3258

Erzwingt eine bestimmte GTA-V-Version (DLC). Wichtig für aktuelle Fahrzeuge oder MLOs.

Häufige Builds 2026:

2802: Cayo Perico
2944: Contracts
3095: Drug Wars
3258: The Chop Shop
3407: Bottom Dollar Bounties (neuester)

⚠️ Je neuer der Build, desto wahrscheinlicher brechen alte Skripte. Testen Sie vor dem Produktiv-Push.

⚙️ Ressourcen und Start

# Basis-FiveM-Ressourcen
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap

# Ihre eigenen Ressourcen
ensure ihr_framework
ensure ihr_inventar
ensure ihre_jobs

ensure lädt die Ressource beim Start und startet sie automatisch neu, falls sie abstürzt.

💡 Ladereihenfolge: Starten Sie immer mit den Core-Ressourcen (sessionmanager, mapmanager usw.), dann Ihr Framework (ESX, QBCore, QBox), dann die davon abhängigen Ressourcen.

Um eine Ressource vorübergehend zu deaktivieren, ohne sie zu löschen, kommentieren Sie die Zeile mit # aus:

# ensure mein_kaputtes_skript

⚙️ Berechtigungen und Administration

ACE-System (Access Control Entries)

FiveM nutzt ein Berechtigungssystem namens ACE. Sie definieren Principals (Benutzer oder Gruppen) und weisen ihnen Berechtigungen zu.

# Erstellung einer Admin-Gruppe
add_ace group.admin command allow
add_ace group.admin command.quit deny

# Einen Benutzer der Admin-Gruppe hinzufügen (über Steam-Identifier, License usw.)
add_principal identifier.license:abc123def456... group.admin

Identifier eines Spielers

Um einen Admin hinzuzufügen, brauchen Sie seinen Identifier. Drei Wege, ihn zu erhalten:

Über die Server-Konsole: Tippen Sie players, wenn der Spieler verbunden ist
Über ein Skript: Die meisten Frameworks zeigen den Identifier in der Admin-Oberfläche
Über die Logs: Bei Verbindung loggt FiveM den Identifier in die Konsole

Typisches Format: license:abc123def456... oder steam:110000100000000

⚙️ Sicherheit und Anti-Cheat

OneSync-Modus

set onesync on
set onesync_population true

OneSync ist das Netzwerk-Replikationssystem von FiveM, das ermöglicht:

mehr als 32 gleichzeitige Spieler
bessere Entity-Synchronisation
GTA-V-Population zwischen Spielern synchronisiert

Empfohlen für jeden modernen RP-Server. Bei Lordhosting kostenlos enthalten.

Scripthook deaktiviert

sv_scriptHookAllowed 0

Deaktiviert die Nutzung des Script Hook clientseitig (Basis-Anti-Cheat). Auf 0 belassen für einen seriösen RP-Server. Client-Side-Cheats werden so begrenzt.

Verbindungs-Passwort (optional)

# sv_password "meinPasswort"

Kommentieren Sie aus und definieren Sie ein Passwort, um den Server privat zu machen (Whitelist-Beta, geschlossene Tests usw.). Für einen öffentlichen Server entfernen.

⚙️ Lizenz und technische Identität

Keymaster-Schlüssel

sv_licenseKey "cfxk_XXXXXXXXXXXXXXXXXXXXXXXXX_YYYYYY"

Auf keymaster.fivem.net erhaltener Schlüssel. Ohne ihn erscheint Ihr Server nicht in der öffentlichen Liste. Lesen Sie unseren Keymaster-Leitfaden.

💡 Empfohlene Alternative: Geben Sie Ihren Schlüssel über den Tab « Startup » des Lordhosting-Pterodactyl-Panels ein (Variable LICENSE_KEY) statt in server.cfg. Sauberer und sicherer beim Teilen der Konfiguration.

⚙️ Verbindungs-Limits

# Auf 1 Verbindung pro IP-Adresse beschränken
set sv_authMaxVariance 1
set sv_authMinTrust 5

Diese Parameter schützen vor einfachen Multi-Accounts. Für umfangreicheren Schutz nutzen Sie ein dediziertes Anti-Cheat-System (FiveGuard, Polar Anticheat usw.).

⚙️ Beispiel einer vollständigen server.cfg

# === IDENTITÄT ===
sv_hostname "^4[DE] ^7Mein RP-Server ^2| ^1discord.gg/example"
sv_projectName "Mein RP-Server"
sv_projectDesc "Deutschsprachiger GTA-RP-Server, realistische Wirtschaft, ESX, 64 Slots."
sv_maxClients 64

# === BANNER & TAGS ===
load_server_icon icon.png
sets tags "roleplay, rp, deutsch, esx, hardrp"
sets sv_enforceGameBuild 3258

# === RESSOURCEN ===
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
ensure es_extended
ensure ox_inventory
# Ihre Custom-Ressourcen hier hinzufügen

# === SICHERHEIT ===
set onesync on
set onesync_population true
sv_scriptHookAllowed 0

# === ADMIN (Beispiel) ===
add_ace group.admin command allow
add_principal identifier.license:abc123... group.admin

# === LIZENZ (lieber als Startup-Var setzen) ===
# sv_licenseKey "cfxk_..."

⚙️ Speichern und Neustart

Nach jeder Änderung:

Speichern Sie die Datei im Pterodactyl-File-Manager
Gehen Sie zum Tab « Console »
Klicken Sie auf « Restart »

Sie sehen in der Konsole, wie die Ressourcen einzeln geladen werden. Achten Sie auf eventuelle Fehler, die rot erscheinen.

⚙️ Häufige Fehler

Fehler	Ursache	Lösung
`Couldn't find resource X`	Ressource mit `ensure` referenziert, aber im Ordner `resources/` nicht vorhanden	Prüfen, dass der Ressourcen-Ordner existiert und den richtigen Namen hat
`License key authentication failed`	Ungültiger Keymaster-Schlüssel oder mit anderer IP verknüpft	Siehe Keymaster-Leitfaden
`sv_maxClients value exceeds limit`	Geforderte Slots überschreiten die des Angebots	`sv_maxClients` reduzieren oder Angebot upgraden
Server erscheint nicht in der Liste	Fehlender Keymaster-Schlüssel oder ungültiger Game-Build-Identifier	`sv_licenseKey` und `sv_enforceGameBuild` prüfen

⚙️ Vertiefung

CFX.re-Keymaster-Schlüssel erhalten: unverzichtbarer Schritt vor der server.cfg-Konfiguration
ESX vs. QBCore: welches Framework wählen?: für die richtige Wahl Ihrer ensure-Framework-Zeile
FiveM-Server aktualisieren: aktuelle Artifacts für die neuesten Features