{"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":"pilha-qbox-ox","status":"publish","type":"post","link":"https:\/\/rpcrate.com\/pt\/qbox-ox-stack\/","title":{"rendered":"Guia do Framework Qbox: Instala\u00e7\u00e3o, Ponte QBCore e Migra\u00e7\u00e3o"},"content":{"rendered":"<p><strong>Qbox \u00e9 um framework de roleplay FiveM que come\u00e7ou como um fork QBCore e agora fornece suas pr\u00f3prias APIs e recursos principais.<\/strong> Ele mant\u00e9m uma ponte de compatibilidade para muitos recursos QBCore bem escritos, mas o acesso direto ao banco de dados, o acesso a arquivos internos e comportamentos n\u00e3o suportados s\u00e3o exce\u00e7\u00f5es documentadas. Use a receita oficial Qbox txAdmin para uma nova instala\u00e7\u00e3o e audite cada recurso antes de uma migra\u00e7\u00e3o.<\/p>\n<h2 id=\"key-takeaways\">Principais conclus\u00f5es<\/h2>\n<ul>\n<li>Qbox \u00e9 um framework, n\u00e3o apenas um pacote de utilit\u00e1rios Ox ou uma pasta QBCore renomeada.<\/li>\n<li>O procedimento oficial atual de instala\u00e7\u00e3o usa a receita QBox da categoria de receitas populares no txAdmin.<\/li>\n<li>A ponte QB pode ajudar com recursos compat\u00edveis, mas n\u00e3o \u00e9 uma garantia para cada script QBCore.<\/li>\n<li>A migra\u00e7\u00e3o inclui configura\u00e7\u00e3o, n\u00edveis de cargos, convers\u00e3o do invent\u00e1rio e do banco de dados, al\u00e9m de testes de cada recurso.<\/li>\n<li>N\u00e3o h\u00e1 uma classifica\u00e7\u00e3o universal de desempenho entre Qbox, QBCore e ESX sustentada por fontes.<\/li>\n<\/ul>\n<h2 id=\"what-qbox-is\">O que \u00e9 Qbox<\/h2>\n<p>A introdu\u00e7\u00e3o oficial do Qbox registra a cria\u00e7\u00e3o do projeto em 27 de setembro de 2022 e descreve sua origem no QBCore. Desde ent\u00e3o, o projeto desenvolveu seu pr\u00f3prio n\u00facleo e recursos relacionados. Sua camada de compatibilidade existe para facilitar o uso de muitos recursos QB enquanto as equipes adotam as APIs atuais do Qbox, mas o Qbox deve ser avaliado como seu pr\u00f3prio framework e receita.<\/p>\n<p class=\"translation-block\">O manifesto atual de <code>qbx_core<\/code> declara diretamente as depend\u00eancias <code>ox_lib<\/code> e <code>oxmysql<\/code>. A receita oficial re\u00fane Qbox e recursos selecionados de terceiros em uma base inicial completa. Como o conte\u00fado da receita pode mudar, forne\u00e7a o link para a receita atual em vez de fixar uma longa lista de depend\u00eancias em um tutorial de instala\u00e7\u00e3o destinado a continuar \u00fatil.<\/p>\n<h2 id=\"install-qbox-through-the-official-recipe\">Instale Qbox atrav\u00e9s da receita oficial<\/h2>\n<ol>\n<li>Prepare um ambiente FXServer suportado e abra sua configura\u00e7\u00e3o txAdmin embutida.<\/li>\n<li>Atenda aos requisitos de banco de dados listados na documenta\u00e7\u00e3o de instala\u00e7\u00e3o atual Qbox.<\/li>\n<li>Selecione a receita oficial QBox popular em vez de montar um n\u00facleo parcial manualmente.<\/li>\n<li>Complete as vari\u00e1veis da receita, a configura\u00e7\u00e3o do banco de dados e a configura\u00e7\u00e3o do servidor usando a documenta\u00e7\u00e3o atual.<\/li>\n<li>Revise a lista de recursos gerada e a ordem de in\u00edcio antes do primeiro in\u00edcio p\u00fablico.<\/li>\n<li>Verifique o carregamento de jogadores, a cria\u00e7\u00e3o de personagens, permiss\u00f5es, persist\u00eancia e logs em um servidor de teste.<\/li>\n<\/ol>\n<p>N\u00e3o substitua os manifests do fornecedor por exemplos encurtados copiados de um guia. Instale as vers\u00f5es oficiais ou da receita e trate seus manifests como parte do contrato de depend\u00eancia. Quando uma atualiza\u00e7\u00e3o altera um requisito de n\u00facleo ou biblioteca, compare a documenta\u00e7\u00e3o de lan\u00e7amento contra cada recurso dependente antes da implanta\u00e7\u00e3o.<\/p>\n<h2 id=\"qbox-and-the-qbcore-bridge\">Qbox e a ponte QBCore<\/h2>\n<p>O guia de convers\u00e3o oficial do Qbox explica como a ponte QB suporta a compatibilidade enquanto as APIs s\u00e3o substitu\u00eddas incrementalmente. O FAQ do Qbox afirma que a maioria dos scripts QBCore bem escritos pode funcionar atrav\u00e9s dessa ponte, e ent\u00e3o identifica exce\u00e7\u00f5es importantes: recursos que acessam diretamente tabelas de banco de dados, leem ou modificam arquivos internos do n\u00facleo, ou dependem de comportamentos n\u00e3o suportados podem precisar de altera\u00e7\u00f5es.<\/p>\n<div aria-label=\"Tabela com rolagem horizontal\" class=\"fmx-guide-table\" role=\"region\" tabindex=\"0\">\n<table>\n<thead>\n<tr>\n<th>Comportamento do recurso<\/th>\n<th>Expectativa de migra\u00e7\u00e3o<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Usa APIs QB documentadas cobertas pela ponte<\/td>\n<td>Candidato para teste de ponte; a compatibilidade ainda precisa ser verificada.<\/td>\n<\/tr>\n<tr>\n<td>L\u00ea tabelas de framework diretamente<\/td>\n<td>Audite consultas e suposi\u00e7\u00f5es de esquema antes de tocar nos dados ao vivo.<\/td>\n<\/tr>\n<tr>\n<td>Carrega arquivos internos do n\u00facleo<\/td>\n<td>Refatore para exporta\u00e7\u00f5es ou m\u00f3dulos suportados onde documentado.<\/td>\n<\/tr>\n<tr>\n<td>Pressup\u00f5e n\u00edveis de empregos ou gangues armazenados como texto<\/td>\n<td>Revise os requisitos do Qbox para converter os n\u00edveis dos cargos em valores num\u00e9ricos.<\/td>\n<\/tr>\n<tr>\n<td>Possui dados de invent\u00e1rio ou de personagem<\/td>\n<td>Use o caminho de convers\u00e3o documentado e valide cada rela\u00e7\u00e3o.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<p>Um produto marcado como compat\u00edvel com QBCore deve, portanto, ser testado contra Qbox como um alvo separado. Pergunte se ele usa apenas APIs cobertas pela ponte documentada, quais sistemas de invent\u00e1rio e alvo ele espera, e se seu SQL sup\u00f5e um esquema QB que o Qbox n\u00e3o exp\u00f5e da mesma forma.<\/p>\n<h2 id=\"migration-checklist-for-an-existing-qbcore-server\">Checklist de migra\u00e7\u00e3o para um servidor QBCore existente<\/h2>\n<ol>\n<li><strong>Congelar e inventariar:<\/strong> registrar n\u00facleo, banco de dados, invent\u00e1rio, trabalhos, gangues, ve\u00edculos, moradias, telefones, permiss\u00f5es e recursos personalizados.<\/li>\n<li><strong>Fazer backup:<\/strong> criar snapshots restaur\u00e1veis do banco de dados e recursos antes do trabalho de convers\u00e3o.<\/li>\n<li><strong>Revisar configura\u00e7\u00e3o:<\/strong> Qbox documenta altera\u00e7\u00f5es nos arquivos de configura\u00e7\u00e3o e acesso \u00e0 API; n\u00e3o copie internos antigos do n\u00facleo sem pensar.<\/li>\n<li><strong>Converta os n\u00edveis dos cargos e os dados:<\/strong> siga as etapas oficiais atuais para converter os n\u00edveis de empregos e gangues em valores num\u00e9ricos e converter o invent\u00e1rio e o banco de dados.<\/li>\n<li><strong>Auditar recursos:<\/strong> classifique cada integra\u00e7\u00e3o como coberta pelo bridge, adapt\u00e1vel ou incompat\u00edvel.<\/li>\n<li><strong>Teste em etapas:<\/strong> valide personagens, dinheiro, empregos, gangues, invent\u00e1rio, ve\u00edculos, permiss\u00f5es e comportamento de reconex\u00e3o.<\/li>\n<li><strong>Inspecione as evid\u00eancias:<\/strong> revise os logs do servidor, do cliente e do banco de dados e compare as contagens dos registros principais antes do cutover.<\/li>\n<li><strong>Mantenha o rollback dispon\u00edvel:<\/strong> n\u00e3o altere o \u00fanico banco de dados de produ\u00e7\u00e3o com um snippet de convers\u00e3o gen\u00e9rico.<\/li>\n<\/ol>\n<h2 id=\"choose-qbox-for-explicit-reasons\">Escolha o Qbox por raz\u00f5es expl\u00edcitas<\/h2>\n<p>O Qbox se encaixa em um novo servidor que deliberadamente deseja a receita e as APIs atuais do Qbox. Tamb\u00e9m pode servir a uma equipe QBCore preparada para auditar a compatibilidade do bridge e concluir o trabalho de convers\u00e3o documentado. \u00c9 um alvo de migra\u00e7\u00e3o ruim quando recursos cr\u00edticos dependem de internos n\u00e3o documentados do core e a equipe n\u00e3o consegue substitu\u00ed-los ou adapt\u00e1-los com seguran\u00e7a.<\/p>\n<p>N\u00e3o escolha o Qbox porque uma p\u00e1gina promete que um invent\u00e1rio, uma biblioteca de banco de dados ou um framework \u00e9 automaticamente mais r\u00e1pido. O desempenho depende do conjunto completo de recursos, da carga de trabalho do banco de dados, do comportamento dos jogadores, do artefato e da configura\u00e7\u00e3o do servidor. Se o desempenho for um fator de decis\u00e3o, fa\u00e7a benchmark de a\u00e7\u00f5es representativas em ambientes equivalentes e guarde os logs.<\/p>\n<h2 id=\"production-validation\">Valida\u00e7\u00e3o em produ\u00e7\u00e3o<\/h2>\n<p>Teste a\u00e7\u00f5es bem-sucedidas e negadas, n\u00e3o apenas o caminho ideal. Confirme que as altera\u00e7\u00f5es de dinheiro acontecem uma \u00fanica vez, que as permiss\u00f5es de emprego e gangue rejeitam jogadores n\u00e3o autorizados, que o invent\u00e1rio permanece consistente entre reconex\u00f5es, que os ve\u00edculos de propriedade dos jogadores persistem e que as a\u00e7\u00f5es administrativas s\u00e3o registradas. As solicita\u00e7\u00f5es do cliente devem ser validadas no servidor; um evento acionado pelo cliente n\u00e3o \u00e9 seguro apenas porque a UI o esconde dos jogadores comuns.<\/p>\n<p>Use a compara\u00e7\u00e3o de frameworks para a decis\u00e3o mais ampla entre ESX\/QBCore\/Qbox. Ao selecionar no <a href=\"https:\/\/rpcrate.com\/pt\/loja\/\">cat\u00e1logo de scripts pagos de FiveM<\/a>, comece com <a href=\"https:\/\/rpcrate.com\/pt\/scripts-qbox\/\">QBOX Scripts<\/a> e verifique os requisitos atuais de framework, bridge, invent\u00e1rio e depend\u00eancias na p\u00e1gina do produto antes da compra.<\/p>\n<section aria-labelledby=\"fivemx-qbox-compare\" class=\"fivemx-content-links\">\n<h2 id=\"fivemx-qbox-compare\">Posicione o Qbox na decis\u00e3o de framework<\/h2>\n<p>Compare a receita atual do Qbox com o dedicado <a href=\"https:\/\/rpcrate.com\/pt\/qbcore\/\">Guia de arquitetura QBCore<\/a> e o completo <a href=\"https:\/\/rpcrate.com\/pt\/estruturas-fivem\/\">Guia de decis\u00e3o ESX, QBCore e Qbox<\/a> antes de converter dados de produ\u00e7\u00e3o.<\/p>\n<\/section>\n<h2 id=\"reference-documentation\">Documenta\u00e7\u00e3o de refer\u00eancia<\/h2>\n<p><a href=\"https:\/\/docs.qbox.re\/installation\">Fonte: docs.qbox.re<\/a> \u00b7 <a href=\"https:\/\/docs.qbox.re\/installation\">Fonte: docs.qbox.re<\/a> \u00b7 <a href=\"https:\/\/docs.qbox.re\/converting\">Fonte: docs.qbox.re<\/a><\/p>","protected":false},"excerpt":{"rendered":"<p>Qbox \u00e9 um framework de roleplay FiveM que come\u00e7ou como um fork QBCore e agora fornece suas pr\u00f3prias APIs e recursos principais. Ele mant\u00e9m uma ponte de compatibilidade para muitos recursos QBCore bem escritos, mas o acesso direto ao banco de dados, o acesso a arquivos internos e comportamentos n\u00e3o suportados s\u00e3o exce\u00e7\u00f5es documentadas. Use a receita oficial Qbox txAdmin para uma nova instala\u00e7\u00e3o e audite cada recurso antes de uma migra\u00e7\u00e3o.<\/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\/pt\/wp-json\/wp\/v2\/posts\/153617","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/comments?post=153617"}],"version-history":[{"count":9,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/posts\/153617\/revisions"}],"predecessor-version":[{"id":215651,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/posts\/153617\/revisions\/215651"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/media\/153618"}],"wp:attachment":[{"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/media?parent=153617"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/categories?post=153617"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/tags?post=153617"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}