{"id":153617,"date":"2025-09-05T15:40:58","date_gmt":"2025-09-05T13:40:58","guid":{"rendered":"https:\/\/hifivem.com\/?p=153617"},"modified":"2026-08-05T21:21:48","modified_gmt":"2026-08-05T19:21:48","slug":"pile-qbox-ox","status":"publish","type":"post","link":"https:\/\/rpcrate.com\/fr\/qbox-ox-stack\/","title":{"rendered":"Guide du framework Qbox : Installation, pont QBCore et migration"},"content":{"rendered":"<p><strong>Qbox est un framework de jeu de r\u00f4le pour FiveM qui a commenc\u00e9 comme une bifurcation QBCore et fournit d\u00e9sormais ses propres API et ressources principales.<\/strong> Il maintient un pont de compatibilit\u00e9 pour de nombreuses ressources QBCore correctement \u00e9crites, mais l'acc\u00e8s direct \u00e0 la base de donn\u00e9es, l'acc\u00e8s aux fichiers internes et les comportements non pris en charge sont des exceptions document\u00e9es. Utilisez la recette officielle Qbox txAdmin pour une nouvelle installation et auditez chaque ressource avant une migration.<\/p>\n<h2 id=\"key-takeaways\">Points cl\u00e9s<\/h2>\n<ul>\n<li>Qbox est un framework, pas simplement un ensemble d'utilitaires Ox ou un dossier QBCore renomm\u00e9.<\/li>\n<li>La proc\u00e9dure d\u2019installation officielle actuelle utilise la recette populaire QBox dans txAdmin.<\/li>\n<li>Le pont QB peut aider avec les ressources compatibles, mais il n'est pas une garantie pour chaque script QBCore.<\/li>\n<li>La migration inclut la configuration, les grades, l'inventaire et la conversion de la base de donn\u00e9es, ainsi que des tests ressource par ressource.<\/li>\n<li>Il n'y a pas de classement universel de performance bas\u00e9 sur la source entre Qbox, QBCore et ESX.<\/li>\n<\/ul>\n<h2 id=\"what-qbox-is\">Ce qu'est Qbox<\/h2>\n<p>L'introduction officielle de Qbox relate la cr\u00e9ation du projet le 27 septembre 2022 et d\u00e9crit son origine dans QBCore. Le projet a depuis d\u00e9velopp\u00e9 son propre c\u0153ur et ses ressources associ\u00e9es. Sa couche de compatibilit\u00e9 existe pour faciliter l'utilisation de nombreuses ressources QB pendant que les \u00e9quipes adoptent les API Qbox actuelles, mais Qbox doit \u00eatre \u00e9valu\u00e9 comme son propre framework et sa propre recette.<\/p>\n<p class=\"translation-block\">Le manifeste actuel de <code>qbx_core<\/code> d\u00e9clare directement les d\u00e9pendances <code>ox_lib<\/code> et <code>oxmysql<\/code>. La recette officielle r\u00e9unit Qbox et une s\u00e9lection de ressources tierces pour constituer une base compl\u00e8te. Le contenu des recettes pouvant \u00e9voluer, donnez un lien vers la recette actuelle plut\u00f4t que de figer une longue liste de d\u00e9pendances dans un tutoriel d\u2019installation destin\u00e9 \u00e0 rester utile dans le temps.<\/p>\n<h2 id=\"install-qbox-through-the-official-recipe\">Installez Qbox via la recette officielle<\/h2>\n<ol>\n<li>Pr\u00e9parez un environnement FXServer pris en charge et ouvrez sa configuration txAdmin fournie.<\/li>\n<li>R\u00e9pondez aux exigences de la base de donn\u00e9es list\u00e9es dans la documentation d'installation actuelle de Qbox.<\/li>\n<li>S\u00e9lectionnez la recette officielle QBox populaire plut\u00f4t que d'assembler un c\u0153ur partiel manuellement.<\/li>\n<li>Compl\u00e9tez les variables de la recette, la configuration de la base de donn\u00e9es et la configuration du serveur en utilisant la documentation actuelle.<\/li>\n<li>Passez en revue la liste des ressources g\u00e9n\u00e9r\u00e9es et l'ordre de d\u00e9marrage avant le premier d\u00e9marrage public.<\/li>\n<li>V\u00e9rifiez le chargement des joueurs, la cr\u00e9ation de personnages, les autorisations, la persistance et les journaux sur un serveur de test.<\/li>\n<\/ol>\n<p>Ne remplacez pas les manifestes des fournisseurs par des exemples raccourcis copi\u00e9s \u00e0 partir d'un guide. Installez les versions officielles ou les versions de la recette et traitez leurs manifestes comme faisant partie du contrat de d\u00e9pendance. Lorsqu\u2019une mise \u00e0 jour modifie une exigence de c\u0153ur ou de biblioth\u00e8que, comparez la documentation de la version aux exigences de chaque ressource d\u00e9pendante avant le d\u00e9ploiement.<\/p>\n<h2 id=\"qbox-and-the-qbcore-bridge\">Qbox et le pont QBCore<\/h2>\n<p>Le guide de conversion officiel de Qbox explique comment le pont QB soutient la compatibilit\u00e9 tandis que les API sont remplac\u00e9es progressivement. La FAQ de Qbox indique que la plupart des scripts QBCore correctement \u00e9crits peuvent fonctionner \u00e0 travers ce pont, puis identifie les exceptions importantes : les ressources qui acc\u00e8dent directement aux tables de base de donn\u00e9es, lisent ou modifient les fichiers principaux internes, ou s'appuient sur des comportements non pris en charge peuvent n\u00e9cessiter des modifications.<\/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>Comportement des ressources<\/th>\n<th>Attente de migration<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Utilise les API QB document\u00e9es couvertes par le pont<\/td>\n<td>Candidat pour les tests de pont ; la compatibilit\u00e9 doit encore \u00eatre v\u00e9rifi\u00e9e.<\/td>\n<\/tr>\n<tr>\n<td>Lit directement les tables du framework<\/td>\n<td>Auditez les requ\u00eates et les hypoth\u00e8ses de sch\u00e9ma avant de toucher aux donn\u00e9es en direct.<\/td>\n<\/tr>\n<tr>\n<td>Charge les fichiers internes du c\u0153ur<\/td>\n<td>Adaptez le code aux exports ou modules pris en charge lorsque la documentation le pr\u00e9voit.<\/td>\n<\/tr>\n<tr>\n<td>Suppose que les grades de m\u00e9tier ou de gang sont du texte<\/td>\n<td>Examinez les exigences de conversion des grades num\u00e9riques de Qbox.<\/td>\n<\/tr>\n<tr>\n<td>G\u00e8re les donn\u00e9es d\u2019inventaire ou de personnage<\/td>\n<td>Utilisez le chemin de conversion document\u00e9 et validez chaque relation.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<p>Un produit marqu\u00e9 compatible QBCore doit donc \u00eatre test\u00e9 contre Qbox en tant que cible s\u00e9par\u00e9e. Demandez s'il utilise uniquement les API couvertes par le pont document\u00e9, quels syst\u00e8mes d'inventaire et cibles il attend, et si son SQL suppose un sch\u00e9ma QB que Qbox n'expose pas de la m\u00eame mani\u00e8re.<\/p>\n<h2 id=\"migration-checklist-for-an-existing-qbcore-server\">Checklist de migration pour un serveur QBCore existant<\/h2>\n<ol>\n<li><strong>Gelez les modifications et faites l\u2019inventaire :<\/strong> recensez le c\u0153ur, la base de donn\u00e9es, l\u2019inventaire, les m\u00e9tiers, les gangs, les v\u00e9hicules, les logements, les t\u00e9l\u00e9phones, les permissions et les ressources personnalis\u00e9es.<\/li>\n<li><strong>Sauvegardez :<\/strong> cr\u00e9ez des instantan\u00e9s restaurables de la base de donn\u00e9es et des ressources avant la conversion.<\/li>\n<li><strong>Examinez la configuration :<\/strong> Qbox documente les modifications des fichiers de configuration et de l\u2019acc\u00e8s aux API ; ne recopiez pas aveugl\u00e9ment les anciens \u00e9l\u00e9ments internes du c\u0153ur.<\/li>\n<li><strong>Convertissez les grades et les donn\u00e9es :<\/strong> suivez la proc\u00e9dure officielle actuelle pour convertir les grades num\u00e9riques des m\u00e9tiers et des gangs, l\u2019inventaire et la base de donn\u00e9es.<\/li>\n<li><strong>Auditez les ressources :<\/strong> classez chaque int\u00e9gration comme couverte par le pont, adaptable ou incompatible.<\/li>\n<li><strong>Testez par \u00e9tapes :<\/strong> validez les personnages, l'argent, les m\u00e9tiers, les gangs, l'inventaire, les v\u00e9hicules, les permissions et le comportement de reconnexion.<\/li>\n<li><strong>Inspectez les preuves :<\/strong> examinez les journaux du serveur, du client et de la base de donn\u00e9es et comparez le nombre d\u2019enregistrements essentiels avant le basculement.<\/li>\n<li><strong>Gardez la possibilit\u00e9 de revenir en arri\u00e8re :<\/strong> ne modifiez pas la seule base de donn\u00e9es de production avec un extrait de conversion g\u00e9n\u00e9rique.<\/li>\n<\/ol>\n<h2 id=\"choose-qbox-for-explicit-reasons\">Choisissez Qbox pour des raisons explicites<\/h2>\n<p>Qbox convient \u00e0 un nouveau serveur qui souhaite d\u00e9lib\u00e9r\u00e9ment la recette et les API Qbox actuelles. Il peut \u00e9galement convenir \u00e0 une \u00e9quipe QBCore pr\u00e9par\u00e9e \u00e0 auditer la compatibilit\u00e9 du pont et \u00e0 compl\u00e9ter le travail de conversion document\u00e9. C'est une mauvaise cible de migration lorsque des ressources critiques d\u00e9pendent d\u2019\u00e9l\u00e9ments internes non document\u00e9s du c\u0153ur et que l'\u00e9quipe ne peut pas les remplacer ou les adapter en toute s\u00e9curit\u00e9.<\/p>\n<p>Ne choisissez pas Qbox parce qu'une page promet qu'un inventaire, une biblioth\u00e8que de bases de donn\u00e9es ou un framework est automatiquement plus rapide. Les performances d\u00e9pendent de l'ensemble complet des ressources, de la charge de travail de la base de donn\u00e9es, du comportement des joueurs, des artefacts et de la configuration du serveur. Si les performances sont un facteur de d\u00e9cision, effectuez des benchmarks d'actions repr\u00e9sentatives sur des environnements \u00e9quivalents et conservez les journaux.<\/p>\n<h2 id=\"production-validation\">Validation de production<\/h2>\n<p>Testez les actions r\u00e9ussies et refus\u00e9es, pas seulement le sc\u00e9nario nominal. Confirmez que les changements d'argent se produisent une seule fois, que les permissions des m\u00e9tiers et des gangs rejettent les joueurs non autoris\u00e9s, que l'inventaire reste coh\u00e9rent entre les reconnexions, que les v\u00e9hicules poss\u00e9d\u00e9s persistent, et que les actions administratives sont enregistr\u00e9es. Les requ\u00eates des clients doivent \u00eatre valid\u00e9es sur le serveur ; un \u00e9v\u00e9nement d\u00e9clench\u00e9 par le client n'est pas s\u00fbr simplement parce que l'interface utilisateur le cache des joueurs normaux.<\/p>\n<p>Consultez le comparatif des frameworks pour choisir entre ESX, QBCore et Qbox. Pour une s\u00e9lection dans le <a href=\"https:\/\/rpcrate.com\/fr\/boutique\/\">catalogue des scripts FiveM payants<\/a>, commencez par <a href=\"https:\/\/rpcrate.com\/fr\/scripts-qbox\/\">Scripts QBOX<\/a> et v\u00e9rifiez les exigences actuelles du framework, du pont, de l'inventaire et des d\u00e9pendances sur la page du produit avant l'achat.<\/p>\n<section aria-labelledby=\"fivemx-qbox-compare\" class=\"fivemx-content-links\">\n<h2 id=\"fivemx-qbox-compare\">Placez Qbox dans la d\u00e9cision du framework<\/h2>\n<p class=\"translation-block\">Comparez la recette Qbox actuelle avec le <a href=\"https:\/\/fivemx.com\/qbcore\/\">guide consacr\u00e9 \u00e0 l\u2019architecture de QBCore<\/a> et le <a href=\"https:\/\/fivemx.com\/fivem-frameworks\/\">guide complet pour choisir entre ESX, QBCore et Qbox<\/a> avant de convertir les donn\u00e9es de production.<\/p>\n<\/section>\n<h2 id=\"reference-documentation\">Documentation de r\u00e9f\u00e9rence<\/h2>\n<p><a href=\"https:\/\/docs.qbox.re\/installation\">Source : docs.qbox.re<\/a> \u00b7 <a href=\"https:\/\/docs.qbox.re\/installation\">Source : docs.qbox.re<\/a> \u00b7 <a href=\"https:\/\/docs.qbox.re\/converting\">Source : docs.qbox.re<\/a><\/p>","protected":false},"excerpt":{"rendered":"<p>Qbox est un framework de jeu de r\u00f4le pour FiveM qui a commenc\u00e9 comme un fork de QBCore et fournit maintenant ses propres API et ressources de base. Il maintient un pont de compatibilit\u00e9 pour de nombreuses ressources QBCore correctement \u00e9crites, mais l'acc\u00e8s direct \u00e0 la base de donn\u00e9es, l'acc\u00e8s aux fichiers internes et les comportements non pris en charge sont des exceptions document\u00e9es. Utilisez la recette officielle Qbox txAdmin pour une nouvelle installation et auditez chaque ressource avant une migration.<\/p>","protected":false},"author":1,"featured_media":153618,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2347],"tags":[2950,2940],"class_list":["post-153617","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-frameworks","tag-framework","tag-qbox"],"_links":{"self":[{"href":"https:\/\/rpcrate.com\/fr\/wp-json\/wp\/v2\/posts\/153617","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=153617"}],"version-history":[{"count":9,"href":"https:\/\/rpcrate.com\/fr\/wp-json\/wp\/v2\/posts\/153617\/revisions"}],"predecessor-version":[{"id":215651,"href":"https:\/\/rpcrate.com\/fr\/wp-json\/wp\/v2\/posts\/153617\/revisions\/215651"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/rpcrate.com\/fr\/wp-json\/wp\/v2\/media\/153618"}],"wp:attachment":[{"href":"https:\/\/rpcrate.com\/fr\/wp-json\/wp\/v2\/media?parent=153617"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/rpcrate.com\/fr\/wp-json\/wp\/v2\/categories?post=153617"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/rpcrate.com\/fr\/wp-json\/wp\/v2\/tags?post=153617"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}