Server.cfg verstehen und bearbeiten

Die server.cfg ist eine der wichtigsten Dateien deines FiveM Servers. In dieser Datei legst du grundlegende Einstellungen fest, startest Ressourcen und hinterlegst wichtige Werte wie Servername, Slots, License Key oder Datenbankverbindung.

Wenn dein FiveM Server nicht startet, nicht in der Serverliste erscheint oder bestimmte Ressourcen nicht geladen werden, liegt die Ursache häufig in der server.cfg.

Was ist die server.cfg?

Die server.cfg ist die zentrale Konfigurationsdatei deines FiveM Servers.

Dort wird festgelegt:

• unter welchem Namen dein Server angezeigt wird

• wie viele Spieler verbinden können

• welche Ressourcen beim Start geladen werden

• welcher License Key verwendet wird

• welche Tags und Beschreibungen angezeigt werden

• ob bestimmte Funktionen aktiviert oder deaktiviert sind

• wie sich der Server mit einer Datenbank verbindet

Die Datei wird beim Start des Servers geladen. Änderungen an der server.cfg werden deshalb meistens erst nach einem Neustart aktiv.

Wo finde ich die server.cfg?

Du findest die server.cfg im Dateimanager deines FiveM Servers im INSTANTPANEL.

Je nach Serverstruktur liegt die Datei häufig im Hauptverzeichnis deines Servers oder in einem Konfigurationsordner.

Typische Speicherorte sind:

• server.cfg

• /home/container/server.cfg

• /txData/default/server.cfg

• /txData/[Profilname]/server.cfg

Wenn du txAdmin verwendest, kann die aktive server.cfg in einem txAdmin-Profilordner liegen. Achte deshalb darauf, wirklich die Datei zu bearbeiten, die dein Server beim Start verwendet.

server.cfg bearbeiten

Gehe so vor:

1. Öffne das INSTANTPANEL.

2. Wähle deinen FiveM Server aus.

3. Öffne den Dateimanager.

4. Suche die Datei server.cfg.

5. Öffne die Datei im Editor.

6. Nimm die gewünschten Änderungen vor.

7. Speichere die Datei.

8. Starte den Server neu.

Wichtig: Erstelle vor größeren Änderungen ein Backup der Datei. So kannst du bei Fehlern schnell zur vorherigen Version zurückkehren.

Aufbau der server.cfg

Eine server.cfg besteht aus einzelnen Befehlen und Einstellungen.

Ein einfacher Eintrag sieht zum Beispiel so aus:

sv_hostname "Mein FiveM Server"

Der erste Teil ist der Befehl oder die Einstellung.

Der zweite Teil ist der Wert.

Bei Texten werden häufig Anführungszeichen verwendet.

Beispiel:

Bestandteil	Bedeutung
sv_hostname	Einstellung für den Servernamen
"Mein FiveM Server"	angezeigter Name des Servers

Kommentare verwenden

Kommentare sind Zeilen, die nicht ausgeführt werden.

Sie dienen nur als Notiz oder Erklärung.

In der server.cfg werden Kommentare meistens mit # geschrieben.

Beispiel:

# Das ist ein Kommentar

Du kannst Kommentare nutzen, um deine Konfiguration übersichtlicher zu machen.

Beispiel:

# Servername und Beschreibung

sv_hostname "Mein FiveM Roleplay"

Wichtige Einstellungen

In der server.cfg gibt es einige Einstellungen, die besonders häufig verwendet werden.

Einstellung	Bedeutung
sv_hostname	Name des Servers
sets sv_projectName	Projektname in der Serverliste
sets sv_projectDesc	Beschreibung in der Serverliste
sv_maxclients	maximale Spieleranzahl
sv_licenseKey	FiveM License Key
ensure	startet eine Ressource
set mysql_connection_string	Datenbankverbindung
sets tags	Tags für die Serverliste
locale	Sprache oder Region
endpoint_add_tcp	TCP-Portbindung
endpoint_add_udp	UDP-Portbindung

Servername ändern

Der Servername wird mit sv_hostname gesetzt.

Beispiel:

