Kundenbereich
FiveM•15. Dezember 2025• 78 Aufrufe

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

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

Wie man server.cfg auf seinem FiveM-Server konfiguriert

Geschätzte Zeit: 15 Minuten
Schwierigkeit: Mittel ⭐⭐
Kompatible Server: FiveM

📋 Einführung

Die Datei server.cfg ist die Hauptkonfigurationsdatei Ihres FiveM-Servers. Sie ermöglicht die Definition des Servernamens, der Spieleranzahl, der zu ladenden Ressourcen, der Berechtigungen und vieles mehr.

Was Sie konfigurieren können

Kategorie Beispiele
🏷️ Identität Servername, Beschreibung, Tags
🔑 Lizenz Lizenzschlüssel von Cfx.re (erforderlich)
👥 Spieler Maximale Slots, OneSync
📦 Ressourcen Skripte, Karten, Fahrzeuge
🔒 Berechtigungen ACE/ACL, Admins, Gruppen
⚙️ Netzwerk Ports, RCON

🔑 Voraussetzungen: Erhalt eines Lizenzschlüssels

Bevor Sie Ihren Server konfigurieren, müssen Sie einen kostenlosen Lizenzschlüssel auf Cfx.re erhalten.

Ein Cfx.re-Konto erstellen

  1. Gehe zu Cfx.re
  2. Klicke auf Registrieren (oder melde dich an, wenn du bereits ein Konto hast)
  3. Erstelle dein Konto mit E-Mail oder Discord

Lizenzschlüssel generieren

  1. Melde dich bei Cfx.re Keymaster an
  2. Klicke auf Registrieren eines neuen Servers
    Bild
  1. Fülle das Formular aus:
    Bild
  1. Klicke auf Generieren
  2. Kopiere den generierten Schlüssel (Format: xxxxxxxxxxxxxxxxxxxxxxxxxxxxx)

Bild

⚠️ Wichtig:

  • Ein Schlüssel = ein Server
  • Bewahre diesen Schlüssel geheim auf
  • Sie können mehrere Schlüssel für mehrere Server generieren

📁 Zugriff auf die Datei server.cfg

Über den Dateimanager

  1. Melde dich bei OuiPanel an
  2. Wähle deinen FiveM-Server aus
  3. Klicke im Seitenmenü auf Dateimanager
  4. Öffne die Datei server.cfg im Stammverzeichnis

Bild

  1. Klicke auf die Datei, um sie zu bearbeiten

Bild

⚠️ Wichtig: Stoppen Sie Ihren Server, bevor Sie diese Datei ändern, und starten Sie ihn dann neu, um die Änderungen zu übernehmen.

🏷️ Grundkonfiguration

Lizenzschlüssel (Erforderlich)

sv_licenseKey "your_license_key_here"

Ersetzen Sie dies durch den auf Keymaster erhaltenen Schlüssel.

⚠️ Ohne gültigen Lizenzschlüssel wird Ihr Server nicht starten.

Servername

sv_hostname "Mein FiveM-Server | Roleplay DE"

Dies ist der Name, der in der Liste der FiveM-Server angezeigt wird.

Tipps für den Namen:

  • ✅ Kurz und einprägsam
  • ✅ Typ einschließen (RP, Freeroam, Drift...)
  • ✅ Sprache einschließen (DE, EN...)
  • ✅ Emojis sparsam verwenden

Beispiele:

sv_hostname "🇩🇪 Revolution RP | Seriöses Roleplay"
sv_hostname "Los Santos Life | RP auf Deutsch"
sv_hostname "Drift Paradise | Rennen & Tuning"

Serverbeschreibung

sv_projectDesc "Französischer Roleplay-Server mit realistischer Wirtschaft, vielfältigen Berufen und aktiver Community."

Die Beschreibung wird in den Serverdetails angezeigt. Empfohlen sind maximal 200 Zeichen.

Projektname

sv_projectName "Revolution RP"

Kurzer Projektname (angezeigt in bestimmten Menüs).

Server-Tags

sets tags "roleplay, deutsch, seriös, wirtschaft, jobs"

Tags für die Listung in der Serverliste. Trennen Sie sie durch Kommas.

Beliebte Tags:

  • roleplay, rp, seriös, halb-seriös
  • deutsch, german, de
  • wirtschaft, jobs, polizei, ems
  • custom-cars, drift, rennen
  • esx, qbcore, vrp

Serverbild/Banner

load_server_icon server_icon.png

Zeigt ein Symbol in der Serverliste an.

Spezifikationen:

  • Format: PNG
  • Größe: 96x96 Pixel
  • Name: server_icon.png
  • Speicherort: Serverstammverzeichnis

👥 Spielerkonfiguration

Maximale Slotanzahl

