{"id":147431,"date":"2024-07-11T20:13:19","date_gmt":"2024-07-11T18:13:19","guid":{"rendered":"https:\/\/hifivem.com\/?p=147431"},"modified":"2026-08-05T21:21:46","modified_gmt":"2026-08-05T19:21:46","slug":"qbcore","status":"publish","type":"post","link":"https:\/\/fivemx.com\/de\/qbcore\/","title":{"rendered":"QBCore Framework-Leitfaden: Architektur, Installation und Kompatibilit\u00e4t"},"content":{"rendered":"<p><strong>QBCore ist ein Open-Source-Rollenspiel-Framework f\u00fcr FiveM.<\/strong> Sein <code>qb-kern<\/code> Ressource stellt gemeinsame Spielerdaten, Framework-Funktionen, Befehle und Definitionen bereit, die andere QB-Ressourcen verwenden k\u00f6nnen. F\u00fcr einen neuen Server verwende das offizielle QBCore txAdmin-Rezept anstelle der Behandlung des <code>qb-kern<\/code> Ordner als vollst\u00e4ndige Installation.<\/p>\n<h2>Wichtige Erkenntnisse<\/h2>\n<ul>\n<li><code>qb-kern<\/code> ist die Kernressource, kein vollst\u00e4ndiger Rollenspielserver f\u00fcr sich.<\/li>\n<li>Der offizielle Windows-Leitfaden setzt das QBCore Framework-Vorlagentemplate \u00fcber txAdmin ein.<\/li>\n<li>Das offizielle Rezept umfasst die Datenbankkonfiguration und einen gr\u00f6\u00dferen Satz QB-Ressourcen.<\/li>\n<li>Die Kompatibilit\u00e4t h\u00e4ngt von den genauen Versionen, Abh\u00e4ngigkeiten, Exports, SQL und der Ressourcenreihenfolge ab.<\/li>\n<li>Keine offizielle Quelle etabliert QBCore als universellen Leistungssieger; profiliere den kompletten Stack, den du laufen lassen planst.<\/li>\n<\/ul>\n<h2>Was QBCore bietet<\/h2>\n<p>Das QBCore Core Object ist die gemeinsame Schnittstelle, die von vielen QB-Ressourcen verwendet wird. Die offizielle Dokumentation gruppiert seine F\u00e4higkeiten um Funktionen, Spieler-Daten, gemeinsame Daten, Konfiguration und Befehle. Eine Ressource kann nur die Teile des Core Objects anfordern, die sie ben\u00f6tigt, aber ihre erforderliche API-Oberfl\u00e4che muss dennoch mit der Core-Version auf dem Server \u00fcbereinstimmen.<\/p>\n<p>Gemeinsame Definitionen umfassen Jobs, Gangs, Gegenst\u00e4nde und Fahrzeuge, die in Lua-Tabellen dargestellt werden. Kernfunktionen decken gemeinsame Rahmenwerkoperationen ab, w\u00e4hrend Spielerobjekte strukturierte Charakterdaten und spielerbezogene Funktionen freilegen. Befehle und Berechtigungen sind Teil des weiteren Rahmenwerkmodells. Dies sind architektonische F\u00e4higkeiten, kein Beweis daf\u00fcr, dass jeder Server oder jede Ressource die gleiche Leistung oder das gleiche Verhalten aufweist.<\/p>\n<h2>Installiere QBCore mit dem offiziellen Rezept<\/h2>\n<p>Der aktuelle offizielle Windows-Pfad verwendet die mitgelieferte txAdmin-Schnittstelle von FXServer. Im Rezept-Deployer w\u00e4hlst du das QBCore Framework-Vorlagentemplate aus und folgst der aktuellen QBCore-Installationsanleitung. Das Rezept-Repository zeigt, warum die Installation nur eines ZIPs unvollst\u00e4ndig ist: Es richtet die Datenbank ein und l\u00e4dt eine Sammlung von Ressourcen herunter <code>qb-kern<\/code>.<\/p>\n<ol>\n<li>Bereite eine unterst\u00fctzte FiveM-Serverumgebung und ein aktuelles FXServer-Artifact vor.<\/li>\n<li>Starte txAdmin und erstelle eine neue Bereitstellung mit dem offiziellen QBCore-Beliebte-Rezept.<\/li>\n<li>Gib den angeforderten Servernamen und die Datenbankeinstellungen im dokumentierten Konfigurationsablauf an.<\/li>\n<li>Lass das Rezept seine SQL- und Ressourcen statt manuellen Kopieren nur <code>qb-kern<\/code>.<\/li>\n<li>\u00dcberpr\u00fcfe die generierten <code>server.cfg<\/code>, Ressourcenreihenfolge und Geheimnisse, bevor du den Server freigibst.<\/li>\n<li>Starte den Server und \u00fcberpr\u00fcfe die Datenbankverbindung, Charaktererstellung, Berechtigungen und Protokolle.<\/li>\n<\/ol>\n<p>Die Datenbankverbindung geh\u00f6rt in die Serverkonfiguration, die von oxmysql verwendet wird. Suche nicht nach einem generischen Datenbankverbindungsfeld in <code>qb-core\/config.lua<\/code>; diese Datei wird f\u00fcr die Kern- und Spielerkonfiguration verwendet.<\/p>\n<h2>F\u00fcge eine QBCore-Ressource sicher hinzu<\/h2>\n<p>Bevor du einen Job, ein Inventar, ein Ziel, ein Telefon oder eine Benutzeroberfl\u00e4chenressource installierst, zeichne die genaue Version auf <code>qb-kern<\/code> und jedes damit verbundene System, mit dem es integriert wird. Dann arbeite dich durch diese Grenze:<\/p>\n<table>\n<thead>\n<tr>\n<th>\u00dcberpr\u00fcfen<\/th>\n<th>Was zu \u00fcberpr\u00fcfen ist<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Framework-API<\/td>\n<td>Ben\u00f6tigte Core-Object-Funktionen, Exporte, Ereignisse und Spieler-Datenfelder.<\/td>\n<\/tr>\n<tr>\n<td>Abh\u00e4ngigkeiten<\/td>\n<td>Inventar-, Ziel-, Men\u00fc-, Eingabe-, Datenbank- und Utility-Ressourcen mit genauen Versionen.<\/td>\n<\/tr>\n<tr>\n<td>Daten<\/td>\n<td>SQL-Migrationen, Tabellenannahmen, Artikel- oder Job-Definitionen und sicheres Rollback.<\/td>\n<\/tr>\n<tr>\n<td>Konfiguration<\/td>\n<td>Berechtigungen, Orte, Koordinaten, Feature-Flags und serverseitige Geheimnisse.<\/td>\n<\/tr>\n<tr>\n<td>Bestellung<\/td>\n<td>Abh\u00e4ngigkeiten beginnen vor der Ressource und kein doppelter Ersatz ist aktiv.<\/td>\n<\/tr>\n<tr>\n<td>Validierung<\/td>\n<td>Erlaubte und verweigerte Rollen, Neuanmeldungen, Neustarts, Client-Protokolle und Server-Protokolle.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Ein Produktlabel, das QBCore sagt, ist nur das erste Kompatibilit\u00e4tssignal. Wenn der Server die Inventar-, Ziel- oder Men\u00fcebene des Rezepts ersetzt, kann ein Skript einen dokumentierten Adapter oder eine Konfigurations\u00e4nderung erfordern. Wende Datenbank\u00e4nderungen zuerst auf eine Testkopie an und behalte ein Rollback, das sowohl Dateien als auch Daten abdeckt.<\/p>\n<h2>F\u00fcr wen QBCore geeignet ist<\/h2>\n<p>QBCore ist ein vern\u00fcnftiger Kandidat f\u00fcr einen neuen Server, dessen ben\u00f6tigte Ressourcen explizit das aktuelle QB-\u00d6kosystem unterst\u00fctzen, oder f\u00fcr einen bestehenden QB-Server, der bereits sein Core-Object und Datenmodell verwendet. Die Wahl wird teurer, wenn ein Team einen gro\u00dfen ESX-Datensatz, framework-spezifische Skripte oder undokumentierte benutzerdefinierte Ereignisse hat. In diesem Fall solltest du die Migrationsfl\u00e4che vor der Auswahl eines neuen Frameworks inventarisieren.<\/p>\n<p>Qbox begann mit der QBCore-Codebasis und bietet eine Kompatibilit\u00e4tsbr\u00fccke f\u00fcr 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 \u00fcbernommen 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.<\/p>\n<h2>QBCore, Qbox oder ESX<\/h2>\n<ul>\n<li><strong>Bleibe bei QBCore<\/strong> wenn deine aktuellen Ressourcen und dein Team bereits auf dokumentierte QBCore-APIs angewiesen sind und der Upgrade-Pfad verstanden wird.<\/li>\n<li><strong>\u00dcberlege dir Qbox<\/strong> wenn du absichtlich seine aktuellen APIs und Rezepte m\u00f6chtest und du die Bridge-Ausnahmen ressourcenweise pr\u00fcfen kannst.<\/li>\n<li><strong>Bleibe bei ESX<\/strong> wenn deine Produktionsdaten, Integrationen und betrieblichen Kenntnisse ESX-spezifisch sind und es keinen getesteten Grund gibt, zu migrieren.<\/li>\n<\/ul>\n<p>Nutzen Sie den Framework-Vergleich f\u00fcr eine neutrale Entscheidungsmethode. Bei der Auswahl aus dem <a href=\"\/de\/fivem-skripte\/\">bezahlte FiveM-Skript-Katalog<\/a>, beginnen Sie mit <a href=\"\/de\/qbcore-skripte\/\">QBCore-Skripte<\/a>, best\u00e4tigen Sie die Anforderungen auf der exakten Produktseite und stufen Sie die Ressource vor der Produktion gegen eine repr\u00e4sentative Datenbank ein.<\/p>\n<h2>Sichere n\u00e4chste Schritte<\/h2>\n<ol>\n<li>Lies die aktuelle QBCore-Windows-Installationsanleitung und das offizielle Rezept, bevor du den Server erstellst.<\/li>\n<li>Nimm die bereitgestellten Kern- und Abh\u00e4ngigkeitsversionen nach Abschluss des Rezepts auf.<\/li>\n<li>W\u00e4hle eine Ressource nach der anderen aus, lies ihre offiziellen Installationshinweise und teste ihre Berechtigungen und Fehlerpfade.<\/li>\n<li>Halte Datenbank- und Ressourcen-Sicherungen zusammen, damit ein Rollback einen konsistenten Zustand wiederherstellt.<\/li>\n<\/ol>\n<p><!-- fivemx-blog-content-links:2026-07-23:qbcore --><\/p>\n<section class=\"fivemx-content-links\" aria-labelledby=\"fivemx-qbcore-compare\">\n<h2 id=\"fivemx-qbcore-compare\">Vergleiche QBCore vor dem Commit<\/h2>\n<p>Verwende den <a href=\"https:\/\/fivemx.com\/de\/fivem-rahmenwerke\/\">ESX-, QBCore- und Qbox-Vergleich<\/a> f\u00fcr die breitere Entscheidung, dann \u00fcberpr\u00fcfe die <a href=\"https:\/\/fivemx.com\/de\/qbox-ox-stapel\/\">Qbox-Migrations- und Kompatibilit\u00e4tsgrenze<\/a> wenn ein Ox-orientierter Stack in Betracht gezogen wird.<\/p>\n<\/section>","protected":false},"excerpt":{"rendered":"<p>Verstehe, was QBCore bietet, installiere den gesamten Stack \u00fcber das offizielle txAdmin-Rezept und \u00fcberpr\u00fcfe die Ressourcen gegen deine genaue Serverversion.<\/p>","protected":false},"author":1,"featured_media":152045,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2347],"tags":[2950,2859],"class_list":["post-147431","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-frameworks","tag-framework","tag-qbcore"],"_links":{"self":[{"href":"https:\/\/fivemx.com\/de\/wp-json\/wp\/v2\/posts\/147431","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/fivemx.com\/de\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/fivemx.com\/de\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/fivemx.com\/de\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/fivemx.com\/de\/wp-json\/wp\/v2\/comments?post=147431"}],"version-history":[{"count":7,"href":"https:\/\/fivemx.com\/de\/wp-json\/wp\/v2\/posts\/147431\/revisions"}],"predecessor-version":[{"id":215650,"href":"https:\/\/fivemx.com\/de\/wp-json\/wp\/v2\/posts\/147431\/revisions\/215650"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/fivemx.com\/de\/wp-json\/wp\/v2\/media\/152045"}],"wp:attachment":[{"href":"https:\/\/fivemx.com\/de\/wp-json\/wp\/v2\/media?parent=147431"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/fivemx.com\/de\/wp-json\/wp\/v2\/categories?post=147431"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/fivemx.com\/de\/wp-json\/wp\/v2\/tags?post=147431"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}