sv_hostname "INSTANTROOT FiveM Server"

Nach dem Speichern musst du den Server neu starten.

Der Name wird anschließend im FiveM Client und teilweise auch in der Serverliste angezeigt.

Projektname und Beschreibung ändern

Für die Serverliste werden häufig zusätzlich Projektname und Beschreibung verwendet.

Beispiel:

sets sv_projectName "INSTANTROOT Roleplay"

sets sv_projectDesc "Deutscher FiveM Roleplay Server"

Der Projektname ist eine kurze Bezeichnung. Die Beschreibung kann etwas genauer erklären, worum es auf dem Server geht.

Maximale Spieleranzahl ändern

Die maximale Spieleranzahl wird über sv_maxclients festgelegt.

Beispiel:

sv_maxclients 32

Der Wert legt fest, wie viele Spieler gleichzeitig auf deinen Server verbinden können.

Hinweis: Setze die Spielerzahl realistisch. Mehr Slots bedeuten nicht automatisch, dass der Server stabil mit so vielen Spielern läuft. Die tatsächliche Leistung hängt von Ressourcen, Scripts, Fahrzeugen, Datenbank und Serverauslastung ab.

FiveM License Key eintragen

Damit ein FiveM Server korrekt funktioniert, wird ein License Key benötigt.

Der Eintrag sieht so aus:

sv_licenseKey "dein_license_key"

Achte darauf, den Key vollständig und ohne zusätzliche Leerzeichen einzutragen.

Wichtig: Gib deinen License Key nicht öffentlich weiter. Der Key gehört zu deinem Server und sollte nicht in Screenshots, öffentlichen Logs oder Supportanfragen sichtbar sein.

Ressourcen starten

Ressourcen werden in FiveM über ensure gestartet.

Beispiel:

ensure chat

ensure spawnmanager

ensure sessionmanager

ensure hardcap

ensure mysql-async

ensure mein_script

Der Name hinter ensure muss exakt dem Ordnernamen der Ressource entsprechen.

Beispiel:

Wenn der Ressourcenordner so heißt:

mein-polizei-script

Dann muss der Eintrag so aussehen:

ensure mein-polizei-script

Unterschied zwischen ensure und start

In älteren Konfigurationen wird häufig start verwendet.

Beispiel:

start mein_script

Heute wird meistens ensure empfohlen.

ensure sorgt dafür, dass eine Ressource gestartet wird und bei Bedarf wieder gestartet werden kann, falls sie gestoppt wurde.

Für neue Einträge solltest du in der Regel ensure verwenden.

Reihenfolge von Ressourcen

Die Reihenfolge in der server.cfg ist wichtig.

Manche Ressourcen benötigen andere Ressourcen, bevor sie starten können.

Beispiel:

• zuerst Framework

• dann Datenbankressource

• dann Abhängigkeiten

• danach eigene Scripts

Eine typische Reihenfolge kann so aussehen:

1. Grundressourcen

2. Datenbankressource

3. Framework, zum Beispiel ESX oder QBCore

4. Abhängigkeiten

5. Jobs, Systeme und Scripts

6. Maps, Fahrzeuge und Kleidung

Wenn eine Ressource vor ihrer Abhängigkeit startet, kann sie Fehler verursachen oder nicht funktionieren.

Datenbankverbindung eintragen

Viele FiveM Server verwenden eine Datenbank, besonders Roleplay-Server mit ESX oder QBCore.

Die Datenbankverbindung wird meistens über einen Connection String gesetzt.

Beispiel:

set mysql_connection_string "mysql://benutzer:passwort@host/datenbank?charset=utf8mb4"

Die Werte müssen zu deiner Datenbank passen.

Bestandteil	Bedeutung
benutzer	Datenbankbenutzer
passwort	Passwort des Datenbankbenutzers
host	Datenbankserver
datenbank	Name der Datenbank
charset=utf8mb4	Zeichensatz für Sonderzeichen und Emojis

Wichtig: Wenn dein Datenbankpasswort Sonderzeichen enthält, kann es sein, dass der Connection String angepasst werden muss. Prüfe bei Datenbankfehlern immer zuerst Benutzername, Passwort, Host und Datenbankname.

