FiveMVeröffentlicht am 15. Dezember 202512 Min. Lesezeit

Wie man die server.cfg auf seinem FiveM-Server konfiguriert

Einführung

Die Datei server.cfg ist die zentrale Konfigurationsdatei eines FiveM-Servers. Diese Anleitung zeigt, wie Sie die server.cfg Ihres FiveM-Servers in OuiPanel konfigurieren, dem Spielpanel von OuiHeberg. Sie geht jede gängige Einstellung mit ihrer Zeile durch und endet mit einem vollständigen Beispiel.

BereichBeispiele
IdentitätServername, Beschreibung, Tags
LizenzCfx.re-Lizenzschlüssel, Pflicht
SpielerAnzahl der Slots, OneSync
RessourcenSkripte, Maps, Fahrzeuge
BerechtigungenACE und ACL, Admins, Gruppen
NetzwerkPorts, RCON

Einen Lizenzschlüssel erhalten

Ohne Lizenzschlüssel startet ein FiveM-Server nicht. Der Schlüssel ist kostenlos und wird im Cfx.re-Portal erstellt, dem Nachfolger von Keymaster.

  1. Melden Sie sich auf portal.cfx.re mit Ihrem Cfx.re-Konto an. Die alte Adresse keymaster.fivem.net leitet ebenfalls dorthin. Ohne Konto klicken Sie auf Sign Up.

  2. Öffnen Sie die Seite Server Registration Keys und klicken Sie auf Generate Key.

  3. Geben Sie unter Display Name einen Namen für den Schlüssel ein und klicken Sie auf Generate.

  4. Kopieren Sie den neuen Schlüssel. Er beginnt mit cfxk_.

Die Anleitung Keymaster FiveM erklärt das Portal, die Verwaltung der Schlüssel und die Lizenzfehler im Detail.

Seite Server Registration Keys im Cfx.re-Portal mit der Schaltfläche Generate Key

Ein Schlüssel gilt immer nur für einen Server. Halten Sie ihn geheim und erstellen Sie für jeden weiteren Server einen eigenen.


Die Datei server.cfg öffnen

  1. Melden Sie sich bei OuiPanel unter dash.ouipanel.com an und öffnen Sie Ihren FiveM-Server.

  2. Stoppen Sie den Server in der Konsole mit der Schaltfläche Stoppen.

  3. Klicken Sie im Seitenmenü auf Dateimanager.

  4. Klicken Sie im Hauptverzeichnis auf server.cfg. Das Fenster „Bearbeite server.cfg“ öffnet sich.

  5. Bearbeiten Sie die Datei und klicken Sie auf Speichern.

  6. Starten Sie den Server über die Konsole neu.

Die Zeilen unter ### AUTOMATICALLY SET BY PTERODACTYL ### am Anfang der Datei schreibt das Panel. Lassen Sie sie unverändert.

Fenster Bearbeite server.cfg im Dateimanager mit der Schaltfläche Speichern

Stoppen Sie den Server, bevor Sie diese Datei bearbeiten. Der Server liest die server.cfg erst beim nächsten Start neu ein.


Die Edition Legacy oder Enhanced wählen

OuiPanel bietet FiveM in zwei Editionen an, Legacy und Enhanced. Das Panel nennt sie Kanäle. Sie wählen die Edition unter FiveM-Konfiguration in der Karte FiveM-Kanal. Das Abzeichen Aktuell markiert die Edition des Servers.

Zwischen den Editionen wechseln

  1. Klicken Sie im Seitenmenü auf FiveM-Konfiguration.

  2. Klicken Sie in der Karte FiveM-Kanal auf Legacy oder Enhanced.

  3. Das Fenster „Vor der Installation sichern“ öffnet sich. Klicken Sie auf Speichern und fortfahren oder auf Ohne Backup fortfahren.

Das Panel installiert den Server in der gewählten Edition neu. Laut der Karte behält der Wechsel Ihre Konfiguration.

Fenster Vor der Installation sichern mit den Schaltflächen Ohne Backup fortfahren und Speichern und fortfahren