sv_maxclients 32
Wert Empfehlung
32 Kleiner Server / Test
64 Mittlerer Server
128 Großer Server
256+ Sehr großer Server (OneSync erforderlich)

⚠️ Mehr Spieler = mehr Ressourcen erforderlich (RAM, CPU).

OneSync aktivieren

OneSync ermöglicht die Verwaltung von mehr als 32 Spielern und verbessert die Synchronisierung.

set onesync on
Modus Beschreibung
off Deaktiviert (Limit von 32 Spielern)
on Aktiviert (empfohlen)
legacy Legacy-Modus

Erweiterte OneSync-Konfiguration:

set onesync on
set onesync_population true

# Culling-Entfernung (Sichtweite von Entitäten)
set onesync_distanceCullVehicles false
set onesync_distanceCull 500

Spawnkonfiguration

spawnpoint 0 -269.4 -955.3 31.2

Standard-Spawnkoordinaten (X, Y, Z). Die meisten Frameworks (ESX, QBCore) verwalten den Spawn selbst.

📦 Ressourcenkonfiguration

Starten einer Ressource

ensure resource_name

Oder:

start resource_name

💡 ensure wird empfohlen, da es die Ressource neu startet, wenn sie abstürzt.

Lade-Reihenfolge

Die Reihenfolge von ensure ist wichtig! Einige Ressourcen sind von anderen abhängig.

Empfohlene Reihenfolge:

# 1. Grundressourcen FiveM
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. Wesentliche 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. Andere Skripte
ensure esx_vehicleshop
ensure esx_property
ensure esx_skin

# 8. Benutzerdefinierte Skripte
ensure mon_script_custom

Ressource stoppen

Um eine Ressource zu deaktivieren, kommentieren Sie die Zeile mit # :

# ensure ressource_desactivee

🗄️ Datenbankkonfiguration

MySQL-Verbindung

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

Ersetzen Sie :

  • user : MySQL-Benutzername
  • password : MySQL-Passwort
  • host : MySQL-Serveradresse
  • 3306 : MySQL-Port
  • database : Datenbankname

📖 Sehen Sie sich den Leitfaden "Erstellen und Verwalten einer MySQL-Datenbank" an, um Ihre Datenbank zu erstellen.

Beispiel mit OuiHeberg:

set mysql_connection_string "mysql://s123_bdd:[email protected]:3306/s123_bdd?charset=utf8mb4"

Alternative MySQL-Konfigurationen

JDBC-Format (veraltet):

set mysql_connection_string "server=mysql-1.ouiheberg.com;uid=s123_bdd;password=MotDePasse123;database=s123_bdd"

🔒 Berechtigungskonfiguration (ACE/ACL)

ACE-System

Das ACE-System (Access Control Entry) verwaltet die Berechtigungen auf FiveM.

Administrator hinzufügen

Nach Steam-ID (empfohlen):

add_ace identifier.steam:110000xxxxxxxxx group.admin allow
add_principal identifier.steam:110000xxxxxxxxx group.admin

Nach Discord-ID:

add_ace identifier.discord:123456789012345678 group.admin allow
add_principal identifier.discord:123456789012345678 group.admin

Nach Lizenz-ID:

add_ace identifier.license:xxxxxxxxxxxxxxxxxxxxx group.admin allow
add_principal identifier.license:xxxxxxxxxxxxxxxxxxxxx group.admin

💡 Um Ihre Steam-ID zu finden: SteamID.io

Gruppenberechtigungen erstellen

# Erstellen der Admin-Gruppe mit allen Berechtigungen
add_ace group.admin command allow
add_ace group.admin command.quit deny

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

# Berechtigungen vererben
add_principal group.admin group.moderator

Gängige Berechtigungen

# Erlauben Sie der Admin-Gruppe, alle Befehle zu verwenden
add_ace group.admin command allow

# Spezifische 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.kick allow
add_ace group.moderator vMenu.ban allow

Spieler einer Gruppe zuweisen

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

⚙️ Netzwerkkonfiguration

Serverport

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

⚠️ Bei OuiHeberg wird der Port automatisch verwaltet. Verwenden Sie den Ihrem Server zugewiesenen Port.

RCON (Remote Console)

rcon_password "MotDePasseRconTresSecure"

Ermöglicht die Fernsteuerung des Servers. Verwenden Sie ein sicheres Passwort!

💡 Lassen Sie das Feld leer, um RCON zu deaktivieren: rcon_password ""

Steam-Konfiguration

set steam_webApiKey "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

Steam-API-Schlüssel (optional, für bestimmte Funktionen). Erhalten Sie ihn unter: Steam Web API Key

🎮 Gameplay-Konfiguration

Funktionen aktivieren/deaktivieren

# Automatischen Passivmodus deaktivieren
sv_disablePassive false

# PvP aktivieren
sv_enablePVP true

# Zeit synchronisation deaktivieren
sv_disableTimeSync true

