FiveM Server erstellen: Anleitung mit txAdmin

Cfx.re-Lizenzschlüssel anlegen

Jeder FiveM Server braucht einen Lizenzschlüssel. Er ist kostenlos und an Ihr Cfx.re-Konto gebunden.

1. Melden Sie sich mit Ihrem Cfx.re-Konto im Lizenzportal von Cfx.re (Keymaster) an.
2. Legen Sie einen neuen Serverschlüssel an und geben Sie den Servernamen sowie die IP-Adresse der Maschine ein, auf der er laufen wird.
3. Speichern Sie den Schlüssel sicher ab. Der Einrichtungsassistent fragt danach.

Geben Sie den Schlüssel nicht weiter. Er hängt an Ihrem Konto, bei Missbrauch tragen Sie die Verantwortung.

Serverdateien (Artifacts) herunterladen

Die kompilierten Versionen von FXServer heißen „Artifacts“ und werden auf den offiziellen Artifacts-Seiten von Cfx.re getrennt für Windows und Linux veröffentlicht. In der Liste ist meist eine empfohlene (recommended) Version markiert; nehmen Sie diese für einen neuen Server.

Unter Windows:

1. Legen Sie einen Ordner an, etwa C:\FXServer\server.
2. Laden Sie von der Windows-Artifacts-Seite die Datei server.7z der empfohlenen Version herunter und entpacken Sie sie in diesen Ordner.
3. Starten Sie FXServer.exe aus dem Ordner. Damit startet txAdmin.

Unter Linux:

1. Legen Sie einen Ordner wie ~/FXServer/server an und wechseln Sie hinein.
2. Laden Sie von der Linux-Artifacts-Seite die Datei fx.tar.xz der empfohlenen Version herunter und entpacken Sie sie:

   tar xf fx.tar.xz
   

3. Starten Sie den Server:

   ./run.sh
   

Unter Linux sorgen Werkzeuge wie screen oder tmux dafür, dass der Server weiterläuft, wenn Sie das Terminal schließen.

Einrichtung mit txAdmin (ESX / QBCore)

txAdmin ist das webbasierte Verwaltungswerkzeug, das mit FXServer ausgeliefert wird. Starten und Stoppen, geplante Neustarts, Spielerverwaltung und Logs erledigen Sie im Browser.

1. Beim ersten Start von FXServer zeigt die Konsole die Adresse von txAdmin und eine 4-stellige PIN. Öffnen Sie http://localhost:40120 im Browser (läuft der Server auf einer anderen Maschine, nutzen Sie deren IP statt localhost).
2. Geben Sie die PIN ein und verknüpfen Sie txAdmin mit Ihrem Cfx.re-Konto. Legen Sie dann ein Admin-Passwort für txAdmin fest.
3. Geben Sie dem Server im Assistenten einen Namen und wählen Sie als Bereitstellungsart Popular Recipes.
4. Wählen Sie eine Vorlage (Recipe):
   • CFX Default: ein leerer Basisserver.
   • ESX Legacy: das verbreitete Roleplay-Framework mit Jobs, Inventar und Wirtschaft.
   • QBCore Framework: ein Roleplay-Framework mit modernem Aufbau und vielen fertigen Skripten.
   • Qbox: eine leistungsorientierte Weiterentwicklung mit QBCore-Kompatibilität.
5. Bestätigen Sie den Ordner, in den die Serverdateien installiert werden.
6. Der Assistent fragt nach Lizenzschlüssel und Datenbankdaten. Danach installiert die Vorlage Framework, Datenbanktabellen und Basisskripte automatisch.
7. Starten Sie den Server anschließend über txAdmin und prüfen Sie die Konsole auf Fehler.

Wichtige Zeilen in der server.cfg

txAdmin legt eine server.cfg mit den Grundeinstellungen des Servers an. Diese Zeilen bearbeiten Sie am häufigsten:

sv_hostname "Name Ihres Servers"
sets sv_projectName "Projektname"
sets sv_projectDesc "Kurze Beschreibung"
sets tags "roleplay, deutsch"
sets locale "de-DE"
sv_maxclients 48
sv_licenseKey "ihr-lizenzschluessel"
set onesync on
ensure oxmysql

• sv_hostname, sv_projectName und sv_projectDesc sind Name und Beschreibung in der Serverliste.
• sets tags und sets locale helfen Spielern, Ihren Server über die Filter der Liste zu finden.
• sv_maxclients ist die maximale Spielerzahl. Mit einem kostenlosen Schlüssel sind höchstens 48 möglich.
• set onesync on aktiviert die serverseitige Synchronisierung; ab 32 Spielern ist sie Pflicht.
• ensure-Zeilen legen fest, welche Skripte in welcher Reihenfolge starten.

Änderungen an der server.cfg greifen nach einem Neustart des Servers.

Geplante Neustarts und Backups

Auf einem FiveM Server, der lange läuft, sammeln manche Skripte mit der Zeit Speicher an. Mit dem Restart Schedule von txAdmin starten Sie den Server täglich zur ruhigsten Uhrzeit automatisch neu; txAdmin warnt die Spieler vorher. Ein regelmäßiges Datenbank-Backup sorgt außerdem dafür, dass Sie Charaktere und Inventare nach einem fehlerhaften Skript-Update wiederherstellen können.