Tragen Sie vor dem Wechsel zu Enhanced Ihren eigenen Schlüssel in die Variable fivem license ein. Ohne ihn beendet sich der Server beim Start.

Was sich im Panel ändert

EinstellungLegacyEnhanced
txAdminVerfügbar, mit den Variablen txAdmin Port und Activer txadminNicht verfügbar, die Seite zeigt dazu den Hinweis „txAdmin auf Enhanced nicht verfügbar“
Artefakt-VersionAuswahl aus einer Liste über Eine Version auswählenSchaltfläche ausgegraut, die Auswahl aus der Liste ist Legacy vorbehalten
Installierte VersionBuild-Nummer, zum Beispiel 38220Kurze Kennung, zum Beispiel 019ffb4d
Versionsvariablefivem versionfivem version (Enhanced / UUID)

Die Anleitung Die Artifact-Version des FiveM-Servers ändern erklärt die Wahl eines Builds auf Legacy. Wie Sie txAdmin öffnen, steht in FiveM-Whitelist mit Discord und txAdmin einrichten.

Seite FiveM-Konfiguration auf Enhanced mit dem Hinweis txAdmin auf Enhanced nicht verfügbar und ausgegrauter Schaltfläche


Grundkonfiguration

Lizenzschlüssel (Pflicht)

sv_licenseKey "ihr_lizenzschluessel_hier"

Ersetzen Sie den Wert durch den Schlüssel aus dem Cfx.re-Portal. Ohne gültigen Schlüssel startet der Server nicht.

In OuiPanel tragen Sie den Schlüssel außerdem unter Konfiguration › Servereinstellungen ein, im Block Umgebungsvariablen, Feld fivem license. Fügen Sie den Schlüssel ein und klicken Sie auf das Häkchen rechts neben dem Feld, um ihn zu speichern. Enthält Ihre server.cfg eine Zeile sv_licenseKey, tragen Sie dort denselben Schlüssel ein.

In der Edition Enhanced ist ein eigener Schlüssel Pflicht. Der voreingestellte Schlüssel der Variable wird dort von Cfx.re abgelehnt, und der Server beendet sich sofort beim Start.

Im selben Block finden Sie Nom du serveur (Servername), Joueurs maximum (maximale Spielerzahl) und Clé API Web Steam (obsolète) (Steam-Web-API-Schlüssel, veraltet). Halten Sie die Werte in den Variablen und in der Datei gleich. Auf Legacy enthält er außerdem txAdmin Port und den Schalter Activer txadmin (txAdmin aktivieren).

Umgebungsvariablen eines FiveM-Legacy-Servers mit fivem license, txAdmin Port und Activer txadmin

Servername

sv_hostname "Mein FiveM-Server | Roleplay DE"

Das ist der Name in der FiveM-Serverliste. Ein paar Tipps für die Wahl.

  • Kurz und leicht zu merken.

  • Mit der Art des Servers (RP, Freeroam, Drift…).

  • Mit der Sprache (DE, EN…).

  • Emojis nur sparsam.

Einige Beispiele.

sv_hostname "[DE] Revolution RP | Seriöses Roleplay"
sv_hostname "Los Santos Life | RP auf Deutsch"
sv_hostname "Drift Paradise | Rennen & Tuning"

Serverbeschreibung

sets sv_projectDesc "Deutscher Roleplay-Server mit realistischer Wirtschaft, vielen Berufen und aktiver Community."

Die Beschreibung erscheint in den Serverdetails. Bleiben Sie unter 200 Zeichen.

Projektname

sets sv_projectName "Revolution RP"

Das ist der kurze Projektname, der in einigen Menüs erscheint.

Die Dokumentation von Cfx.re führt sv_projectName, sv_projectDesc und load_server_icon als veraltet. Name, Beschreibung und Symbol lassen sich auch im Cfx.re-Portal festlegen.

Server-Tags

sets tags "roleplay, deutsch, serious, economy, jobs"

Tags helfen, den Server in der Liste zu finden. Trennen Sie sie mit Kommas. Die gängigsten sind diese.

  • roleplay, rp, serious, semi-serious

  • deutsch, german, de

  • economy, jobs, police, ems

  • custom-cars, drift, racing

  • esx, qbcore, vrp

