Was ein cfx.re Join Code ist und wo du deinen findest

Jeder FiveM Server hat einen Join Code: die sechs Zeichen am Ende von cfx.re/join/xxxxxx. Es ist die Adresse, die Spieler benutzen, der Schlüssel, nach dem jede Status API sucht, und die eine Zeichenkette, die deine Website braucht, um eine Live Spielerzahl anzuzeigen.

Es ist auch das, was die meisten aufschieben, weil es wie ein Implementierungsdetail aussieht. Ist es nicht. Es ist das, was deinem Server am nächsten an einer Telefonnummer kommt.

Was es tatsächlich ist

Ein Join Code ist ein stabiler Alias für deinen Server, ausgegeben von Cfx.re und beim Verbinden von deren Infrastruktur aufgelöst.

Diese Indirektion ist der ganze Sinn. Eine rohe host:port Adresse bindet deine Community an eine Maschine mit einer IP. Wenn du den Hoster wechselst, den Anbieter wechselst, eine neue IP bekommst oder hinter einen Proxy ziehst, funktioniert die Adresse, die deine Spieler auswendig können, nicht mehr, und du musst sie überall neu verteilen. Ein Join Code überlebt all das, weil sich der Eintrag ändert, den Cfx.re auflöst, und nicht das, was du veröffentlicht hast.

Für eine Community Website wiegt das schwerer, als es klingt. Die Adresse ist die meistkopierte Zeichenkette, die du veröffentlichst. Sie steht in deinem Discord, in deinen Videos, in deinen Einträgen und in Forenbeiträgen anderer Leute, über die du keine Kontrolle hast. Alles, was dich zwingt, sie zu ändern, ist teuer.

Wo du deinen findest

Drei Orte, nach der Wahrscheinlichkeit sortiert, dass es gerade funktioniert.

Die F8 Konsole, im Spiel. Verbinde dich mit deinem eigenen Server, drück F8, und die Verbindungszeile enthält den Code. Das ist die zuverlässigste Methode, weil sie meldet, was Spieler wirklich aufgelöst haben, und nicht, was du zu konfigurieren glaubst.

Dein Servereintrag. Finde deinen Server im FiveM Serverbrowser, und der Code steht in der URL seiner Eintragsseite.

txAdmin. Wenn du über txAdmin ausgerollt hast, erscheint der Code im Panel, sobald sich der Server bei Cfx.re registriert hat. Dafür muss der Server mindestens einmal hochgekommen und erfolgreich eingecheckt sein, es hilft also nicht, solange du noch den Start debuggst.

Wenn keiner der drei einen Code liefert, hat sich dein Server nicht erfolgreich bei Cfx.re registriert. Das ist ein Serverproblem und kein Lookup Problem, und es heißt meistens, dass der Server von außerhalb deines eigenen Netzes nicht erreichbar ist.

Wunschcodes

Manche Server haben einen lesbaren Code statt sechs zufälliger Zeichen. Das sind Vanity Codes, und sie lösen sich genauso auf wie ein generierter.

Gut zu wissen, wenn du irgendetwas schreibst, das Codes verarbeitet: ein Vanity Code und ein generierter Code sind dasselbe, und dieselben APIs akzeptieren beide. Wenn du Eingaben in einem Lookup Formular prüfst, nimm nicht an, dass es sechs Zeichen sind.

Darf man ihn veröffentlichen

Ja. Er ist dafür gedacht. Er ist das, was du Spielern gibst.

Zwei Dinge lohnt es zu trennen, weil sie oft vermischt werden:

• Der Join Code ist per Design öffentlich. Er ist eine Adresse. Ihn zu veröffentlichen ist der Sinn davon, einen zu haben.
• Die rohe IP und der Port deines Servers sind streng genommen auch nicht geheim, denn jeder Verbundene kann sie sehen. Aber es gibt keinen Grund, sie zu veröffentlichen, und wer es tut, liefert einem möglichen Angreifer ein Ziel, das an allem vorbeigeht, was Cfx.re davor stellt. Veröffentliche den Code, nicht die Adresse.

Wenn deine Website gerade ein rohes host:port zum Einfügen in die Konsole zeigt, ersetz es durch einen Join Link. Das ist besser für Spieler, und es ist eine Sache weniger, die du beim nächsten Hosterwechsel ändern musst.

Wie du ihn auf deiner Website nutzt

Zwei Aufgaben, und der Code erledigt beide.

Ein Beitreten Button. Ein Link auf https://cfx.re/join/xxxxxx öffnet FiveM und verbindet. Keine Anleitung, kein Kopieren und Einfügen, kein "öffne die Konsole und tippe connect". Wenn deine Seite gerade in einem Absatz erklärt, wie man sich verbindet, kann dieser Absatz ein Button werden.

Live Status. Jede FiveM Statusabfrage läuft über den Join Code. Gib einem Widget den Code, und es kann melden, ob der Server läuft, wie viele Spieler darauf sind und wie viele Slots er hat. Das steht ausführlich in Live Serverstatus auf deiner Website zeigen.

Bei RPWebsite kommen beide aus einem einzigen Konfigurationswert. Setz den Join Code, und Beitreten Button, Spielerzahl und Spielerliste fangen gemeinsam an zu funktionieren.

Häufige Probleme

Der Code funktioniert im Spiel, aber eine Statusabfrage liefert nichts. Fast immer ein Tippfehler, ein Leerzeichen vorne oder hinten, oder ein mitkopiertes cfx.re/join/ Präfix, das nicht entfernt wurde. Abfragen nehmen den nackten Code.

Der Code hat sich geändert. Generierte Codes sind für die Lebensdauer der Serverregistrierung stabil. Wenn deiner sich geändert hat, wurde der Server neu registriert, was meistens heißt, dass er von Grund auf neu gebaut und nicht neu gestartet wurde. Prüfe überall dort, wo du ihn fest eingetragen hast.

Eine Abfrage funktioniert von deinem Laptop und nicht von deiner veröffentlichten Seite. Deine Seite stellt die Anfrage aus einem Rechenzentrum und nicht aus einem Privatanschluss, und Rechenzentrumsbereiche werden von manchen Gegenstellen anders behandelt. Cache großzügig, und stell die Anfrage nicht einmal pro Besucher.