Einrichten Ihres FiveM-Servers: Lizenzschlüssel, server.cfg und Ressourcen

Ein FiveM-Server benötigt drei Dinge, um zu laufen: einen kostenlosen Cfx.re-Lizenzschlüssel, eine funktionierende server.cfg und Ihre Ressourcen (Skripte, Karten und Frameworks). Dieser Leitfaden hilft Ihnen, alle drei richtig einzurichten, damit Ihr Server startet und in der Serverliste angezeigt wird.

1. Einen Cfx.re-Lizenzschlüssel generieren

Jeder FiveM-Server benötigt einen Lizenzschlüssel vom Cfx.re Keymaster – er ist kostenlos.

1. Gehen Sie zu keymaster.fivem.net und melden Sie sich mit Ihrem Cfx.re (Forum)-Konto an.
2. Klicken Sie auf New server key / Register.
3. Für die IP können Sie einen Schlüssel für die IP Ihres Servers registrieren oder einen nicht gelisteten Schlüssel generieren (für die meisten Setups ausreichend). Hinweis: Ein Schlüssel ist an die Art und Weise gebunden, wie Sie ihn registrieren. Wenn Sie also jemals den Server wechseln, benötigen Sie möglicherweise einen neuen Schlüssel.
4. Kopieren Sie den Schlüssel – er sieht aus wie eine lange zufällige Zeichenfolge.

2. Den Schlüssel zu server.cfg hinzufügen

1. Öffnen Sie Ihren Server und klicken Sie auf File Manager.

2. Öffnen Sie server.cfg im Stammverzeichnis.

3. Suchen Sie die Zeile sv_licenseKey (oder fügen Sie eine hinzu) und fügen Sie Ihren Schlüssel ein:

   sv_licenseKey your_key_here
   

4. Speichern Sie und starten Sie den Server über den Tab Console neu.

Ohne einen gültigen Schlüssel wird in der Konsole Invalid license key ausgegeben und der Server geht nicht online.

3. server.cfg verstehen

server.cfg ist das Herzstück Ihres Servers. Die Zeilen, die Sie am häufigsten bearbeiten werden:

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

sv_hostname "My ServerPrism FiveM Server"
sv_maxclients 32
sets locale "en-US"

# Load resources
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure my-custom-resource

sv_licenseKey your_key_here

• sv_hostname — der Name Ihres Servers im FiveM-Serverbrowser.
• sv_maxclients — Spieler-Slots (bis zu 48 bei Standard-Builds).
• ensure <name> — startet eine Ressource beim Booten. So aktivieren Sie Skripte.

Ändern Sie den Endpunkt-Port nicht, es sei denn, Sie kennen Ihre Zuweisung. Der Spielport von FiveM wird durch Ihre ServerPrism-Zuweisung festgelegt – der Standardwert 30120 ist für die meisten Server korrekt. Überprüfen Sie den Tab Startup/Network, wenn Sie unsicher sind.

4. Ressourcen hinzufügen

Ressourcen (Skripte, Karten, Frameworks wie ESX oder QBCore) gehören in den Ordner resources/.

1. Laden Sie den Ressourcenordner über den File Manager oder SFTP in resources/ hoch (SFTP ist besser für große Frameworks – siehe File Manager & SFTP).
2. Fügen Sie für jede Ressource, die Sie ausführen möchten, eine Zeile ensure <resource-name> zu server.cfg hinzu.
3. Starten Sie neu. Beobachten Sie die Konsole – jede Ressource gibt Started resource <name> aus, wenn sie geladen wird.

Für ein vollständiges Rollenspiel-Framework installieren Sie dessen Basisressourcen in der Reihenfolge, die in der Dokumentation angegeben ist (normalerweise zuerst eine Datenbank + Core-Framework, dann abhängige Skripte).

Datenbanken (ESX/QBCore)

Rollenspiel-Frameworks benötigen eine MySQL-Datenbank. Erstellen Sie eine auf dem Tab Databases und verweisen Sie die Konfiguration des Frameworks (normalerweise über mysql_connection_string in server.cfg oder einer Framework-Konfigurationsdatei) auf die Anmeldeinformationen. Siehe Eine MySQL-Datenbank erstellen und verbinden.

Datenbank-Eigenheit auf demselben Knoten: Wenn sich Ihre DB und Ihr FiveM-Server auf demselben Knoten befinden und das Framework keine Verbindung über die öffentliche IP herstellen kann, eröffnen Sie ein Support-Ticket – dies ist ein bekannter Netzwerkfall, den wir schnell beheben können, indem wir die Container überbrücken.

Häufige Probleme

• Invalid license key: Der Schlüssel ist falsch, abgelaufen oder auf eine andere IP registriert – generieren Sie ihn im Keymaster neu.
• Server nicht im Browser: Er startet noch, sv_hostname ist nicht gesetzt oder eine Ressource verursacht einen Fehler – lesen Sie die Konsole für den ersten error.
• Eine Ressource startet nicht: Überprüfen Sie die Konsole auf die erste Fehlerzeile unter dieser Ressource; es handelt sich normalerweise um eine fehlende Abhängigkeit oder eine Datenbank, die nicht erreicht werden kann.
• ghmattimysql/oxmysql Fehler: Die Datenbank-Verbindungszeichenfolge ist falsch – kopieren Sie die Anmeldeinformationen neu vom Tab Databases.

Immer noch Probleme?

Eröffnen Sie ein Support-Ticket mit der ersten error-Zeile aus Ihrer Konsole und der Ressource, die sie erwähnt. Wir können die Konfiguration direkt auf dem Knoten überprüfen.