Serversymbol

load_server_icon server_icon.png

Diese Zeile zeigt ein Symbol in der Serverliste. Das Bild muss ein PNG mit 96 × 96 Pixeln sein, server_icon.png heißen und im Hauptverzeichnis des Servers liegen. Zum Hochladen ziehen Sie es im Dateimanager auf das Hauptverzeichnis.


Spielerkonfiguration

Anzahl der Slots

sv_maxclients 32

Über 32 Slots muss OneSync aktiviert sein. Über 64 muss es auf on stehen. Die Obergrenze hängt auch von Ihrem Cfx.re-Konto ab.

SlotsVoraussetzung
32Kleiner Server oder Testserver
48Obergrenze ohne Cfx.re-Abo, mit OneSync
64 bis 128Abo Element Club Argentum oder Aurum
Bis 2048Abo Element Club Platinum, OneSync auf on

Die Variable Joueurs maximum in den Servereinstellungen legt dieselbe Zahl fest. Mehr Spieler brauchen auch mehr Arbeitsspeicher und Prozessorleistung.

OneSync aktivieren

Mit OneSync sind mehr als 32 Spieler möglich, und die Synchronisierung wird besser.

set onesync on
ModusWirkung
offDeaktiviert, höchstens 32 Spieler
onAktiviert, der empfohlene Modus
legacyKompatibilitätsmodus, von Cfx.re nicht empfohlen

Für eine feinere OneSync-Konfiguration ergänzen Sie diese Zeilen.

set onesync on
set onesync_population true

# Nimmt entfernte Entitäten außerhalb des Sichtfelds aus der Synchronisierung
set onesync_distanceCulling true
set onesync_distanceCullVehicles false

Spawnpunkt

Der Spawnpunkt wird nicht in der server.cfg festgelegt. Er steht in einer Map-Ressource, mit X-, Y- und Z-Koordinaten. Die meisten Frameworks (ESX, QBCore) regeln das Spawnen selbst.

spawnpoint 'a_m_y_hipster_01' { x = -269.4, y = -955.3, z = 31.2 }

Ressourcenkonfiguration

Eine Ressource starten

ensure name_der_ressource

Der Befehl start funktioniert ebenfalls.

start name_der_ressource

Verwenden Sie lieber ensure. Der Befehl startet die Ressource oder startet sie neu, wenn sie schon läuft.

Ladereihenfolge

Die Reihenfolge der ensure-Zeilen ist wichtig, weil manche Ressourcen von anderen abhängen. Eine empfohlene Reihenfolge.

# 1. FiveM-Grundressourcen
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure rconlog

# 2. Datenbank
ensure oxmysql

# 3. Framework (ESX oder QBCore)
ensure es_extended

# 4. Gemeinsame Abhängigkeiten
ensure esx_menu_default
ensure esx_menu_dialog
ensure esx_menu_list

# 5. Wichtige Skripte
ensure esx_identity
ensure esx_society
ensure esx_billing
ensure esx_banking

# 6. Jobs / Berufe
ensure esx_policejob
ensure esx_ambulancejob
ensure esx_mechanicjob

# 7. Weitere Skripte
ensure esx_vehicleshop
ensure esx_property
ensure esx_skin

# 8. Eigene Skripte
ensure mein_eigenes_skript

Eine Ressource deaktivieren

Um eine Ressource zu deaktivieren, kommentieren Sie ihre Zeile mit # aus.

# ensure deaktivierte_ressource

Nützliche Konsolenbefehle

Diese Befehle geben Sie in der Konsole von OuiPanel ein, ohne Schrägstrich davor.

BefehlWirkung
restart [ressource]Startet eine Ressource neu
stop [ressource]Stoppt eine Ressource
start [ressource]Startet eine Ressource
refreshAktualisiert die Ressourcenliste
statusZeigt die verbundenen Spieler
quitStoppt den Server

Datenbankkonfiguration

MySQL-Verbindung

set mysql_connection_string "mysql://user:password@host:3306/database?charset=utf8mb4"

