# RPFX auf einem FiveM-Server einrichten

Diese Datei ist zum Weitergeben an eine KI gedacht. Wirf sie in Claude,
ChatGPT, Antigravity, Gemini oder was du sonst benutzt und schreib dazu:

> Lies das und führ mich Schritt für Schritt durch die Einrichtung.
> Frag mich, wo ich gerade stehe.

Sie beschreibt den vollständigen Weg von einem leeren FiveM-Server bis zu
einer laufenden RPFX-Installation, dazu die Fehlerbilder, an denen es
üblicherweise hängt.

Portal (Server einbinden, Paket herunterladen): https://rpfx.org
Admin-Dashboard (Items, Shops, Gruppen):        https://admin.rpfx.org

---

## RPFX auf einem FiveM-Server einrichten

So kommt RPFX auf einen FiveM-Server. Der Ablauf dauert etwa 15
Minuten und läuft einmal pro Server.

VORAUSSETZUNGEN

1. Ein lauffähiger FiveM-Server, auf den du Dateien kopieren kannst (eigener
   Root-Server, gemieteter Gameserver mit Dateizugriff, txAdmin).
2. Für die ERSTE Einrichtung: eine möglichst leere server.cfg. Andere
   Ressourcen per "ensure" zu laden ist später kein Problem, macht die
   Fehlersuche am Anfang aber unnötig schwer.

Node.js brauchst du NICHT. Das Paket bringt alles mit, was es zur Laufzeit
benötigt; die Runtime dafür steckt im FiveM-Server selbst. Es gibt in der
gesamten Einrichtung keinen Befehl zum Eintippen.

SCHRITT 1 – PAKET HERUNTERLADEN

Auf rpfx.org mit Discord anmelden und im Server-Portal das aktuelle
rpfx-core-Paket herunterladen (ZIP).

SCHRITT 2 – DATEIEN KOPIEREN

Das ZIP entpacken. Danach liegen zwei Dinge an ihrem Platz:

  FiveM-Server/
  ├── server.cfg
  ├── rpfx.cfg              <- aus dem ZIP, neben die server.cfg
  └── resources/
      └── rpfx-core/        <- aus dem ZIP, in den resources-Ordner

SCHRITT 3 – SERVER.CFG ANPASSEN

Eine Zeile in die server.cfg, damit die rpfx.cfg beim Start gelesen wird:

  exec rpfx.cfg

Das "ensure rpfx-core" steht bereits in der rpfx.cfg – es gehört NICHT
zusätzlich in die server.cfg.

SCHRITT 4 – SERVER STARTEN UND VERKNÜPFEN

FiveM-Server starten. In der Server-Konsole erscheint ein Block mit einem
Link, weil noch kein Token hinterlegt ist:

  ======================================================================
    RPFX: Dieser Server ist noch nicht verknüpft.

    Öffne diesen Link, melde dich mit Discord an und wähle oder erstelle
    deinen Server:

    https://rpfx.org/verknuepfen?code=...
  ======================================================================

Den Link im Browser öffnen, mit Discord anmelden und entweder einen neuen
Server anlegen oder einen bestehenden auswählen. Mehr ist nicht zu tun: Der
FiveM-Server holt sich den Token von selbst, speichert ihn neben der
Ressource (rpfx-token.json) und verbindet sich. In der Konsole steht dann
"Verknüpft mit <Servername>".

Kein Token wandert dabei durch die Zwischenablage, und es ist keine Datei zu
bearbeiten. Der Link gilt 15 Minuten; läuft er ab, erscheint in der Konsole
von selbst ein neuer.

Achtung beim Auswählen eines BESTEHENDEN Servers: Dabei wird sein Token neu
ausgestellt. Alle anderen Knoten, die mit dem alten Token liefen (Slaves),
verlieren die Verbindung, bis sie den neuen bekommen.

Ob es geklappt hat, steht im Server-Portal auf der Serverkarte: Dort ist zu
sehen, ob die Ressource sich gemeldet hat. Über den Assistenten beantwortet
dasselbe das Werkzeug check_setup.

ALTERNATIVE – TOKEN VON HAND EINTRAGEN

