{"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":"qb-core","status":"publish","type":"post","link":"https:\/\/rpcrate.com\/fr\/qbcore\/","title":{"rendered":"Guide du framework QBCore : Architecture, Installation et Compatibilit\u00e9"},"content":{"rendered":"<p class=\"translation-block\"><strong>QBCore est un framework de jeu de r\u00f4le open source pour FiveM.<\/strong> Sa ressource <code>qb-core<\/code> expose des donn\u00e9es de joueur partag\u00e9es, des fonctions du framework, des commandes et des d\u00e9finitions utilisables par les autres ressources QB. Pour un nouveau serveur, utilisez la recette txAdmin officielle de QBCore plut\u00f4t que de consid\u00e9rer le dossier <code>qb-core<\/code> comme une installation compl\u00e8te.<\/p>\n<h2 id=\"key-takeaways\">Points cl\u00e9s<\/h2>\n<ul>\n<li><code data-no-translation=\"\" translate=\"no\">qb-core<\/code> est la ressource principale, pas un serveur de jeu de r\u00f4le complet en soi.<\/li>\n<li>Le guide officiel pour Windows d\u00e9ploie le mod\u00e8le populaire QBCore Framework 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 id=\"what-qbcore-provides\">Ce que QBCore fournit<\/h2>\n<p>Le Core Object de QBCore est l\u2019interface 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 du Core Object dont elle a besoin, mais les API requises doivent correspondre \u00e0 la version du c\u0153ur install\u00e9e sur le serveur.<\/p>\n<p>Les d\u00e9finitions partag\u00e9es incluent les m\u00e9tiers, les gangs, les objets et les v\u00e9hicules repr\u00e9sent\u00e9s dans des tables Lua. Les fonctions principales couvrent les op\u00e9rations courantes du framework, 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 framework 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 id=\"install-qbcore-with-the-official-recipe\">Installez QBCore avec la recette officielle<\/h2>\n<p>La proc\u00e9dure d\u2019installation officielle actuelle pour Windows utilise l\u2019interface txAdmin fournie avec FXServer. Dans le d\u00e9ployeur de recettes, s\u00e9lectionnez le mod\u00e8le QBCore Framework parmi les mod\u00e8les populaires et suivez le guide d\u2019installation actuel de QBCore. Le d\u00e9p\u00f4t de recettes explique pourquoi un seul ZIP ne suffit pas : il pr\u00e9pare la base de donn\u00e9es et t\u00e9l\u00e9charge un ensemble de ressources autour de <code data-no-translation=\"\" translate=\"no\">qb-core<\/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 un nouveau d\u00e9ploiement avec 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 data-no-translation=\"\" translate=\"no\">qb-core<\/code>.<\/li>\n<li class=\"translation-block\">Examinez le fichier <code>server.cfg<\/code> g\u00e9n\u00e9r\u00e9, l\u2019ordre des ressources et les secrets avant de rendre le serveur accessible.<\/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 data-no-translation=\"\" translate=\"no\">qb-core\/config.lua<\/code>; ce fichier est utilis\u00e9 pour la configuration principale et des joueurs.<\/p>\n<h2 id=\"add-a-qbcore-resource-safely\">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, enregistrez la version exacte de <code data-no-translation=\"\" translate=\"no\">qb-core<\/code> et de chaque syst\u00e8me connexe avec lequel elle doit s\u2019int\u00e9grer. V\u00e9rifiez ensuite les points suivants :<\/p>\n<div aria-label=\"Tableau \u00e0 d\u00e9filement horizontal\" class=\"fmx-guide-table\" role=\"region\" tabindex=\"0\">\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>Ordre<\/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<\/div>\n<p>Une \u00e9tiquette de produit indiquant 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 document\u00e9 ou un changement de configuration. Appliquez d'abord les modifications de base de donn\u00e9es \u00e0 une copie de test et conservez une restauration qui couvre \u00e0 la fois les fichiers et les donn\u00e9es.<\/p>\n<h2 id=\"who-qbcore-fits\">\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 id=\"qbcore-qbox-or-esx\">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 prendre une d\u00e9cision selon des crit\u00e8res neutres. Lors de votre choix dans le <a href=\"https:\/\/rpcrate.com\/fr\/boutique\/\">catalogue des scripts FiveM payants<\/a>, commencez par <a href=\"https:\/\/rpcrate.com\/fr\/scripts-qbcore\/\">Scripts QBCore<\/a>, confirmez les exigences sur la page exacte du produit et testez la ressource en pr\u00e9production avec une base de donn\u00e9es repr\u00e9sentative avant de la mettre en production.<\/p>\n<h2 id=\"use-the-official-qbcore-recipe-as-the-installation-boundary\">Utilisez la recette officielle QBCore comme limite d'installation<\/h2>\n<p class=\"translation-block\">Commencez par la <a href=\"https:\/\/github.com\/qbcore-fivem\/txAdminRecipe\" rel=\"nofollow noopener\">recette txAdmin de QBCore<\/a> actuellement maintenue et le <a href=\"https:\/\/qbcore.org\/docs\/guides\/windows-installation\" rel=\"nofollow noopener\">guide d\u2019installation<\/a> officiel. Une recette met en place une base ; elle ne prouve pas qu\u2019un ancien script tiers prend en charge les versions install\u00e9es du framework, de la base de donn\u00e9es, de l\u2019inventaire ou du syst\u00e8me de ciblage. Notez le commit de la recette et v\u00e9rifiez chaque ressource ajout\u00e9e dans un environnement de test avant la mise en production.<\/p>","protected":false},"excerpt":{"rendered":"<p class=\"translation-block\"><strong>QBCore est un framework de jeu de r\u00f4le open source pour FiveM.<\/strong> Sa ressource <code>qb-core<\/code> expose des donn\u00e9es de joueur partag\u00e9es, des fonctions du framework, des commandes et des d\u00e9finitions utilisables par les autres ressources QB. Pour un nouveau serveur, utilisez la recette txAdmin officielle de QBCore plut\u00f4t que de consid\u00e9rer le dossier <code>qb-core<\/code> comme une installation compl\u00e8te.<\/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\/fr\/wp-json\/wp\/v2\/posts\/147431","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/rpcrate.com\/fr\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/rpcrate.com\/fr\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/rpcrate.com\/fr\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/rpcrate.com\/fr\/wp-json\/wp\/v2\/comments?post=147431"}],"version-history":[{"count":7,"href":"https:\/\/rpcrate.com\/fr\/wp-json\/wp\/v2\/posts\/147431\/revisions"}],"predecessor-version":[{"id":215650,"href":"https:\/\/rpcrate.com\/fr\/wp-json\/wp\/v2\/posts\/147431\/revisions\/215650"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/rpcrate.com\/fr\/wp-json\/wp\/v2\/media\/152045"}],"wp:attachment":[{"href":"https:\/\/rpcrate.com\/fr\/wp-json\/wp\/v2\/media?parent=147431"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/rpcrate.com\/fr\/wp-json\/wp\/v2\/categories?post=147431"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/rpcrate.com\/fr\/wp-json\/wp\/v2\/tags?post=147431"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}