Ersetzen Sie jeden Teil durch die Daten Ihrer Datenbank.

  • user ist der MySQL-Benutzername.

  • password ist sein Passwort.

  • host ist die Adresse des MySQL-Servers.

  • 3306 ist der MySQL-Port.

  • database ist der Name der Datenbank.

Diese Daten finden Sie unter Datenbanken, Schaltfläche Informationen. Die Anleitung Eine MySQL-Datenbank in OuiPanel erstellen und verwalten zeigt, wie Sie die Datenbank anlegen.

Ein Beispiel mit erfundenen Werten.

set mysql_connection_string "mysql://u123_AbCdEfGh:Passwort123@203.0.113.20:3306/s123_db?charset=utf8mb4"

Die Verbindung aus OuiPanel einfügen

OuiPanel kann diese Zeile für Sie schreiben.

  1. Klicken Sie im Seitenmenü auf FiveM-Konfiguration.

  2. Klicken Sie in der Karte MySQL-Verbindung einfügen auf Datenbank auswählen.

  3. Wählen Sie im Fenster „Datenbank auswählen“ die Datenbank und klicken Sie auf Bestätigen.

Das Panel fügt unter dem Block ### AUTOMATICALLY SET BY PTERODACTYL ### eine Zeile set mysql_connection_string ein. Eine bereits vorhandene Zeile wird auskommentiert.

Seite FiveM-Konfiguration mit dem geöffneten Fenster Datenbank auswählen

Format Schlüssel=Wert

oxmysql akzeptiert die Zeichenkette auch als Schlüssel=Wert-Paare. Die erste Zeile ist das ältere Format, die zweite das Format, das OuiPanel schreibt.

set mysql_connection_string "server=203.0.113.20;uid=u123_AbCdEfGh;password=Passwort123;database=s123_db"
set mysql_connection_string "user=u123_AbCdEfGh;password=Passwort123;host=203.0.113.20;port=3306;database=s123_db"

Berechtigungskonfiguration (ACE/ACL)

Das ACE-System (Access Control Entry) verwaltet die Berechtigungen auf FiveM. Mehr dazu in der Anleitung Permissions ACE auf FiveM.

Einen Administrator hinzufügen

Ein Spieler wird Administrator, wenn Sie ihn der Gruppe group.admin hinzufügen. Am häufigsten nutzt man die Steam-Kennung.

add_principal identifier.steam:110000xxxxxxxxx group.admin

Über die Discord-Kennung.

add_principal identifier.discord:123456789012345678 group.admin

Über die Rockstar-Lizenzkennung.

add_principal identifier.license:xxxxxxxxxxxxxxxxxxxxx group.admin

Ihre Steam-Kennung finden Sie auf SteamID.io. Nötig ist die hexadezimale Form, die mit 110000 beginnt.

Berechtigungsgruppen erstellen

# Admin-Gruppe mit allen Befehlen außer quit
add_ace group.admin command allow
add_ace group.admin command.quit deny

# Moderatorengruppe
add_ace group.moderator command.kick allow
add_ace group.moderator command.ban allow

# Die Admin-Gruppe erbt die Rechte der Moderatorengruppe
add_principal group.admin group.moderator

Häufige Berechtigungen

# Die Admin-Gruppe darf alle Befehle nutzen
add_ace group.admin command allow

# Einzelne Berechtigungen
add_ace group.admin command.restart allow
add_ace group.admin command.stop allow
add_ace group.admin command.start allow
add_ace group.admin command.refresh allow

# vMenu-Berechtigungen
add_ace group.admin vMenu.Everything allow
add_ace group.moderator vMenu.OnlinePlayers.Kick allow
add_ace group.moderator vMenu.OnlinePlayers.TempBan allow

Einen Spieler einer Gruppe zuweisen

add_principal identifier.steam:110000xxxxxxxxx group.admin
add_principal identifier.discord:123456789012345678 group.moderator

Netzwerkkonfiguration

Server-Port

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

In OuiPanel gehören diese beiden Zeilen zum Block, den das Panel schreibt. Sie verwenden den Hauptport Ihres Servers, den Sie unter Konfiguration › Port-Verwaltung sehen. Ändern Sie sie nicht.

RCON (Fernkonsole)

