Wie man einen QBCore-Server installiert: txAdmin-Rezept und manuelle Schritte

Du möchtest einen QBCore-Server und wählst zwischen dem Rezept und einer manuellen Installation. Diese Anleitung behandelt beide, die server.cfg, die du brauchst, was beim ersten Start zu überprüfen ist und die Fehler, die auf fast jedem ersten QBCore-Server auftauchen.

#Option 1: das txAdmin-Rezept

Das Rezept ist die empfohlene Weise. Wähle im Setup von txAdmin das QBCore-Template aus den beliebten Rezepten, wie in txAdmin Setup und Rezepte beschrieben. Du gibst deinen Lizenzschlüssel und deine Datenbankdetails ein, txAdmin lädt alles herunter, erstellt die Datenbank und schreibt server.cfg. Überprüfe diese Datei, starte den Server und gehe zu den ersten Überprüfungen unten.

#Option 2: manuelle Installation

Verwende dies, wenn du bereits einen Server hast und QBCore hinzufügen möchtest. Du brauchst FXServer, eine MySQL- oder MariaDB-Datenbank und einen Lizenzschlüssel.

#1. Hole dir die Ressourcen

QBCore ist nicht eine einzelne Ressource. Du brauchst:

• qb-core, das Framework selbst.
• Die qb-Ressourcen um es: Inventar, Multicharakter, Spawn-Selector, Jobs, Telefon usw. Sie sind normalerweise in einem Ordner wie [qb] gruppiert.
• oxmysql für die Datenbank und ox_lib, das viele aktuelle Ressourcen benötigen.
• Standalone-Ressourcen wie eine Stimmressource (siehe pma-voice not working) und alle Karten- oder Fahrzeugpacks.

Kopiere sie in deinen resources-Ordner, z.B. resources/[qb] und resources/[standalone].

#2. Erstelle die Datenbank und importiere die SQL

CREATE DATABASE qbcore CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

Importiere die SQL-Datei, die mit der QBCore-Installation kommt (das Rezept-Repository versendet eine mit den Base-Tabellen) und dann die SQL jeder Ressource, die ihre eigene Datei hat. Wenn ein Skript später sagt, dass eine Tabelle fehlt, siehe SQL table doesn't exist.

#3. Bearbeite server.cfg

set mysql_connection_string "mysql://user:password@localhost/qbcore?charset=utf8mb4"

ensure oxmysql
ensure ox_lib
ensure qb-core
ensure [qb]
ensure [standalone]

add_ace group.admin command allow
add_ace qbcore.god command allow
add_principal group.admin qbcore.god
add_principal identifier.license:YOUR_LICENSE_HERE qbcore.god

Ersetze YOUR_LICENSE_HERE durch deinen eigenen FiveM License-Identifier. Du findest es in der Spielerliste von txAdmin oder in der Serverkonsole, wenn du beitrittst. Die ACE-Zeilen werden in ACE Permissions behandelt.

Tipp: ensure [qb] startet jede Ressource in diesem Ordner. Halte qb-core selbst außerhalb davon, wie im Beispiel, oder es wird doppelt verfügt. Siehe server.cfg ensure order.

#Erste Überprüfungen

Starte den Server und lese die Konsole, bevor du beitrittst:

1. oxmysql verbindet sich mit der Datenbank ohne einen Fehler.
2. qb-core startet. Wenn es das nicht tut, schlägt jede andere qb-Ressource danach fehl.
3. Keine roten Fehler von den Ressourcen in [qb]. Ein paar Warnungen sind normal; wiederholte Fehler nicht.
4. Du kannst beitreten, die Charakterauswahl erhalten, einen Charakter erstellen und spawnen.
5. Eine Reihe wird erstellt in der players-Tabelle für deinen Charakter.

Wenn du nicht beitreten kannst oder auf der Lade-Bildschirm hängen bleibst, lese players stuck on the loading screen.

#Häufige erste Fehler

QBCore ist nil. Ein Skript, das eine alte Methode verwendet, um das Core-Objekt zu erhalten, schlägt mit fehl:

attempt to index a nil value (global 'QBCore')

Verwende local QBCore = exports['qb-core']:GetCoreObject() am Anfang jeder Datei. Die vollständige Erklärung ist in QBCore nil: the GetCoreObject fix.

qb-core ist nicht gestartet. Andere Ressourcen melden dann:

No such export GetCoreObject in resource qb-core

Schaue am Anfang der Konsole nach dem ersten Fehler von qb-core selbst, was normalerweise die Datenbank ist. Siehe oxmysql connection error.

Ressource startet nicht. Fehlende Abhängigkeit oder Ordnernamen-Probleme: could not find dependency, couldn't start resource.

Du bist nicht Admin. Dein Identifier in server.cfg stimmt nicht mit dem deinen überein, oder du hast nicht neu gestartet, nachdem du ihn bearbeitet hast.

#Nächste Schritte

Wenn die Basis stabil ist, sind die üblichen ersten Aufgaben das Hinzufügen von Jobs und Gegenständen. Siehe QBCore add job und qb-inventory add items. Wenn du den neueren Stack später ausführen möchtest, lese zuerst install QBox, weil sich der Stack unterscheidet.

#Checkliste