# FiveM-Logo beim Laden anzeigen
sv_showFiveMBanner true

Hardcore-/Serious-Modus

# Automatischen Radar deaktivieren
sv_disableRadar true

# Native Benachrichtigungen deaktivieren
sv_disableClientNotify true

# Serious RP-Modus
set sv_enforceGameBuild 2944

Spiel-Build

sv_enforceGameBuild 2944

Zwingt eine spezifische Version von GTA V. Nützlich für die Ressourcenkompatibilität.

Build GTA V-Version
2060 Los Santos Summer Special
2189 Cayo Perico
2372 Los Santos Tuners
2545 The Contract
2699 Criminal Enterprises
2944 San Andreas Mercenaries
3095 Chop Shop

📜 Nützliche Convars-Variablen

Variablen definieren

set ma_variable "valeur"
setr ma_variable_repliquee "valeur"
sets ma_variable_serverinfo "valeur"
Befehl Sichtbarkeit
set Nur Server
setr An Clients repliziert
sets In Serverinfos sichtbar

ESX-Framework-Variablen

set es_enableCustomData 1
set es_startingCash 50000
set es_startingBank 100000
set es_startingBlackMoney 0

QBCore-Framework-Variablen

set qb_locale "fr"
set qb_starterMoney 5000
set qb_starterBank 10000

📄 Vollständige server.cfg-Datei (Beispiel)

Hier ist ein Beispiel für eine vollständige und funktionierende server.cfg:

# ============================================
# FIVEM SERVER CONFIGURATION
# ============================================

# === LICENSE ===
sv_licenseKey "your_license_key_here"

# === SERVER IDENTITY ===
sv_hostname "🇫🇷 My RP Server | Serious Roleplay"
sv_projectName "My RP Server"
sv_projectDesc "French roleplay server with realistic economy and active community."
sets tags "roleplay, french, serious, esx, economy"
load_server_icon server_icon.png

# === PLAYERS ===
sv_maxclients 64
set onesync on

# === NETWORK ===
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

# === RCON ===
rcon_password ""

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

# === STEAM (Optional) ===
# set steam_webApiKey "XXXXXXXXXXXXXXXXXXXXXXXXXX"

# === GAMEPLAY ===
sv_enforceGameBuild 2944

# ============================================
# ACE/ACL PERMISSIONS
# ============================================

# Admin Group
add_ace group.admin command allow
add_ace group.admin command.quit deny

# Administrators (replace with your identifiers)
# add_principal identifier.steam:110000xxxxxxxxx group.admin
# add_principal identifier.discord:123456789012345678 group.admin

# ============================================
# RESOURCES
# ============================================

# === FiveM Base ===
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure rconlog

# === Database ===
ensure oxmysql

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

# === ESX Scripts ===
ensure esx_identity
ensure esx_society
ensure esx_billing
ensure esx_banking
ensure esx_skin

# === Jobs ===
ensure esx_policejob
ensure esx_ambulancejob
ensure esx_mechanicjob

# === Other Scripts ===
ensure esx_vehicleshop
ensure esx_property

# === Custom Scripts ===
# ensure my_script

🔧 Troubleshooting

The server does not start

❌ Error ✅ Solution
Invalid license key Check your key on Keymaster
License key not set Add sv_licenseKey in server.cfg
Could not find resource Ensure the resource exists in the resources folder
MySQL connection failed Check the MySQL connection string

The server does not appear in the list

❌ Cause ✅ Solution
Invalid license key Regenerate a key on Keymaster
Port blocked Ensure TCP/UDP ports are open
Server starting up Wait a few minutes

Resource not loading

❌ Cause ✅ Solution
Missing dependency Check required dependencies
Error in script Check the console (F8 in-game)
Incorrect loading order Reorganize the ensure
fxmanifest.lua missing Ensure the file exists

Database Error

❌ Error ✅ Solution
Access denied Check MySQL user/password
Unknown database Create the database
Connection refused Check host and port

ACE Permissions Not Applied

❌ Cause ✅ Solution
Incorrect identifier Check format (steam:, discord:, license:)
Server not restarted Restart after modification
Typo Check syntax

📝 Useful Console Commands

Command Description
restart [resource] Restart a resource
stop [resource] Stop a resource
start [resource] Start a resource
refresh Refresh the resource list
status Display connected players
quit Stop the server

📝 Summary

1. Obtain a license key on Keymaster (Cfx.re)
2. Stop the server
3. File manager → server.cfg → Edit
4. Configure:
   - sv_licenseKey (mandatory)
   - sv_hostname (server name)
   - sv_maxclients (slots)
   - mysql_connection_string (database)
   - Resources (ensure)
   - ACE Permissions (admins)
5. Save the file
6. Restart the server
7. Check in the FiveM server list
Zurück zur Dokumentation