rcon_password "SehrSicheresRconPasswort"

Mit RCON steuern Sie den Server aus der Ferne. Wählen Sie ein langes, einmaliges Passwort. Um RCON zu deaktivieren, lassen Sie den Wert mit rcon_password "" leer.

Steam-API-Schlüssel

FiveM verwendet steam_webApiKey laut seiner offiziellen Dokumentation seit dem 4. November 2026 nicht mehr. Lassen Sie die Variable Clé API Web Steam (obsolète) in OuiPanel auf none und tragen Sie sie nicht in server.cfg ein. Um ein Steam-Konto vorauszusetzen, nutzen Sie sv_enforceSteamAuth auf einem Server ab Build 38004, wie es die Anleitung ACE-Berechtigungen auf FiveM erklärt.


Gameplay-Konfiguration

PvP, Radar oder Passivmodus werden nicht in der server.cfg eingestellt. Sie hängen von Ihren Ressourcen und Ihrem Framework ab. Einige Einstellungen für das Gameplay stehen trotzdem in der Datei.

Spielversion (Game Build)

sv_enforceGameBuild 2944

Diese Zeile schreibt den Spielern eine Version von GTA V vor. So bleiben Ressourcen kompatibel, etwa Fahrzeuge oder Maps aus einem neuen Update.

BuildUpdate von GTA V
2060Los Santos Summer Special
2189Cayo Perico Heist
2372Los Santos Tuners
2545The Contract
2699The Criminal Enterprises
2802Los Santos Drug Wars
2944San Andreas Mercenaries
3095The Chop Shop
3258Bottom Dollar Bounties
3407Agents of Sabotage
3570Money Fronts
3751A Safehouse in the Hills
3889The Kortz Center Heist

Im Kanal Enhanced von FiveM wird nur die neueste Spielversion unterstützt.

Script Hook und veränderte Dateien

# Weist Spieler mit Script Hook V ab (Standardwert)
sv_scriptHookAllowed 0

# Blockiert veränderte Spieldateien, außer Audio und bekannten Grafikmods
sv_pureLevel 1

Mit sv_pureLevel 2 werden alle veränderten Dateien blockiert. Cfx.re rät davon ab, Script Hook zu erlauben, weil das den Server angreifbar macht.


Nützliche Convars

Variablen festlegen

set meine_variable "wert"
setr meine_replizierte_variable "wert"
sets meine_serverinfo_variable "wert"
BefehlSichtbarkeit
setNur auf dem Server
setrAn die Clients übertragen
setsIn den Serverinformationen sichtbar

Variablen des Frameworks ESX

setr esx:locale "de"

Diese Zeile legt die Sprache von ESX Legacy fest. Startgeld und weitere Einstellungen stehen in der Konfigurationsdatei von es_extended, nicht in der server.cfg.

Variablen des Frameworks QBCore

setr qb_locale "de"

Diese Zeile legt die Sprache von QBCore fest. Das Startgeld stellen Sie in qb-core/config.lua ein.


Vollständiges server.cfg-Beispiel

Hier eine vollständige server.cfg. Behalten Sie den Block, den OuiPanel schreibt, am Anfang Ihrer Datei.

# ============================================
# KONFIGURATION DES FIVEM-SERVERS
# ============================================

# === LIZENZ ===
sv_licenseKey "ihr_lizenzschluessel_hier"

# === IDENTITÄT DES SERVERS ===
sv_hostname "[DE] Mein RP-Server | Seriöses Roleplay"
sets sv_projectName "Mein RP-Server"
sets sv_projectDesc "Deutscher Roleplay-Server mit realistischer Wirtschaft und aktiver Community."
sets tags "roleplay, deutsch, serious, esx, economy"
load_server_icon server_icon.png

# === SPIELER ===
sv_maxclients 48
set onesync on

# === NETZWERK (Zeilen, die OuiPanel mit dem Hauptport schreibt) ===
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

# === RCON ===
rcon_password ""

# === DATENBANK ===
set mysql_connection_string "mysql://user:password@host:3306/database?charset=utf8mb4"

# steam_webApiKey wird von FiveM seit dem 04.11.2026 nicht mehr verwendet

