QBCore Framework-Leitfaden: Architektur, Installation und Kompatibilität

QBCore ist ein Open-Source-Rollenspiel-Framework für FiveM. Sein qb-kern Ressource stellt gemeinsame Spielerdaten, Framework-Funktionen, Befehle und Definitionen bereit, die andere QB-Ressourcen verwenden können. Für einen neuen Server verwende das offizielle QBCore txAdmin-Rezept anstelle der Behandlung des qb-kern Ordner als vollständige Installation.

Wichtige Erkenntnisse

• qb-kern ist die Kernressource, kein vollständiger Rollenspielserver für sich.
• Der offizielle Windows-Leitfaden setzt das QBCore Framework-Vorlagentemplate über txAdmin ein.
• Das offizielle Rezept umfasst die Datenbankkonfiguration und einen größeren Satz QB-Ressourcen.
• Die Kompatibilität hängt von den genauen Versionen, Abhängigkeiten, Exports, SQL und der Ressourcenreihenfolge ab.
• Keine offizielle Quelle etabliert QBCore als universellen Leistungssieger; profiliere den kompletten Stack, den du laufen lassen planst.

Was QBCore bietet

Das QBCore Core Object ist die gemeinsame Schnittstelle, die von vielen QB-Ressourcen verwendet wird. Die offizielle Dokumentation gruppiert seine Fähigkeiten um Funktionen, Spieler-Daten, gemeinsame Daten, Konfiguration und Befehle. Eine Ressource kann nur die Teile des Core Objects anfordern, die sie benötigt, aber ihre erforderliche API-Oberfläche muss dennoch mit der Core-Version auf dem Server übereinstimmen.

Gemeinsame Definitionen umfassen Jobs, Gangs, Gegenstände und Fahrzeuge, die in Lua-Tabellen dargestellt werden. Kernfunktionen decken gemeinsame Rahmenwerkoperationen ab, während Spielerobjekte strukturierte Charakterdaten und spielerbezogene Funktionen freilegen. Befehle und Berechtigungen sind Teil des weiteren Rahmenwerkmodells. Dies sind architektonische Fähigkeiten, kein Beweis dafür, dass jeder Server oder jede Ressource die gleiche Leistung oder das gleiche Verhalten aufweist.

Installiere QBCore mit dem offiziellen Rezept

Der aktuelle offizielle Windows-Pfad verwendet die mitgelieferte txAdmin-Schnittstelle von FXServer. Im Rezept-Deployer wählst du das QBCore Framework-Vorlagentemplate aus und folgst der aktuellen QBCore-Installationsanleitung. Das Rezept-Repository zeigt, warum die Installation nur eines ZIPs unvollständig ist: Es richtet die Datenbank ein und lädt eine Sammlung von Ressourcen herunter qb-kern.

1. Bereite eine unterstützte FiveM-Serverumgebung und ein aktuelles FXServer-Artifact vor.
2. Starte txAdmin und erstelle eine neue Bereitstellung mit dem offiziellen QBCore-Beliebte-Rezept.
3. Gib den angeforderten Servernamen und die Datenbankeinstellungen im dokumentierten Konfigurationsablauf an.
4. Lass das Rezept seine SQL- und Ressourcen statt manuellen Kopieren nur qb-kern.
5. Überprüfe die generierten server.cfg, Ressourcenreihenfolge und Geheimnisse, bevor du den Server freigibst.
6. Starte den Server und überprüfe die Datenbankverbindung, Charaktererstellung, Berechtigungen und Protokolle.

Die Datenbankverbindung gehört in die Serverkonfiguration, die von oxmysql verwendet wird. Suche nicht nach einem generischen Datenbankverbindungsfeld in qb-core/config.lua; diese Datei wird für die Kern- und Spielerkonfiguration verwendet.

Füge eine QBCore-Ressource sicher hinzu

Bevor du einen Job, ein Inventar, ein Ziel, ein Telefon oder eine Benutzeroberflächenressource installierst, zeichne die genaue Version auf qb-kern und jedes damit verbundene System, mit dem es integriert wird. Dann arbeite dich durch diese Grenze:

Ein Produktlabel, das QBCore sagt, ist nur das erste Kompatibilitätssignal. Wenn der Server die Inventar-, Ziel- oder Menüebene des Rezepts ersetzt, kann ein Skript einen dokumentierten Adapter oder eine Konfigurationsänderung erfordern. Wende Datenbankänderungen zuerst auf eine Testkopie an und behalte ein Rollback, das sowohl Dateien als auch Daten abdeckt.

Für wen QBCore geeignet ist

QBCore ist ein vernünftiger Kandidat für einen neuen Server, dessen benötigte Ressourcen explizit das aktuelle QB-Ökosystem unterstützen, oder für einen bestehenden QB-Server, der bereits sein Core-Object und Datenmodell verwendet. Die Wahl wird teurer, wenn ein Team einen großen ESX-Datensatz, framework-spezifische Skripte oder undokumentierte benutzerdefinierte Ereignisse hat. In diesem Fall solltest du die Migrationsfläche vor der Auswahl eines neuen Frameworks inventarisieren.

Qbox begann mit der QBCore-Codebasis und bietet eine Kompatibilitätsbrücke für viele korrekt geschriebene QB-Ressourcen, aber die offizielle Qbox-Dokumentation listet Ausnahmen auf. Gehe nicht davon aus, dass jedes QBCore-Skript ein Qbox-Skript ist, das einfach übernommen werden kann. Ebenso solltest du nicht von ESX zu QBCore migrieren, basierend auf einer breiten Leistungsbehauptung. Vergleiche die Ressourcenabdeckung, das Teamwissen, die Datenkonvertierung und den Testplan.

QBCore, Qbox oder ESX

• Bleibe bei QBCore wenn deine aktuellen Ressourcen und dein Team bereits auf dokumentierte QBCore-APIs angewiesen sind und der Upgrade-Pfad verstanden wird.
• Überlege dir Qbox wenn du absichtlich seine aktuellen APIs und Rezepte möchtest und du die Bridge-Ausnahmen ressourcenweise prüfen kannst.
• Bleibe bei ESX wenn deine Produktionsdaten, Integrationen und betrieblichen Kenntnisse ESX-spezifisch sind und es keinen getesteten Grund gibt, zu migrieren.

Nutzen Sie den Framework-Vergleich für eine neutrale Entscheidungsmethode. Bei der Auswahl aus dem bezahlte FiveM-Skript-Katalog, beginnen Sie mit QBCore-Skripte, bestätigen Sie die Anforderungen auf der exakten Produktseite und stufen Sie die Ressource vor der Produktion gegen eine repräsentative Datenbank ein.

Sichere nächste Schritte

1. Lies die aktuelle QBCore-Windows-Installationsanleitung und das offizielle Rezept, bevor du den Server erstellst.
2. Nimm die bereitgestellten Kern- und Abhängigkeitsversionen nach Abschluss des Rezepts auf.
3. Wähle eine Ressource nach der anderen aus, lies ihre offiziellen Installationshinweise und teste ihre Berechtigungen und Fehlerpfade.
4. Halte Datenbank- und Ressourcen-Sicherungen zusammen, damit ein Rollback einen konsistenten Zustand wiederherstellt.