{"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":"qb-core","status":"publish","type":"post","link":"https:\/\/fivemx.com\/fr\/qb-core\/","title":{"rendered":"Guide du cadre QBCore : Architecture, Installation et Compatibilit\u00e9"},"content":{"rendered":"<p><strong>QBCore est un cadre de jeu de r\u00f4le open-source pour FiveM.<\/strong> Son <code>QB-Noyau<\/code> ressource expose les donn\u00e9es partag\u00e9es des joueurs, les fonctions du cadre, les commandes et les d\u00e9finitions que d'autres ressources QB peuvent utiliser. Pour un nouveau serveur, utilisez la recette officielle QBCore txAdmin plut\u00f4t que de traiter le <code>QB-Noyau<\/code> dossier comme une installation compl\u00e8te.<\/p>\n<h2>Points cl\u00e9s<\/h2>\n<ul>\n<li><code>QB-Noyau<\/code> est la ressource principale, mais pas un serveur de jeu de r\u00f4le complet en soi.<\/li>\n<li>Le guide officiel Windows d\u00e9ploie le mod\u00e8le populaire du cadre QBCore via txAdmin.<\/li>\n<li>La recette officielle inclut la configuration de la base de donn\u00e9es et un ensemble plus large de ressources QB.<\/li>\n<li>La compatibilit\u00e9 d\u00e9pend des versions exactes, des d\u00e9pendances, des exports, de SQL et de l'ordre des ressources.<\/li>\n<li>Aucune source officielle n'\u00e9tablit QBCore comme un gagnant universel en termes de performance ; profilez la pile compl\u00e8te que vous pr\u00e9voyez d'ex\u00e9cuter.<\/li>\n<\/ul>\n<h2>Ce que QBCore fournit<\/h2>\n<p>L'Objet Principal QBCore est l'interface partag\u00e9e utilis\u00e9e par de nombreuses ressources QB. La documentation officielle regroupe ses capacit\u00e9s autour des fonctions, des donn\u00e9es des joueurs, des donn\u00e9es partag\u00e9es, de la configuration et des commandes. Une ressource peut demander uniquement les parties de l'Objet Principal dont elle a besoin, mais sa surface API requise doit toujours correspondre \u00e0 la version principale sur le serveur.<\/p>\n<p>Les d\u00e9finitions partag\u00e9es incluent les emplois, les gangs, les objets et les v\u00e9hicules repr\u00e9sent\u00e9s dans des tables Lua. Les fonctions principales couvrent les op\u00e9rations courantes du cadre, tandis que les objets des joueurs exposent les donn\u00e9es structur\u00e9es des personnages et les fonctions li\u00e9es aux joueurs. Les commandes et les autorisations font partie du mod\u00e8le de cadre plus large. Ce sont des capacit\u00e9s architecturales, pas une preuve que chaque serveur ou ressource aura les m\u00eames performances ou comportements.<\/p>\n<h2>Installez QBCore avec la recette officielle<\/h2>\n<p>Le chemin officiel actuel pour Windows utilise l'interface txAdmin bundled de FXServer. Dans le d\u00e9ployeur de recettes, s\u00e9lectionnez le mod\u00e8le populaire du cadre QBCore et suivez le guide d'installation actuel de QBCore. Le d\u00e9p\u00f4t de recettes montre pourquoi l'installation d'un seul ZIP est incompl\u00e8te : il provisionne la base de donn\u00e9es et t\u00e9l\u00e9charge une collection de ressources autour de <code>QB-Noyau<\/code>.<\/p>\n<ol>\n<li>Pr\u00e9parez un environnement de serveur FiveM pris en charge et un artefact FXServer actuel.<\/li>\n<li>D\u00e9marrez txAdmin et cr\u00e9ez une nouvelle d\u00e9ploiement en utilisant la recette populaire officielle QBCore.<\/li>\n<li>Fournissez la cl\u00e9 de serveur demand\u00e9e et les param\u00e8tres de base de donn\u00e9es dans le flux de configuration document\u00e9.<\/li>\n<li>Laissez la recette d\u00e9ployer ses SQL et ressources au lieu de copier manuellement uniquement <code>QB-Noyau<\/code>.<\/li>\n<li>Examinez les <code>serveur.cfg<\/code>, l'ordre des ressources et les secrets avant d'exposer le serveur.<\/li>\n<li>D\u00e9marrez le serveur et v\u00e9rifiez la connectivit\u00e9 de la base de donn\u00e9es, la cr\u00e9ation de personnages, les autorisations et les journaux.<\/li>\n<\/ol>\n<p>La connexion \u00e0 la base de donn\u00e9es appartient \u00e0 la configuration du serveur utilis\u00e9e par oxmysql. Ne cherchez pas un champ de connexion \u00e0 la base de donn\u00e9es g\u00e9n\u00e9rique dans <code>qb-core\/config.lua<\/code>; ce fichier est utilis\u00e9 pour la configuration principale et des joueurs.<\/p>\n<h2>Ajouter une ressource QBCore en toute s\u00e9curit\u00e9<\/h2>\n<p>Avant d'installer une ressource de job, d'inventaire, de cible, de t\u00e9l\u00e9phone ou d'interface utilisateur, enregistrer la version exacte de <code>QB-Noyau<\/code> et chaque syst\u00e8me connexe qu'il int\u00e9grera. Ensuite, travaillez \u00e0 travers cette limite :<\/p>\n<table>\n<thead>\n<tr>\n<th>V\u00e9rifier<\/th>\n<th>Ce qu'il faut v\u00e9rifier<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>API du framework<\/td>\n<td>Fonctions, exports, \u00e9v\u00e9nements et champs de donn\u00e9es de joueur requis pour le Core Object.<\/td>\n<\/tr>\n<tr>\n<td>D\u00e9pendances<\/td>\n<td>Ressources d'inventaire, de cible, de menu, d'entr\u00e9e, de base de donn\u00e9es et d'utilitaires avec des versions exactes.<\/td>\n<\/tr>\n<tr>\n<td>Donn\u00e9es<\/td>\n<td>Migrations SQL, hypoth\u00e8ses de table, d\u00e9finitions d'objets ou de jobs et retour en arri\u00e8re s\u00e9curis\u00e9.<\/td>\n<\/tr>\n<tr>\n<td>Configuration<\/td>\n<td>Permissions, locales, coordonn\u00e9es, indicateurs de fonctionnalit\u00e9s et secrets r\u00e9serv\u00e9s au serveur.<\/td>\n<\/tr>\n<tr>\n<td>Commande<\/td>\n<td>Les d\u00e9pendances d\u00e9marrent avant la ressource et aucune duplication de remplacement n'est active.<\/td>\n<\/tr>\n<tr>\n<td>Validation<\/td>\n<td>R\u00f4les autoris\u00e9s et refus\u00e9s, reconnexions, red\u00e9marrages, journaux client et journaux serveur.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Une \u00e9tiquette de produit qui indique QBCore n'est que le premier signal de compatibilit\u00e9. Si le serveur remplace la couche d'inventaire, de cible ou de menu de la recette, un script peut n\u00e9cessiter un adaptateur ou une modification de configuration document\u00e9e. Appliquez les modifications de la base de donn\u00e9es \u00e0 une copie de test en premier et gardez un retour en arri\u00e8re qui couvre \u00e0 la fois les fichiers et les donn\u00e9es.<\/p>\n<h2>\u00c0 qui QBCore convient<\/h2>\n<p>QBCore est un candidat raisonnable pour un nouveau serveur dont les ressources requises prennent explicitement en charge l'\u00e9cosyst\u00e8me QB actuel, ou un serveur QB existant qui utilise d\u00e9j\u00e0 son Core Object et son mod\u00e8le de donn\u00e9es. Le choix devient plus co\u00fbteux lorsqu'une \u00e9quipe dispose d'un grand ensemble de donn\u00e9es ESX, de scripts sp\u00e9cifiques au framework ou d'\u00e9v\u00e9nements personnalis\u00e9s non document\u00e9s. Dans ce cas, inventoriez la surface de migration avant de s\u00e9lectionner un nouveau framework.<\/p>\n<p>Qbox a commenc\u00e9 \u00e0 partir de la base de code QBCore et fournit un pont de compatibilit\u00e9 pour de nombreuses ressources QB bien \u00e9crites, mais la documentation officielle Qbox liste des exceptions. Ne supposez pas que chaque script QBCore est un script Qbox pr\u00eat \u00e0 l'emploi. De m\u00eame, ne migrez pas de ESX \u00e0 QBCore en fonction d'une affirmation de performance g\u00e9n\u00e9rale. Comparez la couverture des ressources, les connaissances de l'\u00e9quipe, la conversion des donn\u00e9es et le plan de test.<\/p>\n<h2>QBCore, Qbox ou ESX<\/h2>\n<ul>\n<li><strong>Rester avec QBCore<\/strong> lorsque vos ressources et votre \u00e9quipe actuelles d\u00e9pendent d\u00e9j\u00e0 des API QBCore document\u00e9es et que le chemin de mise \u00e0 niveau est compris.<\/li>\n<li><strong>Prenez en compte Qbox<\/strong> lorsque vous voulez d\u00e9lib\u00e9r\u00e9ment ses API et recette actuelles et pouvez auditer les exceptions de pont ressource par ressource.<\/li>\n<li><strong>Restez avec ESX<\/strong> lorsque vos donn\u00e9es de production, vos int\u00e9grations et vos connaissances op\u00e9rationnelles sont sp\u00e9cifiques \u00e0 ESX et qu'il n'y a pas de raison test\u00e9e de migrer.<\/li>\n<\/ul>\n<p>Utilisez la comparaison des frameworks pour une m\u00e9thode de d\u00e9cision neutre. Lors de la s\u00e9lection parmi les <a href=\"\/fr\/scripts-fivem\/\">catalogue des scripts FiveM payants<\/a>, commencez par <a href=\"\/fr\/scripts-qbcore\/\">Scripts QBCore<\/a>confirmez les exigences sur la page produit exacte et mettez en sc\u00e8ne la ressource contre une base de donn\u00e9es repr\u00e9sentative avant la production.<\/p>\n<h2>Prochaines \u00e9tapes s\u00fbres<\/h2>\n<ol>\n<li>Lisez le guide d'installation Windows QBCore actuel et la recette officielle avant de cr\u00e9er le serveur.<\/li>\n<li>Enregistrer les versions du c\u0153ur et des d\u00e9pendances d\u00e9ploy\u00e9es apr\u00e8s la fin de la recette.<\/li>\n<li>Choisir une ressource \u00e0 la fois, lire ses notes d'installation officielles et tester ses permissions et ses chemins d'\u00e9chec.<\/li>\n<li>Conservez les sauvegardes de la base de donn\u00e9es et des ressources ensemble afin qu'un retour en arri\u00e8re restaure un \u00e9tat coh\u00e9rent.<\/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\">Comparez QBCore avant de valider<\/h2>\n<p>Utilisez le <a href=\"https:\/\/fivemx.com\/fr\/cadres-fivem\/\">Comparaison entre ESX, QBCore et Qbox<\/a> pour la d\u00e9cision plus large, alors examinez le <a href=\"https:\/\/fivemx.com\/fr\/pile-qbox-ox\/\">Migration et limite de compatibilit\u00e9 Qbox<\/a> si une pile orient\u00e9e Ox est en consid\u00e9ration.<\/p>\n<\/section>","protected":false},"excerpt":{"rendered":"<p>Comprendre ce que QBCore offre, installer la pile compl\u00e8te via la recette officielle txAdmin, et \u00e9valuer les ressources par rapport \u00e0 la version exacte de votre serveur.<\/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\/fr\/wp-json\/wp\/v2\/posts\/147431","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/fivemx.com\/fr\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/fivemx.com\/fr\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/fivemx.com\/fr\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/fivemx.com\/fr\/wp-json\/wp\/v2\/comments?post=147431"}],"version-history":[{"count":7,"href":"https:\/\/fivemx.com\/fr\/wp-json\/wp\/v2\/posts\/147431\/revisions"}],"predecessor-version":[{"id":215650,"href":"https:\/\/fivemx.com\/fr\/wp-json\/wp\/v2\/posts\/147431\/revisions\/215650"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/fivemx.com\/fr\/wp-json\/wp\/v2\/media\/152045"}],"wp:attachment":[{"href":"https:\/\/fivemx.com\/fr\/wp-json\/wp\/v2\/media?parent=147431"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/fivemx.com\/fr\/wp-json\/wp\/v2\/categories?post=147431"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/fivemx.com\/fr\/wp-json\/wp\/v2\/tags?post=147431"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}