# === GAMEPLAY ===
sv_enforceGameBuild 2944

# ============================================
# ACE/ACL-BERECHTIGUNGEN
# ============================================

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

# Administratoren (durch Ihre Kennungen ersetzen)
# add_principal identifier.steam:110000xxxxxxxxx group.admin
# add_principal identifier.discord:123456789012345678 group.admin

# ============================================
# RESSOURCEN
# ============================================

# === FiveM-Grundlagen ===
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure rconlog

# === Datenbank ===
ensure oxmysql

# === Framework ESX ===
ensure es_extended
ensure esx_menu_default
ensure esx_menu_dialog
ensure esx_menu_list

# === ESX-Skripte ===
ensure esx_identity
ensure esx_society
ensure esx_billing
ensure esx_banking
ensure esx_skin

# === Berufe ===
ensure esx_policejob
ensure esx_ambulancejob
ensure esx_mechanicjob

# === Weitere Skripte ===
ensure esx_vehicleshop
ensure esx_property

# === Eigene Skripte ===
# ensure mein_skript

Fehlerbehebung

Der Server startet nicht

MeldungLösung
Invalid license keyPrüfen Sie den Schlüssel im Cfx.re-Portal und in der Variable fivem license
License key not setFüllen Sie die Variable fivem license oder die Zeile sv_licenseKey aus
A valid license check is required to run this serverMeldung der Edition Enhanced. Tragen Sie Ihren eigenen Schlüssel in die Variable fivem license ein
Command not found (sv_endpointprivacy)In der Edition Enhanced gesehen, die diesen Befehl nicht kennt. Diese Meldung allein stoppt den Server nicht
Could not find resourcePrüfen Sie, ob die Ressource im Ordner resources liegt
MySQL connection failedPrüfen Sie die MySQL-Verbindungszeichenkette

Schreibt FXServer „Could not authenticate server license key“, öffnet die Konsole von OuiPanel das Fenster „FiveM-Lizenzschlüssel abgelehnt“. Die Schaltfläche Servereinstellungen öffnen führt direkt zur Variable, die Sie korrigieren müssen. Auf Enhanced lautet die Meldung anders, und dieses Fenster öffnet sich nicht.

Der Server erscheint nicht in der Liste

UrsacheLösung
Ungültiger LizenzschlüsselErzeugen Sie im Cfx.re-Portal einen neuen Schlüssel
Zeilen endpoint verändertSetzen Sie den Hauptport aus der Port-Verwaltung wieder ein
Server startet nochWarten Sie einige Minuten

Eine Ressource lädt nicht

UrsacheLösung
Fehlende AbhängigkeitInstallieren Sie die Abhängigkeiten, die der Autor angibt
Fehler im SkriptLesen Sie die Serverkonsole oder die Spielkonsole mit F8
Falsche LadereihenfolgeOrdnen Sie die ensure-Zeilen neu
fxmanifest.lua fehltPrüfen Sie, ob die Datei im Ordner der Ressource liegt

Datenbankfehler

MeldungLösung
Access deniedPrüfen Sie MySQL-Benutzer und Passwort
Unknown databaseLegen Sie die Datenbank an
Connection refusedPrüfen Sie Host und Port

ACE-Berechtigungen greifen nicht

UrsacheLösung
Falsche KennungPrüfen Sie das Präfix (steam:, discord:, license:)
Server nicht neu gestartetStarten Sie nach jeder Änderung neu
TippfehlerPrüfen Sie die Syntax jeder Zeile

Brauchen Sie Hilfe?

Eröffnen Sie ein Ticket über Tickets › Ticket öffnen oder über die Kachel Support kontaktieren unten auf der Seite Ihres Servers im Kundenbereich. Sie können Ihre Frage auch auf dem Discord von OuiHeberg stellen.

War dieser Artikel hilfreich?

2.462 Aufrufe
Diesen Artikel teilen
FiveM
Brauchen Sie einen GTA/FiveM-Server?

Entdecken Sie unsere GTA V / FiveM-Hosting-Angebote ab 2,99 €/Monat, Server in 60 Sekunden bereit.

Angebote ansehen →

Verwandte Artikel