Der frühere Weg funktioniert unverändert und wird weiterhin gebraucht: für
Slaves (die teilen sich den Token des Masters), für Automatisierung und
wenn keine Konsole zur Hand ist.

Dazu im Portal mit Discord anmelden, den Server einbinden bzw. den Token neu
ausstellen – er wird EINMALIG angezeigt, danach nur noch als Hash
gespeichert – und in die rpfx.cfg eintragen:

  set rpfx_master_server "https://data.rpfx.org"
  set rpfx_master_token "DEIN-TOKEN-HIER"

  ensure rpfx-core

Ein so eingetragener Token hat Vorrang: Steht er in der cfg, erscheint kein
Verknüpfen-Link, und eine vorhandene rpfx-token.json wird nicht beachtet.

Der Token ist ein Geheimnis. Er gehört nicht in einen Screenshot, nicht in
ein Discord-Ticket und nicht in ein öffentliches Repository. Dasselbe gilt
für die rpfx-token.json.

SCHRITT 5 – SELBST AUF DEN SERVER

Vorher einmal in FiveM: Einstellungen -> Verknüpfte Accounts -> Discord
verknüpfen, danach FiveM neu starten. RPFX erkennt Spieler an ihrer
Discord-ID; ohne Verknüpfung wird JEDER Verbindungsversuch abgewiesen, auch
der des Serverbesitzers. Der Hinweistext beim Rauswurf sagt es, aber erst
nachdem es schiefgegangen ist.

Der eigene Admin-Charakter ist schon da: Beim Einbinden des Servers wurde er
mit allen Rechten angelegt. In der Charakterauswahl steht er unter dem
Servernamen mit Nachnamen "Superadmin".

Das Admin-Dashboard unter admin.rpfx.org ist davon unabhängig – dort meldet
man sich mit demselben Discord-Account an, auch ohne je im Spiel gewesen zu
sein.

Ingame öffnet F1 das Admin-Menü und F2 das Dashboard/ACP direkt im Spiel;
beide Tasten lassen sich im Spielerprofil (mit TAB zu öffnen) unter
Tastenbelegung umlegen.

SCHRITT 6 – ERSTE SCHRITTE IM ADMIN-DASHBOARD

Die Kopfzeile des Dashboards zeigt die offenen Punkte deines Servers – ein
Symbol mit einer Zahl, dahinter eine Liste. Sie ist die maßgebliche
Aufstellung, nicht diese Anleitung: Sie misst den tatsächlichen Zustand des
Servers und verschwindet von selbst, sobald ein Punkt behoben ist. Jeder
Eintrag ist anklickbar und führt genau an die Stelle, an der man ihn
behebt. Ist dort kein Symbol, ist auch nichts offen.

Als Erstes das Discord-Audit-Log einrichten: Server-Einstellungen ->
Discord Audit-Log, dort einen Webhook hinterlegen. Ohne Webhook geht keine
Änderung nach Discord – und dieser Kanal ist die einzige Stelle, an der du
mitbekommst, was auf deinem Server geändert wird: von deinem Team, von dir
selbst und auch von einem KI-Client, der über MCP schreibt.

Zu den Katalogen: Steht in der Kopfzeile ein Hinweis zu Kleidung oder
Fahrzeugen, fehlt der jeweilige Scan. Der läuft im Spiel, nicht im
Browser-Tab – wie genau, steht im Artikel "Kleidungs- und Fahrzeugkatalog
füllen – der Scan läuft im Spiel". Steht dort kein solcher Hinweis, sind
die Kataloge gefüllt und es ist nichts zu tun.

Damit ist die Einrichtung fertig – die weitere Arbeit (Items, Shops,
Gruppen, Fraktionen) passiert im Admin-Dashboard.

---

## Die Einrichtung läuft nicht – Fehlersuche

Zuerst check_setup aufrufen. Das Werkzeug sagt, WO es klemmt, statt
raten zu lassen – es liest den Herzschlag der Ressource und die dort laufende
Version. Vier mögliche Befunde:

"NIE GEMELDET" – die Ressource ist noch nie angekommen

Das ist der häufigste Zustand nach einer frischen Einrichtung. In dieser
Reihenfolge prüfen:

