{"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-09T14:39:21","modified_gmt":"2026-08-09T12:39:21","slug":"qbcore","status":"publish","type":"post","link":"https:\/\/rpcrate.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> Seine <code data-no-translation=\"\" translate=\"no\">qb-core<\/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, anstatt den <code data-no-translation=\"\" translate=\"no\">qb-core<\/code> Ordner als vollst\u00e4ndige Installation zu betrachten.<\/p>\n<h2 id=\"key-takeaways\">Wichtige Erkenntnisse<\/h2>\n<ul>\n<li><code data-no-translation=\"\" translate=\"no\">qb-core<\/code> ist die Kernressource, kein vollst\u00e4ndiger Rollenspielserver f\u00fcr sich.<\/li>\n<li>Der offizielle Windows-Leitfaden richtet \u00fcber txAdmin die beliebte Vorlage \u201eQBCore Framework\u201c 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 id=\"what-qbcore-provides\">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 id=\"install-qbcore-with-the-official-recipe\">Installiere QBCore mit dem offiziellen Rezept<\/h2>\n<p>Der aktuelle offizielle Installationsweg f\u00fcr Windows nutzt die in FXServer enthaltene txAdmin-Oberfl\u00e4che. W\u00e4hle im Recipe Deployer die beliebte Vorlage \u201eQBCore Framework\u201c und folge der aktuellen QBCore-Installationsanleitung. Das Rezept-Repository zeigt, warum eine einzelne ZIP-Datei nicht gen\u00fcgt: Es richtet die Datenbank ein und l\u00e4dt ein Ressourcenpaket herunter rund um <code data-no-translation=\"\" translate=\"no\">qb-core<\/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 Installation mit dem offiziellen QBCore-Rezept aus den beliebten Vorlagen.<\/li>\n<li>Gib den angeforderten Serverschl\u00fcssel und die Datenbankeinstellungen im dokumentierten Konfigurationsablauf an.<\/li>\n<li>Lass das Rezept SQL und Ressourcen bereitstellen. Beschr\u00e4nke dich beim manuellen Kopieren nicht auf <code data-no-translation=\"\" translate=\"no\">qb-core<\/code>.<\/li>\n<li>\u00dcberpr\u00fcfe die generierte <code data-no-translation=\"\" translate=\"no\">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 data-no-translation=\"\" translate=\"no\">qb-core\/config.lua<\/code>; diese Datei wird f\u00fcr die Kern- und Spielerkonfiguration verwendet.<\/p>\n<h2 id=\"add-a-qbcore-resource-safely\">F\u00fcge eine QBCore-Ressource sicher hinzu<\/h2>\n<p>Halte vor der Installation einer Job-, Inventar-, Target-, Telefon- oder UI-Ressource die genaue Version fest von <code data-no-translation=\"\" translate=\"no\">qb-core<\/code> und von jedem weiteren System, mit dem die Ressource zusammenarbeiten wird. Pr\u00fcfe anschlie\u00dfend Folgendes:<\/p>\n<div aria-label=\"Horizontal verschiebbare Tabelle\" class=\"fmx-guide-table\" role=\"region\" tabindex=\"0\">\n<table>\n<thead>\n<tr>\n<th>\u00dcberpr\u00fcfe<\/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-, Target-, Men\u00fc-, Eingabe-, Datenbank- und Hilfsressourcen mit genauen Versionsangaben.<\/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, Spracheinstellungen, Koordinaten, Funktionsschalter und ausschlie\u00dflich serverseitig gespeicherte geheime Daten.<\/td>\n<\/tr>\n<tr>\n<td>Reihenfolge<\/td>\n<td>Abh\u00e4ngigkeiten starten 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<\/div>\n<p>Die Produktkennzeichnung QBCore ist lediglich ein erster Kompatibilit\u00e4tshinweis. Ersetzt dein Server das Inventar-, Target- oder Men\u00fcsystem des Rezepts, kann ein Skript einen dokumentierten Adapter oder eine Konfigurations\u00e4nderung ben\u00f6tigen. Wende Datenbank\u00e4nderungen zuerst auf eine Testkopie an und halte einen Rollback f\u00fcr Dateien und Daten bereit.<\/p>\n<h2 id=\"who-qbcore-fits\">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 id=\"qbcore-qbox-or-esx\">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>Nutze den Framework-Vergleich f\u00fcr eine neutrale Entscheidungsmethode. Bei der Auswahl aus dem <a href=\"https:\/\/rpcrate.com\/de\/shop\/\">Katalog f\u00fcr kostenpflichtige FiveM-Skripte<\/a>, beginne mit <a href=\"https:\/\/rpcrate.com\/de\/qbcore-skripte\/\">QBCore-Skripte<\/a>, best\u00e4tige die Anforderungen auf der konkreten Produktseite und teste die Ressource vor dem Produktiveinsatz auf Staging mit einer repr\u00e4sentativen Datenbank.<\/p>\n<h2 id=\"use-the-official-qbcore-recipe-as-the-installation-boundary\">Verwende das offizielle QBCore-Rezept als Installationsgrenze<\/h2>\n<p>Beginne mit dem aktuell gepflegten <a href=\"https:\/\/github.com\/qbcore-fivem\/txAdminRecipe\" rel=\"nofollow noopener\">QBCore txAdmin-Rezept<\/a> und der offiziellen <a href=\"https:\/\/qbcore.org\/docs\/guides\/windows-installation\" rel=\"nofollow noopener\">Installationsanleitung<\/a>. Ein Rezept stellt eine Ausgangsbasis bereit; es beweist nicht, dass ein \u00e4lteres Drittanbieterskript die installierten Framework-, Datenbank-, Inventar- oder Target-Versionen unterst\u00fctzt. Notiere den Rezept-Commit und pr\u00fcfe jede erg\u00e4nzte Ressource vor dem Produktiveinsatz auf Staging.<\/p>","protected":false},"excerpt":{"rendered":"<p>QBCore ist ein Open-Source-Rollenspiel-Framework f\u00fcr FiveM. Seine qb-core-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, anstatt den qb-core-Ordner als vollst\u00e4ndige Installation zu behandeln.<\/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:\/\/rpcrate.com\/de\/wp-json\/wp\/v2\/posts\/147431","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/rpcrate.com\/de\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/rpcrate.com\/de\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/rpcrate.com\/de\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/rpcrate.com\/de\/wp-json\/wp\/v2\/comments?post=147431"}],"version-history":[{"count":7,"href":"https:\/\/rpcrate.com\/de\/wp-json\/wp\/v2\/posts\/147431\/revisions"}],"predecessor-version":[{"id":215650,"href":"https:\/\/rpcrate.com\/de\/wp-json\/wp\/v2\/posts\/147431\/revisions\/215650"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/rpcrate.com\/de\/wp-json\/wp\/v2\/media\/152045"}],"wp:attachment":[{"href":"https:\/\/rpcrate.com\/de\/wp-json\/wp\/v2\/media?parent=147431"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/rpcrate.com\/de\/wp-json\/wp\/v2\/categories?post=147431"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/rpcrate.com\/de\/wp-json\/wp\/v2\/tags?post=147431"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}