FiveM-Server einrichten

Voraussetzungen

• Ein Cfx.re-Account (derselbe Login wie im FiveM-Forum)
• Ein Server mit FXServer – gemietet oder selbst aufgesetzt (Linux oder Windows)
• Für Frameworks wie ESX oder QBCore: eine MySQL/MariaDB-Datenbank
• Grundkenntnisse im Umgang mit Textdateien

Schritt 1: Lizenzschlüssel erstellen

Jeder FiveM-Server braucht einen eigenen Lizenzschlüssel. Er ist kostenlos und wird im Cfx.re-Portal erstellt – die alte Adresse keymaster.fivem.net leitet inzwischen dorthin weiter.

1. Auf portal.cfx.re mit deinem Cfx.re-Account einloggen.
2. Im Bereich für Server-Lizenzschlüssel einen neuen Schlüssel erstellen.
3. Als IP die öffentliche IP deines Servers angeben und einen Namen vergeben.
4. Den Schlüssel kopieren und wie ein Passwort behandeln.

Bei AvantaHost gibst du den Schlüssel bei der Bestellung an. Hast du ihn noch nicht, kannst du ihn später im Dashboard bei der Bestellung nachreichen – der Server wird danach eingerichtet. Im Server-Panel steht er im Tab Start als Startvariable FIVEM_LICENSE, dort kannst du ihn auch tauschen. Änderungen greifen beim nächsten Start.

Schritt 2: Die server.cfg verstehen

Die server.cfg ist die zentrale Konfiguration. Sie liegt im Server-Datenordner neben dem Ordner resources. Eine schlanke Grundlage sieht so aus:

# Netzwerk: Port für Spieler (TCP und UDP)
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

# Standard-Ressourcen
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap

# Anzeige in der Serverliste
sv_hostname "Mein FiveM Server"
sets sv_projectName "Mein Projekt"
sets sv_projectDesc "Kurze Beschreibung deines Servers"
sets tags "roleplay, deutsch"
sets locale "de-DE"

# Slots (ohne Abo bis 48)
sv_maxclients 48

# Steam-Web-API-Key, falls Ressourcen Steam-IDs brauchen
set steam_webApiKey ""

# Lizenzschlüssel
sv_licenseKey "DEIN_SCHLUESSEL"

• endpoint_add_tcp/udp: Port 30120 ist der Standard. Bei gemieteten Servern muss hier der Port stehen, der dir zugewiesen wurde – bei AvantaHost die primäre Allocation aus dem Tab Netzwerk. Ändere ihn nicht eigenmächtig.
• sv_maxclients: Bis 48 Slots ist FiveM kostenlos. Für mehr brauchst du ein Abo im Cfx.re-Portal (ab „Element Club Argentum“). Mehr als 32 Slots erfordern OneSync.
• sets locale: Steht in der Vorlage oft auf root-AQ – ersetze das durch eine echte Sprache wie de-DE.
• sv_licenseKey: Wird bei Hostern mit Startvariable oft automatisch gesetzt. Steht dort ein Platzhalter, nicht von Hand überschreiben, solange der Server startet.

Im AvantaHost-Panel bearbeitest du die Datei im Tab Dateien direkt im Browser. Läuft txAdmin, geht das auch im txAdmin-Menü unter CFG Editor.

Schritt 3: Ressourcen installieren

Alles, was dein Server kann – Jobs, Autos, Karten, Menüs – ist eine Ressource: ein Ordner mit einer fxmanifest.lua darin.

1. Ressource herunterladen (am besten von GitHub oder aus dem Cfx.re-Forum) und entpacken.
2. Den Ordner nach resources/ hochladen. Ordner in eckigen Klammern wie [autos] sind Kategorien und dürfen weitere Ressourcen enthalten.
3. Prüfen, dass fxmanifest.lua direkt im Ressourcen-Ordner liegt – nicht eine Ebene tiefer (typischer Fehler bei GitHub-ZIPs mit Ordnern wie name-main/name/).
4. In der server.cfg eine Zeile ensure ressourcenname ergänzen. Der Name ist der Ordnername.
5. Server neu starten.

# Abhängigkeiten zuerst
ensure oxmysql
ensure ox_lib

# dann Framework und Skripte
ensure [core]
ensure [standalone]

Für Tests ohne Neustart gibt es Konsolenbefehle: refresh liest den Ordner resources neu ein, ensure name startet oder startet neu, stop name stoppt eine Ressource. Für den Dauerbetrieb gehört die ensure-Zeile trotzdem in die server.cfg.

Schritt 4: Datenbank anbinden (ESX, QBCore)

Frameworks wie ESX Legacy und QBCore speichern Spieler, Inventare und Fahrzeuge in MySQL/MariaDB. Die Verbindung läuft fast immer über oxmysql.

Im AvantaHost-Panel legst du die Datenbank im Tab Datenbanken an und bekommst dort Host, Benutzer und Passwort. Dann in die server.cfg, vor ensure oxmysql:

set mysql_connection_string "mysql://BENUTZER:PASSWORT@HOST:3306/DATENBANK?charset=utf8mb4"

Die Tabellen legt das Framework nicht immer selbst an. Meist liegt eine .sql-Datei bei, die du einmal importierst. Setzt du den Server per txAdmin-Recipe auf, fragt der Deployer die Datenbankdaten ab und erledigt den Import.

Schritt 5: OneSync richtig einstellen

OneSync ist FiveMs serverseitige Synchronisierung. Ohne OneSync verbinden sich die Clients untereinander (Peer-to-Peer), mit OneSync kennt der Server den Zustand aller Spieler und Fahrzeuge. Moderne Frameworks setzen es voraus.

Mit txAdmin stellst du OneSync unter Settings → FXServer ein (Bereich „Advanced“, Option „OneSync: On (recommended)“). Setze es dann nicht zusätzlich in der server.cfg. Ohne txAdmin gehört set onesync on in die server.cfg.

Schritt 6: Verbinden und testen

Starte FiveM, drücke F8 und verbinde dich direkt:

connect 203.0.113.10:30120

Eine Domain funktioniert ebenso: Die Gratis-Subdomain unter avantahost.de aus dem Netzwerk-Tab kannst du mit Port verwenden, z. B. connect deinserver.avantahost.de:30120. In der öffentlichen Serverliste taucht dein Server mit dem Namen aus sv_hostname auf, sofern er nicht privat geschaltet ist.

Häufige Fehler