Tutorials

How To Set Up A FiveM Test Server – Schritt-für-Schritt Anleitung

Melden

Ein lokaler Test-Server ist das wichtigste Werkzeug für jeden FiveM-Entwickler oder Server-Admin. Hier kannst du gefahrlos neue Skripte, MLOs (Maps), Fahrzeuge und Kleidung testen, ohne deinen Live-Server zu gefährden.

In dieser Anleitung erfährst du, wie du deinen eigenen lokalen FiveM-Test-Server unter Windows einrichtest.

Voraussetzungen

Bevor du beginnst, stelle sicher, dass du Folgendes installiert bzw. bereit hast:

  1. Eine installierte und funktionierende Version von Grand Theft Auto V.
  2. Den FiveM-Client.
  3. Visual C++ Redistributable (neueste Version von Microsoft – wichtig, da der Server sonst abstürzt).
  4. Einen Entpacker wie 7-Zip oder WinRAR.
  5. Einen kostenlosen Cfx.re Account (für den Lizenzschlüssel).

Schritt 1: Ordnerstruktur erstellen

Erstelle einen Ort auf deiner Festplatte, an dem dein Server leben soll. Vermeide Leer- und Sonderzeichen im Pfad.

  1. Erstelle einen neuen Ordner, z. B. unter C:\FiveM-Server\.
  2. Erstelle darin zwei Unterordner:
    • C:\FiveM-Server\artifacts (hier kommen die Systemdateien des Servers rein)
    • C:\FiveM-Server\data (hier liegen später Skripte, Maps und Konfigurationen)

Schritt 2: Server-Artifacts herunterladen

  1. Gehe auf die offizielle FiveM-Artifacts-Webseite: runtime.fivem.net/doc/artifacts.html
  2. Klicke auf den Button "LATEST RECOMMENDED", um die stabilste Server-Version herunterzuladen.
  3. Öffne die heruntergeladene Datei (server.7z) und entpacke den gesamten Inhalt in deinen zuvor erstellten Ordner C:\FiveM-Server\artifacts.

Schritt 3: FiveM-Lizenzschlüssel (License Key) erstellen

Jeder FiveM-Server – auch ein lokaler – benötigt einen gültigen Key.

  1. Besuche den Cfx.re Keymaster und logge dich ein.
  2. Klicke auf "Register" (Neuen Key erstellen).
  3. Fülle das Formular wie folgt aus:
    • Display name: z. B. Mein Testserver
    • Initial server IP address: Gib deine öffentliche IP ein (findest du via Google: „What is my IP“) oder trage 127.0.0.1 ein.
    • Server type: Wähle "Home hosted" aus.
    • Which server host provider...: Trage z. B. Localhost ein.
  4. Klicke auf Generate und kopiere den generierten Schlüssel.

Schritt 4: Server einrichten mit txAdmin (Empfohlene Methode)

txAdmin ist die offizielle Web-Oberfläche von FiveM und bereits in den Serverdateien enthalten. Sie macht die Einrichtung extrem einfach.

  1. Gehe in deinen Ordner C:\FiveM-Server\artifacts.
  2. Starte die Datei FXServer.exe per Doppelklick.
  3. Es öffnen sich zwei Fenster: Eine Windows-Konsole und dein Webbrowser mit der txAdmin-Einrichtung.
  4. txAdmin einrichten:
    • Bestätige den PIN-Code, der im Webbrowser angezeigt wird, indem du auf "Link Account" klickst.
    • Lege ein Master-Passwort für dein txAdmin-Panel fest.
  5. Server Deployment (Assistent):
    • Server Name: Vergib einen Namen für deinen Testserver.
    • Deployment Type: Wähle "Popular Recipes" (für Vorlagen) oder "Local Server Data" (wenn du komplett leer starten willst).
    • Empfehlung für Anfänger: Wähle "CFX Default FiveM" (Minimales Grundgerüst) oder ein Framework wie "QBCore" / "ESX Legacy", falls du ein fertiges Rollenspiel-System testen willst.
    • Target Directory: txAdmin schlägt meist automatisch den Ordner vor (überprüfe, dass er auf deinen FiveM-Server-Ordner zeigt).
    • License Key: Füge hier den Schlüssel ein, den du in Schritt 3 im Keymaster kopiert hast.
  6. Klicke auf "Run Recipe" bzw. "Save & Start Server".

Schritt 5: Dem Test-Server beitreten

Dein Server läuft nun lokal auf deinem PC!

  1. Starte deinen FiveM-Client.
  2. Drücke im Hauptmenü die Taste F8, um die Konsole zu öffnen.
  3. Tippe folgenden Befehl ein und drücke Enter:
    connect localhost

    (Alternativ kannst du im Menü oben auf "Play" klicken und dich über den Button "Localhost" direkt verbinden).

Wichtige Tipps für deinen Test-Server

  • Kein Port-Forwarding nötig: Da der Server nur auf deinem eigenen Rechner läuft (Localhost), musst du keine Ports in deinem Router freigeben. Andere Personen können so allerdings nicht beitreten.
  • Server stoppen & starten: Du kannst den Server jederzeit über das Browser-Panel von txAdmin (Standardadresse: http://localhost:40120/) neustarten, stoppen oder Ressourcen einsehen.
  • Dateien bearbeiten: Deine Skripte findest du im generierten Ordner unter txData/.../resources. Die Grundeinstellungen liegen in der server.cfg.
  • F8-Konsole im Spiel: Nutze im Spiel immer die Taste F8, um Fehlermeldungen von Skripten (Clientside) direkt zu sehen. Serverseitige Fehler werden in der Windows-Konsole bzw. im txAdmin-Terminal ausgegeben.
0