Tags setzen

Tags helfen dabei, den Server in der FiveM Serverliste einzuordnen.

Beispiel:

sets tags "german, roleplay, esx, economy"

Verwende passende Tags und vermeide falsche oder irreführende Angaben.

Sprache und Region setzen

Je nach Konfiguration kannst du eine Sprache oder Region setzen.

Beispiel:

sets locale "de-DE"

Das hilft Spielern, deinen Server besser einzuordnen.

Ports und Endpoints

In vielen FiveM-Konfigurationen findest du Einträge wie:

endpoint_add_tcp "0.0.0.0:30120"

endpoint_add_udp "0.0.0.0:30120"

Diese Einträge legen fest, auf welchem Port der Server Verbindungen annimmt.

Der Standardport für FiveM ist häufig 30120.

Wichtig: Ändere diese Werte nur, wenn du genau weißt, was du tust oder der Support dich dazu auffordert. Falsche Portwerte können dazu führen, dass dein Server nicht mehr erreichbar ist.

OneSync

OneSync ist eine wichtige FiveM-Funktion für moderne Server.

Je nach Serverkonfiguration kann OneSync über die Konfiguration oder über txAdmin verwaltet werden.

Typische Einträge können sein:

set onesync on

oder:

set onesync legacy

oder:

set onesync infinity

Welche Einstellung sinnvoll ist, hängt von deinem Server, deinen Scripts und deiner FiveM-Version ab.

Icon und Banner

Einige Server verwenden eigene Bilder für die Darstellung in der Serverliste.

Je nach Konfiguration können dafür Dateien und Einträge in der server.cfg genutzt werden.

Beispiel:

load_server_icon logo.png

Die Datei muss im richtigen Verzeichnis liegen und korrekt benannt sein.

sv_scriptHookAllowed

Mit sv_scriptHookAllowed wird festgelegt, ob ScriptHook erlaubt ist.

Beispiel:

sv_scriptHookAllowed 0

Für öffentliche Roleplay-Server sollte ScriptHook in der Regel deaktiviert sein.

Wert	Bedeutung
0	ScriptHook deaktiviert
1	ScriptHook aktiviert

Wichtig: Aktiviere ScriptHook nur, wenn du genau weißt, warum du es brauchst. Auf öffentlichen Servern kann es ein Sicherheitsrisiko darstellen.

RCON

RCON ermöglicht entfernte Serverbefehle.

Wenn RCON verwendet wird, sollte ein sicheres Passwort gesetzt werden.

Beispiel:

rcon_password "sehr_sicheres_passwort"

Wichtig: Verwende kein einfaches Passwort und veröffentliche den RCON-Zugang niemals. Wer Zugriff auf RCON hat, kann administrative Befehle ausführen.

Beispielstruktur einer server.cfg

Eine einfache Struktur kann so aussehen:

Bereich	Beispiel
Netzwerk	endpoint_add_tcp "0.0.0.0:30120"
Netzwerk	endpoint_add_udp "0.0.0.0:30120"
Servername	sv_hostname "Mein FiveM Server"
Beschreibung	sets sv_projectDesc "Deutscher Roleplay Server"
Slots	sv_maxclients 32
License Key	sv_licenseKey "dein_license_key"
Datenbank	set mysql_connection_string "mysql://user:pass@host/db?charset=utf8mb4"
Ressource	ensure chat
Ressource	ensure mein_script

Häufige Fehler in der server.cfg

Fehlende Anführungszeichen

Texte sollten häufig in Anführungszeichen stehen.

Falsch:

sv_hostname Mein FiveM Server

Besser:

sv_hostname "Mein FiveM Server"

Falscher Ressourcenname

Der Name bei ensure muss exakt dem Ordnernamen entsprechen.

Wenn der Ordner policejob heißt, muss auch ensure policejob eingetragen werden.

Ressource liegt im falschen Ordner

Ressourcen müssen im richtigen resources-Ordner liegen.

