FiveM-Lizenzschlüssel: Serverregistrierung über das Cfx.re Portal
Damit Ihr FiveM-Server startet, benötigt er einen Serverregistrierungsschlüssel von Cfx.re (umgangssprachlich Lizenzschlüssel genannt). Früher erhielt man diesen Schlüssel über die Keymaster-Website; heute übernimmt das Cfx.re Portal (portal.cfx.re) dieselbe Aufgabe. In dieser Anleitung erfahren Sie, wie Sie den kostenlosen Schlüssel erstellen, ihn dem Server mit sv_licenseKey bekannt machen, Authentifizierungsfehler beheben und was ein Element-Club-Abonnement bietet.
Bevor Sie beginnen
- Ein Cfx.re-Konto: Sie melden sich mit Ihrem Cfx.re-Konto am Portal an; das ist das Konto, das Sie im Cfx.re-Forum verwenden. Falls Sie keines haben, legen Sie zuerst ein Konto an.
- Ein installierter FXServer: Der Schlüssel ist erst nützlich, wenn die Serverdateien bereitstehen. Falls Sie FXServer noch nicht installiert haben, arbeiten Sie zuerst die Installationsanleitung für FXServer durch.
- Zugriff auf den Server: Mit einem Windows-VDS verbinden Sie sich per RDP, mit einem Linux-VDS per SSH. Die IP-Adresse und das anfängliche Administratorpasswort finden Sie auf der Dienstdetailseite und in der Aktivierungs-E-Mail; falls Sie sie nicht finden, lesen Sie die Anleitung zu IP-Adresse und Zugangsdaten.
- Ausgehende Verbindungen erlaubt: Bei jedem Start prüft der Server den Schlüssel durch eine Anfrage an die Cfx.re-Server. Blockiert die Firewall Ihres Betriebssystems ausgehende Verbindungen von FXServer, schlägt die Authentifizierung fehl.
Der Schlüssel selbst ist kostenlos; das kostenpflichtige Element-Club-Abonnement ändert lediglich das Slot-Limit und einige zusätzliche Vorteile. Wenn Sie noch überlegen, welchen Server Sie wählen sollen: Für FiveM empfehlen wir die Serie AMD Ryzen 9 9950X VDS mit ihrer hohen Single-Core-Leistung; die Paketoptionen finden Sie auf der Seite FiveM-Server.
1. Am Cfx.re Portal anmelden
Rufen Sie im Browser portal.cfx.re auf und melden Sie sich mit Ihrem Cfx.re-Konto an. Das Portal ist die Verwaltungsoberfläche, die das Cfx.re-Team als vollständige Neuentwicklung von Keymaster geschaffen hat: Serverschlüssel, gekaufte Ressourcen (Assets) und Ihr Element-Club-Abonnement verwalten Sie an einem Ort. Keymaster wurde inzwischen schrittweise eingestellt.
Verwenden Sie für einen neuen Schlüssel nicht die in älteren Anleitungen genannte Adresse keymaster.fivem.net. Wenn Sie früher einen Schlüssel bei Keymaster erstellt haben, sehen Sie im Portal auf der Seite „Registration Keys“ nach: Erscheint Ihr Schlüssel dort mit dem Status Active, können Sie ihn weiterverwenden; andernfalls erstellen Sie mit den folgenden Schritten einen neuen Schlüssel.
2. Serverschlüssel erstellen
- Öffnen Sie im Portal auf der Seite Servers den Bereich Registration Keys (Registrierungsschlüssel). Die direkte Adresse lautet
portal.cfx.re/servers/registration-keys. - Klicken Sie auf die Schaltfläche Generate Key.
- Im sich öffnenden Fenster wird nur ein Anzeigename (Display Name) abgefragt. Er dient dazu, den Schlüssel später wiederzuerkennen, zum Beispiel „RP Server 1“.
- Bestätigen Sie mit Generate. Der neue Schlüssel erscheint in Ihrer Liste der Registrierungsschlüssel; kopieren Sie ihn von dort.
Zu Keymaster-Zeiten fragte das Formular zusätzlich die Server-IP-Adresse und die Hosting-Art ab (VPS, Dedicated, Heimanschluss), und der Schlüssel war an diese IP gebunden. Das Portal hat diese Felder entfernt und fragt nur noch einen Namen ab; den Schritt „ermitteln Sie zuerst Ihre VDS-IP und tragen Sie sie in das Formular ein“ aus älteren Anleitungen gibt es nicht mehr. Pro Konto können Sie höchstens drei aktive (Active) Schlüssel haben. Verwenden Sie für jeden Server einen eigenen Schlüssel und betreiben Sie denselben Schlüssel nie gleichzeitig auf zwei Servern.
Der Schlüssel ist ein geheimer Wert, der Ihren Server mit Ihrem Cfx.re-Konto verknüpft; behandeln Sie ihn wie ein Passwort. Teilen Sie ihn nicht auf Discord, in einem Forum, auf einem Screenshot oder in einem öffentlichen GitHub-Repository. Wenn Sie vermuten, dass er nach außen gelangt ist, klicken Sie auf der Seite „Registration Keys“ auf den Wert Server ID des Schlüssels und wählen Sie zuerst Regenerate, dann Yes. Der Schlüssel wird erneuert; vergessen Sie nicht, den neuen Wert in Ihre Serverkonfiguration einzutragen.
3. Schlüssel in die Datei server.cfg eintragen
Der Schlüssel wird in der Datei server.cfg im Server-Datenordner über die Variable sv_licenseKey festgelegt. In der Beispielkonfiguration von Cfx.re lautet diese Zeile sv_licenseKey changeme; ersetzen Sie changeme durch Ihren eigenen Schlüssel. Wo die Datei liegt, hängt von Ihrer Installation ab:
| Installation | Datei | So bearbeiten Sie sie |
|---|---|---|
| Windows (vanilla) | C:\FXServer\server-data\server.cfg | Im Editor (Notepad) öffnen, Zeile ändern, speichern |
| Linux (vanilla) | ~/FXServer/server-data/server.cfg | Per SSH mit nano oder vim bearbeiten |
| txAdmin | Die von txAdmin erstellte server.cfg | In das Schlüsselfeld des Einrichtungsassistenten einfügen (siehe unten) |
Ein korrektes Beispiel für die lizenzbezogenen Zeilen (die Ordnerpfade entsprechen der Beispielinstallation auf docs.fivem.net):
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
sv_hostname "Your server name"
sets sv_projectName "Your community name"
sets sv_projectDesc "Short description"
set onesync on
sv_maxclients 48
sv_licenseKey "YOUR_LICENSE_KEY"
Worauf Sie achten sollten:
- Setzen Sie den Schlüssel in Anführungszeichen; lassen Sie am Anfang und am Ende keine Leerzeichen.
- Setzen Sie kein
#an den Zeilenanfang;#macht die Zeile zu einem Kommentar, und der Schlüssel wird nicht gelesen. - Die Datei sollte nur eine einzige
sv_licenseKey-Zeile enthalten. Bei zwei Zeilen gilt die letzte, was bei der Fehlersuche verwirrt. - Wenn Sie den Schlüssel nicht in die Datei schreiben möchten, können Sie dem Startbefehl
+set sv_licenseKey "YOUR_LICENSE_KEY"hinzufügen. Löschen Sie in diesem Fall die Zeile inserver.cfg, diesv_licenseKeysetzt, damit sich die beiden Werte nicht vermischen.
Wenn Sie txAdmin verwenden
Haben Sie mit txAdmin installiert, müssen Sie die Datei server.cfg nicht von Hand bearbeiten. Wechseln Sie im Einrichtungsassistenten zum Bereich Recipe Deployer, prüfen Sie das Rezept (Recipe) und fahren Sie fort; fügen Sie den aus dem Portal kopierten Schlüssel in das Feld im Schritt „Before you begin“ ein und klicken Sie auf Run Recipe. txAdmin schreibt den Schlüssel selbst in die Konfiguration, die es erstellt. Wenn Sie ihn später ändern möchten, finden Sie dieselbe Zeile im txAdmin-Panel auf der Seite „CFG Editor“. Einzelheiten finden Sie in der txAdmin-Anleitung.
4. Server starten und Authentifizierung prüfen
Unter Windows in der Eingabeaufforderung (cmd):
cd /d C:\FXServer\server-data
C:\FXServer\server\FXServer.exe +exec server.cfg
Unter Linux:
cd ~/FXServer/server-data && bash ~/FXServer/server/run.sh +exec server.cfg
Beim Start zeigt die Konsole zuerst die Zeile Authenticating server license key.... Ist die Authentifizierung erfolgreich, folgt Server license key authentication succeeded. Welcome!; sehen Sie diese Zeile, gibt es mit dem Schlüssel kein Problem. Schlägt die Authentifizierung fehl, meldet der Server einen Fehler und beendet sich; mögliche Ursachen finden Sie im Abschnitt „Häufige Fehler“.
Damit sich Spieler verbinden können, muss Port 30120 für TCP und UDP in der Firewall des Betriebssystems offen sein. Die Firewall liegt in Ihrer Hand; die Ports öffnen Sie im Betriebssystem selbst. Die einzelnen Schritte finden Sie in der Anleitung zu Firewall und Portfreigabe.
5. Element Club: Was bietet das kostenpflichtige Abonnement?
Mit dem kostenlosen Schlüssel nimmt Ihr Server mit OneSync Infinity (onesync on) höchstens 48 Spieler auf. Für mehr Slots und das Recht, eigene Kleidungspakete (EUP und Ähnliches) zu streamen, benötigen Sie ein Element-Club-Abonnement. Früher schloss man das Abonnement über Patreon ab und verknüpfte das Patreon-Konto mit dem Forenkonto. Cfx.re nimmt keine neuen Patreon-Mitgliedschaften mehr an; das Abonnement wird jetzt im Bereich Subscriptions des Portals (portal.cfx.re/subscriptions) abgeschlossen und direkt Ihrem Cfx.re-Konto gutgeschrieben. Den Schritt „verknüpfen Sie Ihr Patreon-Konto mit dem Forum“ aus älteren Anleitungen gibt es im Portal nicht.
| Stufe | Maximale Spielerzahl | Zusätzliche Vorteile |
|---|---|---|
| Kostenloser Schlüssel | 48 (OneSync Infinity) | Keine zusätzlichen Vorteile |
| Argentum | 64 (OneSync und Infinity) | Zugang zum Element Club, Streaming eigener Kleidung |
| Aurum | 64 (OneSync), 128 (Infinity) | Wie Argentum |
| Platinum | 128 (OneSync), 2048 (Infinity) | Wie Argentum; zusätzlich ein animiertes Server-Icon und eine Magenta-Hervorhebung in der öffentlichen Liste |
Die Preise gelten monatlich und werden ohne MwSt. angezeigt; den aktuellen Betrag sehen Sie auf der Element-Club-Seite von Cfx.re und im Portal. Nach dem Abschluss kann es bis zu 6 Stunden dauern, bis die Vorteile Ihrem Konto gutgeschrieben sind; vorher greifen die zusätzlichen Vorteile nicht. Wenn Sie die Slot-Anzahl erhöhen, müssen sv_maxclients und onesync zusammen betrachtet werden: Ab 32 Spielern muss onesync auf on oder legacy stehen, über 64 zwingend auf on. Zur Installation eines Kleidungspakets lesen Sie die EUP-Installationsanleitung.
Einstellungen zu Lizenz und Slots
| Einstellung | Funktion | Beispiel |
|---|---|---|
sv_licenseKey | Der Schlüssel aus dem Portal; wird beim Serverstart geprüft | sv_licenseKey "YOUR_LICENSE_KEY" |
sv_maxclients | Spielerlimit von 1 bis 2048; überschreiten Sie nicht den Wert, den Ihr Abonnement erlaubt | sv_maxclients 48 |
onesync | Modus für State Awareness; on oder legacy ab 32, on über 64. legacy wird wegen Performance-Problemen nicht empfohlen | set onesync on |
sv_hostname | Der Hostname des Servers; daneben sollten sv_projectName und sv_projectDesc gesetzt werden | sv_hostname "RP Server" |
sets sv_projectName / sets sv_projectDesc | Community-Name und eine Beschreibung in einem Satz; lange Namen werden in der Liste abgeschnitten | sets sv_projectName "Community" |
sv_master1 | Ein leerer Wert markiert den Server in der Liste als „private“; er entfernt den Server nicht vollständig aus der Hauptliste | sv_master1 "" |
Häufige Fehler
- „no license key was specified“: Der Server hat die Zeile
sv_licenseKeynie gelesen. Meist wurde der Server aus dem falschen Ordner gestartet, oder im Befehl fehlt+exec server.cfg. Starten Sie den Server aus dem Ordnerserver-datamit dem Befehl aus Schritt 4. - „Could not authenticate server license key“ oder „An error occurred while checking the server license key“: Prüfen Sie zuerst die Zeile in
server.cfg: Steht dort nochchangeme, wurde der Schlüssel mit fehlenden oder zusätzlichen Zeichen eingefügt, ist die Zeile mit#auskommentiert? Vergewissern Sie sich dann auf der Seite „Registration Keys“, dass der Schlüssel in der Liste steht und den Status „Active“ hat; einen deaktivierten Schlüssel können Sie auswählen und unten auf der Seite mit Re-Activate wieder aktivieren. Stellen Sie anschließend sicher, dass Ihre Firewall die ausgehenden Verbindungen von FXServer nicht blockiert. Alte Serverversionen (Artifacts) geben nur diese allgemeine Meldung aus; aktuelle Versionen schreiben die eigentliche Ursache in die Konsole. Sichern Sie vor dem Update Ihren Ordnerserver-data. - „Your key is not matching the initial IP address sufficiently“: Diese Meldung bedeutet, dass ein alter, an eine IP-Adresse gebundener Keymaster-Schlüssel von einer anderen IP aus verwendet wird; sie erscheint zum Beispiel, wenn Sie den Server auf einen neuen VDS umziehen. Erstellen Sie im Portal einen neuen Schlüssel (das Portal fragt keine IP ab) und ändern Sie den Wert in der Konfiguration.
- Der Schlüssel ist korrekt, wird aber nicht gelesen: Möglicherweise bearbeiten Sie die falsche Datei. Wenn Sie txAdmin verwenden, gilt die von txAdmin erstellte Konfiguration, nicht die Datei
server.cfgder Vanilla-Installation. Enthält die Datei zweisv_licenseKey-Zeilen, löschen Sie eine davon. - „You lack the required entitlement to use ...“: Eine gekaufte, verschlüsselte (Escrow-)Ressource startet nicht. Der Schlüssel auf dem Server muss zu dem Konto gehören, das die Ressource gekauft hat. Starten Sie den Server neu und prüfen Sie den Schlüssel; haben Sie die Ressource mit einem anderen Konto gekauft, können Sie sie über das Portal auf Ihr aktuelles Konto übertragen.
- Der Server startet, erscheint aber nicht in der FiveM-Liste: Auch wenn der Schlüssel authentifiziert wurde: Ist Port 30120 von außen nicht erreichbar, können sich Spieler nicht verbinden, und der Server erscheint möglicherweise nicht in der Liste. Öffnen Sie TCP und UDP 30120 in der Firewall.
- Mehr als 48 Spieler können nicht beitreten, oder Kleidung wird nicht angezeigt: Entweder haben Sie kein Element-Club-Abonnement, oder die Vorteile wurden Ihrem Konto noch nicht gutgeschrieben (bis zu 6 Stunden). Prüfen Sie, ob das Abonnement im Portal als aktiv angezeigt wird und ob der Server mit einem Schlüssel dieses Kontos läuft; ein Schlüssel eines anderen Kontos überträgt die Vorteile des Abonnements nicht.
Häufig gestellte Fragen
Ist der Lizenzschlüssel kostenpflichtig?
Nein. Der Schlüssel, den Sie im Portal erstellen, ist kostenlos und reicht aus, um den Server zu betreiben. Bezahlen müssen Sie nur ein Element-Club-Abonnement, und das richtet sich an alle, die das Slot-Limit erhöhen und eigene Kleidung streamen möchten.
Ist mein alter Schlüssel aus Keymaster noch gültig?
Wenn er auf der Seite „Registration Keys“ als „Active“ erscheint und die Authentifizierung beim Serverstart gelingt, können Sie ihn weiterverwenden. Ein alter, an eine IP-Adresse gebundener Schlüssel führt beim Umzug des Servers zum Fehler „initial IP address“; in diesem Fall ist ein neuer Schlüssel im Portal der schnellste Weg.
Kann ich mit einem Konto mehrere Server betreiben?
Ja, aber pro Konto können Sie höchstens drei aktive Schlüssel haben. Erstellen Sie für jeden Server einen eigenen Schlüssel und geben Sie ihm einen aussagekräftigen Namen, damit Sie nicht verwechseln, welcher Schlüssel auf welchem Server läuft. Wenn Sie einen ungenutzten Schlüssel deaktivieren, wird innerhalb des Limits wieder Platz frei.
Ist ein farbiger Servername im Element Club enthalten?
Ältere Anleitungen nannten für Platinum einen „farbigen Namen“. In der aktuellen Vorteilsliste von Cfx.re gibt es keinen Punkt mit dieser Bezeichnung; der Sichtbarkeitsvorteil von Platinum in der Liste besteht aus einem animierten Server-Icon und der Magenta-Hervorhebung Ihres Servers in der öffentlichen Liste. Prüfen Sie die Vorteile vor dem Abschluss in der aktuellen Liste im Portal.
Ich hatte eine Patreon-Mitgliedschaft. Was muss ich tun?
Cfx.re hat die Abonnements von Patreon in das Portal verlagert; über Patreon werden keine neuen Mitgliedschaften mehr angenommen, und der Support für alte Patreon-Mitgliedschaften wurde beendet. Um die Vorteile weiter zu nutzen, wählen Sie im Bereich „Subscriptions“ des Portals erneut dieselbe Stufe; das Abonnement wird direkt Ihrem Cfx.re-Konto gutgeschrieben.
Verwandte Anleitungen
- FXServer einrichten: FiveM-Server von Grund auf (Windows und Linux)
- txAdmin verwenden: Anleitung zur FiveM-Serververwaltung
- FiveM EUP installieren: Element-Club-Voraussetzung und eigene Kleidung hinzufügen
- Firewall und Portfreigabe auf VDS-Servern
- FiveM-Server optimieren: Resmon lesen und FPS steigern
- Alle FiveM-Anleitungen: Kategorie FiveM-Anleitungen
Kommentare0
Noch keine Kommentare
Schreiben Sie den ersten Kommentar und teilen Sie Ihre Gedanken.
Bitte melden Sie sich an oder registrieren Sie sich, um einen Kommentar zu hinterlassen.