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

QBCore ist ein Open-Source-Rollenspiel-Framework für FiveM. Seine qb-core 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, anstatt den qb-core Ordner als vollständige Installation zu betrachten.

Wichtige Erkenntnisse

• qb-core ist die Kernressource, kein vollständiger Rollenspielserver für sich.
• Der offizielle Windows-Leitfaden richtet über txAdmin die beliebte Vorlage „QBCore Framework“ 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 Installationsweg für Windows nutzt die in FXServer enthaltene txAdmin-Oberfläche. Wähle im Recipe Deployer die beliebte Vorlage „QBCore Framework“ und folge der aktuellen QBCore-Installationsanleitung. Das Rezept-Repository zeigt, warum eine einzelne ZIP-Datei nicht genügt: Es richtet die Datenbank ein und lädt ein Ressourcenpaket herunter rund um qb-core.

1. Bereite eine unterstützte FiveM-Serverumgebung und ein aktuelles FXServer-Artifact vor.
2. Starte txAdmin und erstelle eine neue Installation mit dem offiziellen QBCore-Rezept aus den beliebten Vorlagen.
3. Gib den angeforderten Serverschlüssel und die Datenbankeinstellungen im dokumentierten Konfigurationsablauf an.
4. Lass das Rezept SQL und Ressourcen bereitstellen. Beschränke dich beim manuellen Kopieren nicht auf qb-core.
5. Überprüfe die generierte 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

Halte vor der Installation einer Job-, Inventar-, Target-, Telefon- oder UI-Ressource die genaue Version fest von qb-core und von jedem weiteren System, mit dem die Ressource zusammenarbeiten wird. Prüfe anschließend Folgendes:

Die Produktkennzeichnung QBCore ist lediglich ein erster Kompatibilitätshinweis. Ersetzt dein Server das Inventar-, Target- oder Menüsystem des Rezepts, kann ein Skript einen dokumentierten Adapter oder eine Konfigurationsänderung benötigen. Wende Datenbankänderungen zuerst auf eine Testkopie an und halte einen Rollback für Dateien und Daten bereit.

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.

Nutze den Framework-Vergleich für eine neutrale Entscheidungsmethode. Bei der Auswahl aus dem Katalog für kostenpflichtige FiveM-Skripte, beginne mit QBCore-Skripte, bestätige die Anforderungen auf der konkreten Produktseite und teste die Ressource vor dem Produktiveinsatz auf Staging mit einer repräsentativen Datenbank.

Verwende das offizielle QBCore-Rezept als Installationsgrenze

Beginne mit dem aktuell gepflegten QBCore txAdmin-Rezept und der offiziellen Installationsanleitung. Ein Rezept stellt eine Ausgangsbasis bereit; es beweist nicht, dass ein älteres Drittanbieterskript die installierten Framework-, Datenbank-, Inventar- oder Target-Versionen unterstützt. Notiere den Rezept-Commit und prüfe jede ergänzte Ressource vor dem Produktiveinsatz auf Staging.