{"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:\/\/fivemx.com\/pt\/pilha-qbox-ox\/","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>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 caminho de instala\u00e7\u00e3o oficial atual \u00e9 a receita QBox mais popular 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, grades, invent\u00e1rio e convers\u00e3o de banco de dados, al\u00e9m de testes por recurso.<\/li>\n<li>N\u00e3o h\u00e1 um ranking de desempenho universal com suporte de origem entre Qbox, QBCore e ESX.<\/li>\n<\/ul>\n<h2>O que \u00e9 Qbox<\/h2>\n<p>O registro oficial de introdu\u00e7\u00e3o Qbox registra a cria\u00e7\u00e3o do projeto em 27 de setembro de 2022 e descreve sua origem no QBCore. O projeto desde ent\u00e3o 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 Qbox, mas o Qbox deve ser avaliado como seu pr\u00f3prio framework e receita.<\/p>\n<p>O atual <code>qbx_n\u00facleo<\/code> manifest declara diretamente <code>boi_lib<\/code> e <code>oxmysql<\/code> depend\u00eancias. A receita oficial re\u00fane Qbox e recursos de terceiros selecionados em um stack de partida completo. Como o conte\u00fado da receita pode mudar, link para a receita atual em vez de congelar uma longa lista de depend\u00eancias em um tutorial de instala\u00e7\u00e3o evergreen.<\/p>\n<h2>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, configura\u00e7\u00e3o do banco de dados e configura\u00e7\u00e3o do servidor usando a documenta\u00e7\u00e3o atual.<\/li>\n<li>Revise a lista de recursos gerada e a ordem de inicializa\u00e7\u00e3o antes da primeira inicializa\u00e7\u00e3o p\u00fablica.<\/li>\n<li>Verifique o carregamento de jogadores, 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 da vers\u00e3o contra cada recurso dependente antes do implanta\u00e7\u00e3o.<\/p>\n<h2>Qbox e a ponte QBCore<\/h2>\n<p>O guia de convers\u00e3o oficial Qbox explica como a ponte QB suporta a compatibilidade enquanto as APIs s\u00e3o substitu\u00eddas gradualmente. O FAQ Qbox afirma que a maioria dos scripts QBCore bem escritos pode funcionar atrav\u00e9s dessa ponte, e depois 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<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 em 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>Assume trabalho de texto ou notas de gangues<\/td>\n<td>Reveja os requisitos de convers\u00e3o de notas num\u00e9ricas do Qbox.<\/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<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 assume um esquema QB que o Qbox n\u00e3o exp\u00f5e da mesma maneira.<\/p>\n<h2>Checklist de migra\u00e7\u00e3o para um servidor QBCore existente<\/h2>\n<ol>\n<li><strong>Congelar e inventariar:<\/strong> registre n\u00facleo, banco de dados, invent\u00e1rio, trabalhos, gangues, ve\u00edculos, moradias, telefones, permiss\u00f5es e recursos personalizados.<\/li>\n<li><strong>Fa\u00e7a backup:<\/strong> crie snapshots restaur\u00e1veis do banco de dados e recursos antes do trabalho de convers\u00e3o.<\/li>\n<li><strong>Reveja a configura\u00e7\u00e3o:<\/strong> Qbox documenta altera\u00e7\u00f5es nos arquivos de configura\u00e7\u00e3o e acesso \u00e0 API; n\u00e3o copie os internos antigos do n\u00facleo de forma cega.<\/li>\n<li><strong>Converta notas e dados:<\/strong> siga os passos oficiais atuais para notas num\u00e9ricas de trabalho e gangues, convers\u00e3o de invent\u00e1rio e banco de dados.<\/li>\n<li><strong>Audite recursos:<\/strong> classifique cada integra\u00e7\u00e3o como coberta pela ponte, adapt\u00e1vel ou incompat\u00edvel.<\/li>\n<li><strong>Teste em etapas:<\/strong> valide personagens, dinheiro, trabalhos, gangues, invent\u00e1rio, ve\u00edculos, permiss\u00f5es e comportamento de reconex\u00e3o.<\/li>\n<li><strong>Inspecione evid\u00eancias:<\/strong> reveja logs do servidor, cliente e banco de dados e compare contagens de registros-chave antes da mudan\u00e7a.<\/li>\n<li><strong>Mantenha o rollback dispon\u00edvel:<\/strong> n\u00e3o mutar o \u00fanico banco de dados de produ\u00e7\u00e3o com um snippet de convers\u00e3o gen\u00e9rico.<\/li>\n<\/ol>\n<h2>Escolha Qbox por raz\u00f5es expl\u00edcitas<\/h2>\n<p>Qbox se encaixa em um novo servidor que deliberadamente deseja a receita atual Qbox e APIs. Tamb\u00e9m pode se encaixar em uma equipe QBCore preparada para auditar a compatibilidade da ponte e completar o trabalho de convers\u00e3o documentado. \u00c9 um alvo de migra\u00e7\u00e3o pobre quando recursos cr\u00edticos dependem de internos principais n\u00e3o documentados e a equipe n\u00e3o pode substitu\u00ed-los ou adapt\u00e1-los com seguran\u00e7a.<\/p>\n<p>N\u00e3o escolha Qbox porque uma p\u00e1gina promete que um invent\u00e1rio, biblioteca de banco de dados ou framework \u00e9 automaticamente mais r\u00e1pido. O desempenho depende do conjunto completo de recursos, carga de trabalho do banco de dados, comportamento do jogador, artefato e 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 mantenha os logs.<\/p>\n<h2>Valida\u00e7\u00e3o de produ\u00e7\u00e3o<\/h2>\n<p>Teste a\u00e7\u00f5es bem-sucedidas e negadas, n\u00e3o apenas o caminho feliz. Confirme que as altera\u00e7\u00f5es de dinheiro acontecem uma vez, as permiss\u00f5es de emprego e gangue rejeitam jogadores n\u00e3o autorizados, o invent\u00e1rio permanece consistente em reconex\u00f5es, os ve\u00edculos adquiridos persistem e as a\u00e7\u00f5es administrativas s\u00e3o registradas. Os pedidos do cliente devem ser validados no servidor; um evento acionado pelo cliente n\u00e3o \u00e9 seguro apenas porque o UI o esconde de jogadores normais.<\/p>\n<p>Use the framework comparison for the wider ESX\/QBCore\/Qbox decision. When selecting from the <a href=\"\/pt\/fivem-scripts\/\">pagos FiveM<\/a>, comece com <a href=\"\/pt\/scripts-qbox\/\">Scripts QBOX<\/a> and verify the current framework, bridge, inventory and dependency requirements on the product page before purchase.<\/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\">Coloque Qbox no quadro de decis\u00e3o<\/h2>\n<p>Compare a receita atual Qbox com a dedicada <a href=\"https:\/\/fivemx.com\/pt\/qbcore\/\">Guia de arquitetura QBCore<\/a> e o completo <a href=\"https:\/\/fivemx.com\/pt\/estruturas-fivem\/\">Guia de decis\u00e3o para ESX, QBCore e Qbox<\/a> antes de converter os dados de produ\u00e7\u00e3o.<\/p>\n<\/section>","protected":false},"excerpt":{"rendered":"<p>Um guia focado no Qbox para a receita oficial do txAdmin, limites de compatibilidade com QBCore documentados, verifica\u00e7\u00f5es de migra\u00e7\u00e3o e valida\u00e7\u00e3o de produ\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:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/posts\/153617","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/comments?post=153617"}],"version-history":[{"count":9,"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/posts\/153617\/revisions"}],"predecessor-version":[{"id":215651,"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/posts\/153617\/revisions\/215651"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/media\/153618"}],"wp:attachment":[{"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/media?parent=153617"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/categories?post=153617"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/tags?post=153617"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}