1. Steht "ensure rpfx-core" in der rpfx.cfg, UND wird die rpfx.cfg über
   "exec rpfx.cfg" aus der server.cfg geladen? Fehlt eines von beidem,
   startet die Ressource nie – ohne Fehlermeldung, denn niemand hat sie
   angefordert.
2. Stimmt rpfx_master_token mit dem Token aus dem Portal überein? Ein
   falscher Token wird abgelehnt, und im Serverlog steht warum. Der Token
   muss dort aber gar nicht mehr stehen: Ist die Zeile leer oder steht noch
   der Platzhalter "xxx-xxx-xxx" darin, druckt die Server-Konsole beim Start
   einen Verknüpfen-Link. Den öffnen, mit Discord anmelden, Server wählen –
   der Rest passiert von selbst.
3. Liegt der Ordner rpfx-core wirklich unter resources/ – und heißt er genau
   so? Ein "rpfx-core-main" aus einem entpackten ZIP findet FiveM nicht.
4. Was steht im FiveM-Serverlog? Meldungen von rpfx-core stehen dort im
   Klartext und nennen den Grund.

Ein "npm install" gehört NICHT dazu, auch wenn ältere Anleitungen das noch
sagen. Das Paket bringt seine Abhängigkeiten mit; ein node_modules-Ordner
neben der Ressource ist überflüssig, nicht fehlend.

"STUMM" – hat sich gemeldet, aber lange nicht mehr

Läuft der FiveM-Server gerade überhaupt? Wenn ja, steht im Serverlog
vermutlich ein Fehler. Häufig: Der Token wurde im Portal neu ausgestellt, in
der rpfx.cfg steht aber noch der alte.

Das muss man nicht mehr von Hand richten: Wird ein Token mehrfach abgelehnt,
druckt die Server-Konsole von selbst einen Verknüpfen-Link. Öffnen, mit
Discord anmelden, denselben Server auswählen – der neue Token landet direkt
auf dem FiveM-Server. (Auf Slaves passiert das absichtlich nicht; die
bekommen den Token des Masters von Hand.)

"VERALTET" – läuft, aber auf einer älteren Fassung

Neues Paket im Portal herunterladen und den Ordner rpfx-core ersetzen, danach
neu starten. Bei aktivem Autoupdate passiert das beim nächsten Neustart von
selbst. Nachinstallieren muss man nach dem Ersetzen nichts.

"LÄUFT" – die Ressource ist da

Dann liegt ein Problem woanders. Für Fragen zu Items, Shops, Gruppen,
Fraktionen oder Rechten gibt es eigene Artikel – frag einfach nach dem
Thema.

DIE RESSOURCE LÄUFT, ABER ICH KOMME NICHT AUF DEN SERVER

Wer beim Verbinden sofort wieder rausfliegt, hat meist keine
Discord-Verknüpfung in FiveM: Einstellungen -> Verknüpfte Accounts ->
Discord, danach FiveM neu starten. RPFX erkennt Spieler an ihrer
Discord-ID – ohne sie wird jeder Verbindungsversuch abgewiesen, auch der
des Serverbesitzers.

Das gilt unabhängig von der Einrichtung und trifft später jeden neuen
Spieler genauso. Der Rauswurf nennt den Grund im Klartext, aber eben erst,
nachdem es schiefgegangen ist.

WENN NICHTS DAVON HILFT

Der Serverbetreiber sieht auf rpfx.org auf der Serverkarte denselben Befund.
Das Serverlog von FiveM ist die verlässlichste Quelle: Alles, was rpfx-core
beim Start bemängelt, steht dort.

---

## Weiterführend

Nach der Einrichtung passiert die eigentliche Arbeit im Admin-Dashboard.
Dort gibt es einen KI-Assistenten, der den Server kennt – und für die
eigenen Werkzeuge (Claude, ChatGPT, Codex, Antigravity) einen MCP-Zugang, der dieselben
Daten mit deinen Rechten bearbeiten kann. Beides findest du unter
https://admin.rpfx.org.

Diese Datei wird aus derselben Quelle erzeugt, aus der sich auch der
Assistent bedient. Sie kann also nicht veralten, ohne dass es auffällt.