Datenbank (MariaDB)

Die Vorlagen für ESX und QBCore brauchen eine MySQL-Datenbank. Wir empfehlen MariaDB, die quelloffene, MySQL-kompatible Lösung.

1. Installieren Sie MariaDB. Unter Windows mit dem offiziellen Installer, unter Linux über den Paketmanager Ihrer Distribution.
2. Vergeben Sie bei der Installation ein starkes Passwort für den Benutzer root.
3. Fragt der txAdmin-Assistent nach den Datenbankdaten, tragen Sie localhost als Host sowie den eben gewählten Benutzer und das Passwort ein. Die Vorlage legt die Datenbank selbst an.

Nach der Einrichtung verbinden sich die Skripte über oxmysql mit der Datenbank. Die Verbindungsdaten stehen in dieser Zeile der server.cfg:

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

Läuft die Datenbank auf derselben Maschine wie der Spielserver, werden Abfragen ohne Netzwerklatenz beantwortet. Sichern Sie sie regelmäßig; Charaktere, Fahrzeuge und Inventare liegen alle dort.

Port 30120 und Firewall

Ein FiveM Server nutzt standardmäßig Port 30120 für TCP und UDP. txAdmin läuft auf TCP-Port 40120.

• Windows: Legen Sie in der Windows Defender Firewall eingehende Regeln für 30120 TCP und 30120 UDP an.
• Linux (ufw):

  sudo ufw allow 30120/tcp
  sudo ufw allow 30120/udp
  

• Am Heimanschluss: Richten Sie am Router, etwa an der FRITZ!Box, eine Portfreigabe für 30120 TCP und UDP auf die lokale IP des Servers ein. Bei DS-Lite- oder CGNAT-Anschlüssen ohne eigene öffentliche IPv4-Adresse funktioniert das nicht.

Statt Port 40120 für alle zu öffnen, lassen Sie besser nur Ihre eigene IP zu. Gameserver sind häufige Angriffsziele, daher ist auch ein DDoS-Schutz vor dem Server wichtig; warum, erklären wir in Was ist ein DDoS-Angriff?

Mit dem Server verbinden

1. Öffnen Sie den FiveM-Client und drücken Sie F8 für die Konsole.
2. Geben Sie connect server-ip:30120 ein und drücken Sie Enter. Läuft der Server auf demselben Rechner, genügt connect localhost.
3. Sobald sich Ihr Server bei der Liste angemeldet hat, finden Spieler ihn auch über die Suche im Serverbrowser von FiveM.

Admin-Rechte im Spiel erhalten Sie über das Ingame-Menü von txAdmin (Befehl /tx) oder über die Rechtebefehle Ihres Frameworks.

Häufige Fehler

• Lizenzschlüssel kann nicht geprüft werden: Der Schlüssel wurde falsch kopiert oder für eine andere IP-Adresse angelegt. Prüfen Sie die IP des Schlüssels im Keymaster.
• Keine Verbindung zur Datenbank: Meldet oxmysql einen Verbindungsfehler, prüfen Sie, ob MariaDB läuft und ob Benutzer, Passwort und Datenbankname im mysql_connection_string stimmen.
• Ein Skript lädt nicht: Das passiert, wenn ein Skript vor einem Skript gestartet wird, von dem es abhängt. Starten Sie Abhängigkeiten zuerst.
• Port bereits belegt: Nutzt ein anderer FXServer oder ein anderes Programm Port 30120 auf derselben Maschine, startet der Server nicht. Beenden Sie den alten Prozess oder ändern Sie den Port.
• Spieler können sich nicht verbinden: Prüfen Sie, ob 30120 in der Firewall für TCP und UDP offen ist und am Heimanschluss die Portfreigabe eingerichtet ist.
• Der Server ruckelt: Mit resmon 1 in der F8-Konsole sehen Sie, wie viel Zeit jedes Skript braucht. Skripte, die im Leerlauf viel Zeit verbrauchen, müssen meist optimiert werden.
• Die Serverliste zeigt einen alten Namen: Die Listendaten werden in Intervallen aktualisiert. Starten Sie den Server nach der Namensänderung in der server.cfg neu und warten Sie einige Minuten.
• Spieler sehen „Couldn't load resource“: Meist fehlen Dateien eines Skripts oder sie sind beschädigt. Laden Sie das Skript erneut hoch und prüfen Sie, ob die fxmanifest.lua vorhanden ist.

Einen Server selbst aufzusetzen ist lehrreich. Wächst Ihr Server, brauchen Sie aber eine Maschine, die rund um die Uhr läuft, hoch getaktet ist und hinter einem DDoS-Schutz steht. FiveM Server mieten bei Nodesty heißt: Ryzen 9 9950X und DDoS-Schutz, bereit für txAdmin, OneSync, ESX und QBCore. Sie möchten auch einen Minecraft Server betreiben? Unsere Anleitung Minecraft Server erstellen zeigt Ihnen den Weg.