{"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:\/\/fivemx.com\/fr\/pile-qbox-ox\/","title":{"rendered":"Guide du cadre Qbox : Installation, pont QBCore et migration"},"content":{"rendered":"<p><strong>Qbox est un framework de r\u00f4le 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>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>Le chemin d'installation officiel actuel est la recette QBox la plus populaire 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>Ce qu'est Qbox<\/h2>\n<p>L'introduction officielle de Qbox enregistre 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 tandis 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>L'actuel <code>qbx_core<\/code> manifest d\u00e9clare directement <code>ox_lib<\/code> et <code>oxmysql<\/code> les d\u00e9pendances. La recette officielle rassemble Qbox et les ressources tierces s\u00e9lectionn\u00e9es en une pile de d\u00e9part compl\u00e8te. Parce que le contenu de la recette peut changer, liez-vous \u00e0 la recette actuelle plut\u00f4t que de figer une longue liste de d\u00e9pendances dans un tutoriel d'installation evergreen.<\/p>\n<h2>Installez Qbox via la recette officielle<\/h2>\n<ol>\n<li>Pr\u00e9parez un environnement FXServer pris en charge et ouvrez sa configuration txAdmin bundled.<\/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 manifests 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 manifests comme faisant partie du contrat de d\u00e9pendance. Lorsque une mise \u00e0 jour modifie une exigence de c\u0153ur ou de biblioth\u00e8que, comparez la documentation de la version contre chaque ressource d\u00e9pendante avant le d\u00e9ploiement.<\/p>\n<h2>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. Le 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<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>Candidate 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>R\u00e9organiser pour les exports ou modules pris en charge o\u00f9 document\u00e9.<\/td>\n<\/tr>\n<tr>\n<td>Suppose des grades de travail ou de gang textuels<\/td>\n<td>Examinez les exigences de conversion de grade num\u00e9rique de Qbox.<\/td>\n<\/tr>\n<tr>\n<td>Poss\u00e8de les donn\u00e9es d'inventaire 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<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>Checklist de migration pour un serveur QBCore existant<\/h2>\n<ol>\n<li><strong>Gel et inventaire :<\/strong> enregistrer le c\u0153ur, la base de donn\u00e9es, l'inventaire, les emplois, les gangs, les v\u00e9hicules, le logement, les t\u00e9l\u00e9phones, les permissions et les ressources personnalis\u00e9es.<\/li>\n<li><strong>Sauvegarder :<\/strong> cr\u00e9er des instantan\u00e9s de base de donn\u00e9es et de ressources restaurables avant le travail de conversion.<\/li>\n<li><strong>Examiner la configuration :<\/strong> Qbox documente les modifications des fichiers de configuration et de l'acc\u00e8s \u00e0 l'API ; ne copiez pas les anciens internaux du c\u0153ur \u00e0 l'aveugle.<\/li>\n<li><strong>Convertir les grades et les donn\u00e9es :<\/strong> suivre les \u00e9tapes officielles actuelles pour les grades num\u00e9riques de travail et de gang, l'inventaire et la conversion de la base de donn\u00e9es.<\/li>\n<li><strong>Auditer les ressources :<\/strong> classer chaque int\u00e9gration comme couverte par le pont, adaptable ou incompatible.<\/li>\n<li><strong>Tester par \u00e9tapes :<\/strong> valider les personnages, l'argent, les emplois, les gangs, l'inventaire, les v\u00e9hicules, les permissions et le comportement de reconnexion.<\/li>\n<li><strong>Inspecter les preuves :<\/strong> examiner les journaux du serveur, du client et de la base de donn\u00e9es et comparer les comptes de records cl\u00e9s avant le basculement.<\/li>\n<li><strong>Conserver 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>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'internals de base non document\u00e9s 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>Validation de production<\/h2>\n<p>Testez les actions r\u00e9ussies et refus\u00e9es, pas seulement le chemin heureux. Confirmez que les changements d'argent se produisent une seule fois, que les permissions des jobs 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 le UI le cache des joueurs normaux.<\/p>\n<p>Utilisez la comparaison de frameworks pour la d\u00e9cision plus large ESX\/QBCore\/Qbox. Lorsque vous s\u00e9lectionnez dans le <a href=\"\/fr\/scripts-fivem\/\">catalogue des scripts FiveM payants<\/a>, commencez par <a href=\"\/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<p><!-- fivemx-blog-content-links:2026-07-23:qbox --><\/p>\n<section class=\"fivemx-content-links\" aria-labelledby=\"fivemx-qbox-compare\">\n<h2 id=\"fivemx-qbox-compare\">Placez Qbox dans la d\u00e9cision de framework<\/h2>\n<p>Comparez la recette Qbox actuelle avec la <a href=\"https:\/\/fivemx.com\/fr\/qb-core\/\">architecture d\u00e9di\u00e9e QBCore<\/a> et le guide de d\u00e9cision complet <a href=\"https:\/\/fivemx.com\/fr\/cadres-fivem\/\">ESX, QBCore et Qbox<\/a> avant de convertir les donn\u00e9es de production.<\/p>\n<\/section>","protected":false},"excerpt":{"rendered":"<p>Un premier guide pour la recette officielle txAdmin, documentant les limites de compatibilit\u00e9, les v\u00e9rifications de migration et la validation en production.<\/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:\/\/fivemx.com\/fr\/wp-json\/wp\/v2\/posts\/153617","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=153617"}],"version-history":[{"count":9,"href":"https:\/\/fivemx.com\/fr\/wp-json\/wp\/v2\/posts\/153617\/revisions"}],"predecessor-version":[{"id":215651,"href":"https:\/\/fivemx.com\/fr\/wp-json\/wp\/v2\/posts\/153617\/revisions\/215651"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/fivemx.com\/fr\/wp-json\/wp\/v2\/media\/153618"}],"wp:attachment":[{"href":"https:\/\/fivemx.com\/fr\/wp-json\/wp\/v2\/media?parent=153617"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/fivemx.com\/fr\/wp-json\/wp\/v2\/categories?post=153617"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/fivemx.com\/fr\/wp-json\/wp\/v2\/tags?post=153617"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}