Wie installiere ich QBCore mit txAdmin auf meinem FiveM-Server?

QBCore ist das beliebteste Roleplay-Framework für FiveM, aber die manuelle Installation — Dutzende Resources, eine Datenbank und eine funktionierende server.cfg — ist fehleranfällig. Die gute Nachricht: txAdmin bringt ein fertiges Recipe mit, das dir das komplette Framework in wenigen Minuten aufsetzt. In dieser Anleitung legst du zuerst eine Datenbank im Panel an, deployst anschließend das QBCore-Recipe über den txAdmin-Setup-Wizard und loggst dich zum Schluss als Admin in deine eigene Stadt ein.

QBCore oder Qbox? Qbox (qbx_core) ist eine moderne Weiterentwicklung von QBCore — mit aktiver Entwicklung, besserer Performance und strafferer Sicherheit. Die Recipe-Liste von txAdmin enthält beide Frameworks und die Schritte unten sind für beide identisch; entscheidest du dich für Qbox, wähle in Schritt 3 einfach dieses Recipe aus. Fängst du komplett neu an und hast noch keine QBCore-spezifischen Scripts gekauft, ist Qbox eine Überlegung wert.

Schritt 1: Lege im Panel eine Datenbank an

1. Logge dich im MC-Node-Panel ein und öffne deinen FiveM-Server.
2. Gehe zum Tab Databases und klicke auf New Database. Siehst du keinen Button oder hast du dein Limit erreicht, lies Wie erstelle und verwalte ich eine Datenbank?
3. Gib der Datenbank einen wiedererkennbaren Namen, zum Beispiel qbcore, und bestätige.
4. Öffne die Details der neuen Datenbank und notiere dir vier Angaben: den Endpoint (den Host inklusive der Portnummer dahinter), den Datenbanknamen, den Benutzernamen und das Passwort (sichtbar über das Augen-Icon).

Achtung: Der Host ist eine eigene Datenbankadresse, nicht localhost. Trägst du später doch localhost oder 127.0.0.1 ein, kann dein Server die Datenbank nie erreichen. Mehr Hintergrund findest du in Wie verbinde ich mich mit meiner Datenbank?

Schritt 2: Öffne txAdmin

1. Prüfe, ob txAdmin auf deinem Server aktiviert ist. Falls noch nicht, folge zuerst Wie aktiviere ich txAdmin?
2. Starte deinen Server über den Tab Console.
3. In der Konsolenausgabe erscheint die txAdmin-Adresse zusammen mit einem vierstelligen PIN-Code. Der PIN ist nur wenige Minuten gültig; ist er abgelaufen, starte deinen Server neu, um einen neuen zu bekommen.
4. Öffne die Adresse (http://server-ip:txadmin-port) in deinem Browser, melde dich mit deinem Cfx.re-Account an und gib den PIN ein. Diese Verknüpfung ist nur beim ersten Mal nötig: Dein Account ist danach der Master-Account dieses txAdmins.

Schritt 3: Deploye das QBCore-Recipe über den Setup-Wizard

1. Da noch kein Server eingerichtet ist, öffnet txAdmin automatisch den Setup-Wizard. Gib deinem Server einen Namen.
2. Wähle beim Installationstyp Popular Recipes und dann QBCore Framework (oder Qbox).
3. Trage deinen Cfx.re License Key ein. Den erstellst du kostenlos auf portal.cfx.re; wie das genau funktioniert, liest du in Ich habe einen FiveM-Server gekauft — was nun?
4. Trage in die Datenbankfelder exakt die Angaben aus Schritt 1 ein: Host (mit Portnummer), Benutzername, Passwort und Datenbankname.
5. Starte das Deployment. txAdmin lädt jetzt alle QBCore-Resources herunter, importiert die SQL-Tabellen in deine Datenbank und generiert eine server.cfg. Das dauert in der Regel ein paar Minuten.
6. Prüfe danach die generierte server.cfg (die Standardwerte sind für den Anfang völlig in Ordnung) und klicke auf Save & Run Server.

Schritt 4: Erster Start, Admin werden und ab in die Stadt

1. Verfolge den ersten Start in der txAdmin-Konsole und warte, bis alle Resources geladen sind und keine roten Fehlermeldungen mehr durchlaufen.
2. Öffne den FiveM-Client, drücke F8 und tippe connect ip:port mit der Adresse deines Servers (die findest du im Panel).
3. Du landest im Charaktermenü: Erstelle deinen ersten Charakter und wähle einen Startort oder ein Apartment.
4. Admin werden: Öffne in txAdmin die Seite Live Console und tippe setgroup 1 god, wobei du 1 durch deine Server-ID ersetzt (zu sehen auf der Players-Seite von txAdmin). Mit der Gruppe god öffnest du in der Stadt das Adminmenü, standardmäßig über /admin.

Häufige Probleme

• Connection refused oder Access denied (oxmysql) — die Datenbankdaten stimmen nicht. Das Recipe schreibt sie in die Zeile set mysql_connection_string in der server.cfg; öffne die Datei über den Tab Files und prüfe den Host samt Portnummer, den Benutzernamen (inklusive eventuellem Präfix), das Passwort und den Datenbanknamen. Verwende niemals localhost. Starte danach deinen Server neu.
• Recipe über eine bestehende Installation gelaufen — der Deployer erwartet eine leere Umgebung. Lässt du den Wizard über eine frühere Installation laufen, bekommst du kollidierende Resources und doppelte Datenbanktabellen. Erstelle zuerst ein Backup über den Tab Backups, entferne dann die alten Serverdateien (oder lass deinen Server neu installieren) und verwende eine leere oder neue Datenbank.
• License Key fehlt oder wird schon verwendet — ohne gültigen Key startet FiveM nicht, und ein Key kann immer nur auf einem aktiven Server gleichzeitig laufen. Erstelle im Keymaster einen neuen Key und trage ihn über den Tab Startup ein; die Details stehen in Wie ändere ich meinen FiveM License Key?
• Die txAdmin-Seite lädt nicht — prüfe, ob der txAdmin-Port konfiguriert ist und ob dein Server tatsächlich läuft; die Schritte stehen im txAdmin-Artikel aus Schritt 2.

Brauchst du Hilfe?

Glückwunsch, deine Stadt läuft! Von hier aus kannst du Resources hinzufügen, Jobs konfigurieren und deinen Server weiter ausbauen. Hängst du trotzdem irgendwo fest, zum Beispiel bei einem Deployment, das auf halbem Weg abbricht? Eröffne ein Ticket über unsere Supportseite und nenne deinen Servernamen und die Fehlermeldung aus der txAdmin-Konsole — dann schauen wir gemeinsam drauf.