Wenn eine Ressource nicht gefunden wird, prüfe:

• liegt der Ordner im richtigen Verzeichnis?

• ist die Ressource entpackt?

• gibt es keine doppelte Unterordnerstruktur?

• stimmt der Name in der server.cfg?

Doppelte Einträge

Doppelte oder widersprüchliche Einträge können Probleme verursachen.

Beispiel:

sv_maxclients 32

und später:

sv_maxclients 64

In diesem Fall kann unklar sein, welcher Wert aktiv ist. Halte deine Datei sauber und entferne alte Einträge.

Falscher License Key

Ein falscher oder fehlender License Key kann dazu führen, dass der Server nicht korrekt startet oder nicht sichtbar ist.

Prüfe:

• Key vollständig kopiert?

• keine Leerzeichen?

• richtige IP bei der Key-Erstellung verwendet?

• Key nicht abgelaufen oder gesperrt?

Fehlerhafte Datenbankverbindung

Wenn ESX, QBCore oder andere Ressourcen Datenbankfehler anzeigen, prüfe:

• Datenbankhost

• Benutzername

• Passwort

• Datenbankname

• importierte SQL-Dateien

• verwendete MySQL-Ressource, zum Beispiel oxmysql

Falsche Startreihenfolge

Wenn Ressourcen Abhängigkeiten benötigen, müssen diese vorher gestartet werden.

Beispiel:

ensure oxmysql

ensure es_extended

ensure esx_policejob

Hier muss oxmysql vor ESX starten, und ESX vor den ESX-Jobs.

Nach Änderungen immer neu starten

Viele Änderungen in der server.cfg werden erst nach einem Neustart aktiv.

Nach dem Speichern solltest du deshalb:

1. Server stoppen.

2. Einige Sekunden warten.

3. Server wieder starten.

4. Konsole prüfen.

5. Fehler oder Warnungen beachten.

Ein einfacher Neustart reicht meistens aus. Bei größeren Problemen ist ein kompletter Stop-und-Start oft sauberer.

Konsole nach Fehlern prüfen

Nach jeder Änderung solltest du die Konsole prüfen.

Achte besonders auf Meldungen wie:

• Couldn't find resource

• Failed to load resource

• Access denied

• You lack the required entitlement

• sv_licenseKey was not specified

• Could not connect to database

• Error parsing script

• No such export

• Started resource

• Stopping resource

Nicht jede Warnung ist kritisch. Wiederkehrende Fehler sollten aber geprüft werden.

Schritt-für-Schritt: Änderung sicher testen

Wenn du eine Änderung an der server.cfg vornehmen möchtest, gehe so vor:

1. Backup der aktuellen server.cfg erstellen.

2. Nur eine Änderung durchführen.

3. Datei speichern.

4. Server neu starten.

5. Konsole prüfen.

6. Funktion testen.

7. Erst danach die nächste Änderung durchführen.

Ändere nicht zu viele Dinge gleichzeitig. Sonst ist später schwer erkennbar, welche Änderung ein Problem verursacht hat.

Server startet nach Änderung nicht mehr

Wenn der Server nach einer Änderung nicht mehr startet, gehe so vor:

1. Öffne die Konsole.

2. Prüfe die letzte Fehlermeldung.

3. Öffne die server.cfg.

4. Mache die letzte Änderung rückgängig.

5. Prüfe Anführungszeichen und Schreibweise.

6. Speichere die Datei.

7. Starte den Server neu.

Wenn du ein Backup erstellt hast, kannst du die vorherige Version wiederherstellen.

Server wird nicht in der Liste angezeigt

Wenn dein Server läuft, aber nicht in der FiveM Serverliste sichtbar ist, prüfe:

• ist der License Key korrekt?

• ist der Server vollständig gestartet?

• ist sv_hostname gesetzt?

• sind Ports korrekt?

• ist der Server direkt per IP erreichbar?

• blockiert eine fehlerhafte Ressource den Start?

• wurde der Server gerade erst gestartet?

Die Serverliste kann etwas Zeit benötigen. Teste zusätzlich immer die direkte Verbindung.