{"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-05T21:21:46","modified_gmt":"2026-08-05T19:21:46","slug":"qbcore","status":"publish","type":"post","link":"https:\/\/fivemx.com\/pt\/qbcore\/","title":{"rendered":"Guia do Framework QBCore: Arquitetura, Instala\u00e7\u00e3o e Compatibilidade"},"content":{"rendered":"<p><strong>QBCore \u00e9 um framework de roleplay de c\u00f3digo aberto para FiveM.<\/strong> Seu <code>qb-n\u00facleo<\/code> recurso exp\u00f5e dados de jogadores compartilhados, fun\u00e7\u00f5es do framework, comandos e defini\u00e7\u00f5es que outros recursos QB podem usar. Para um servidor novo, use a receita oficial QBCore txAdmin em vez de tratar a <code>qb-n\u00facleo<\/code> pasta como uma instala\u00e7\u00e3o completa.<\/p>\n<h2>Principais conclus\u00f5es<\/h2>\n<ul>\n<li><code>qb-n\u00facleo<\/code> \u00e9 o recurso principal, n\u00e3o um servidor de roleplay completo por si s\u00f3.<\/li>\n<li>O guia oficial do Windows implanta o modelo popular do Framework QBCore atrav\u00e9s do txAdmin.<\/li>\n<li>A receita oficial inclui a configura\u00e7\u00e3o do banco de dados e um conjunto mais amplo de recursos QB.<\/li>\n<li>A compatibilidade depende das vers\u00f5es exatas, depend\u00eancias, exports, SQL e ordem dos recursos.<\/li>\n<li>Nenhuma fonte oficial estabelece o QBCore como um vencedor universal de desempenho; profile a pilha completa que voc\u00ea planeja executar.<\/li>\n<\/ul>\n<h2>O que o QBCore oferece<\/h2>\n<p>O Objeto Principal QBCore \u00e9 a interface compartilhada usada por muitos recursos QB. A documenta\u00e7\u00e3o oficial agrupa suas capacidades em torno de fun\u00e7\u00f5es, dados do jogador, dados compartilhados, configura\u00e7\u00e3o e comandos. Um recurso pode solicitar apenas as partes do Objeto Principal de que precisa, mas sua superf\u00edcie de API necess\u00e1ria ainda deve corresponder \u00e0 vers\u00e3o principal no servidor.<\/p>\n<p>Defini\u00e7\u00f5es compartilhadas incluem empregos, gangues, itens e ve\u00edculos representados em tabelas Lua. Fun\u00e7\u00f5es principais cobrem opera\u00e7\u00f5es comuns do framework, enquanto objetos de jogador exp\u00f5em dados de personagem estruturados e fun\u00e7\u00f5es relacionadas ao jogador. Comandos e permiss\u00f5es fazem parte do modelo de framework mais amplo. Estas s\u00e3o capacidades arquitet\u00f4nicas, n\u00e3o provas de que cada servidor ou recurso ter\u00e1 o mesmo desempenho ou comportamento.<\/p>\n<h2>Instale o QBCore com a receita oficial<\/h2>\n<p>O caminho oficial atual do Windows usa a interface txAdmin embutida do FXServer. No deployer de receitas, selecione o modelo popular do Framework QBCore e siga o guia de instala\u00e7\u00e3o atual do QBCore. O reposit\u00f3rio de receitas mostra por que instalar apenas um ZIP \u00e9 incompleto: ele provisiona o banco de dados e faz o download de uma cole\u00e7\u00e3o de recursos em torno de <code>qb-n\u00facleo<\/code>.<\/p>\n<ol>\n<li>Prepare um ambiente de servidor FiveM suportado e uma arte atual do FXServer.<\/li>\n<li>Inicie o txAdmin e crie uma nova implanta\u00e7\u00e3o usando a receita popular oficial QBCore.<\/li>\n<li>Forne\u00e7a a chave do servidor e as configura\u00e7\u00f5es do banco de dados solicitadas no fluxo de configura\u00e7\u00e3o documentado.<\/li>\n<li>Deixe a receita implantar seu SQL e recursos em vez de copiar manualmente apenas <code>qb-n\u00facleo<\/code>.<\/li>\n<li>Revise o <code>servidor.cfg<\/code>, ordem dos recursos e segredos antes de expor o servidor.<\/li>\n<li>Inicie o servidor e verifique a conectividade do banco de dados, a cria\u00e7\u00e3o de personagens, permiss\u00f5es e logs.<\/li>\n<\/ol>\n<p>A conex\u00e3o com o banco de dados pertence \u00e0 configura\u00e7\u00e3o do servidor usada pelo oxmysql. N\u00e3o procure um campo de conex\u00e3o com o banco de dados gen\u00e9rico em <code>qb-core\/config.lua<\/code>; esse arquivo \u00e9 usado para configura\u00e7\u00e3o principal e do jogador.<\/p>\n<h2>Adicione um recurso QBCore com seguran\u00e7a<\/h2>\n<p>Antes de instalar um recurso de trabalho, invent\u00e1rio, alvo, telefone ou interface de usu\u00e1rio, registre a vers\u00e3o exata <code>qb-n\u00facleo<\/code> e de todo sistema relacionado com o qual ele se integrar\u00e1. Em seguida, siga este limite:<\/p>\n<table>\n<thead>\n<tr>\n<th>Verificar<\/th>\n<th>O que verificar<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>API do Framework<\/td>\n<td>Fun\u00e7\u00f5es, exporta\u00e7\u00f5es, eventos e campos de dados do jogador do Core Object obrigat\u00f3rios.<\/td>\n<\/tr>\n<tr>\n<td>Depend\u00eancias<\/td>\n<td>Recursos de invent\u00e1rio, alvo, menu, entrada, banco de dados e utilit\u00e1rios com vers\u00f5es exatas.<\/td>\n<\/tr>\n<tr>\n<td>Dados<\/td>\n<td>Migra\u00e7\u00f5es SQL, suposi\u00e7\u00f5es de tabela, defini\u00e7\u00f5es de item ou trabalho e rollback seguro.<\/td>\n<\/tr>\n<tr>\n<td>Configura\u00e7\u00e3o<\/td>\n<td>Permiss\u00f5es, locais, coordenadas, flags de recurso e segredos exclusivos do servidor.<\/td>\n<\/tr>\n<tr>\n<td>Pedido<\/td>\n<td>As depend\u00eancias come\u00e7am antes do recurso e nenhuma substitui\u00e7\u00e3o duplicada est\u00e1 ativa.<\/td>\n<\/tr>\n<tr>\n<td>Valida\u00e7\u00e3o<\/td>\n<td>Fun\u00e7\u00f5es permitidas e negadas, reconex\u00f5es, rein\u00edcios, logs do cliente e logs do servidor.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Um r\u00f3tulo de produto que diz QBCore \u00e9 apenas o primeiro sinal de compatibilidade. Se o servidor substituir a camada de invent\u00e1rio, alvo ou menu da receita, um script pode exigir um adaptador ou altera\u00e7\u00e3o de configura\u00e7\u00e3o documentada. Aplique as altera\u00e7\u00f5es no banco de dados em uma c\u00f3pia de teste primeiro e mantenha um rollback que cubra tanto os arquivos quanto os dados.<\/p>\n<h2>Para quem o QBCore se encaixa<\/h2>\n<p>QBCore \u00e9 um candidato razo\u00e1vel para um novo servidor cujos recursos necess\u00e1rios suportam explicitamente o ecossistema QB atual, ou um servidor QB existente que j\u00e1 usa seu Core Object e modelo de dados. A escolha se torna mais cara quando uma equipe possui um grande conjunto de dados ESX, scripts espec\u00edficos do framework ou eventos personalizados n\u00e3o documentados. Nesse caso, inventarie a superf\u00edcie de migra\u00e7\u00e3o antes de selecionar um novo framework.<\/p>\n<p>Qbox come\u00e7ou a partir do c\u00f3digo base do QBCore e fornece uma ponte de compatibilidade para muitos recursos QB bem escritos, mas a documenta\u00e7\u00e3o oficial do Qbox lista exce\u00e7\u00f5es. N\u00e3o assuma que todo script QBCore \u00e9 um script Qbox pronto para uso. Da mesma forma, n\u00e3o migre do ESX para o QBCore com base em uma afirma\u00e7\u00e3o de desempenho ampla. Compare a cobertura de recursos, o conhecimento da equipe, a convers\u00e3o de dados e o plano de teste.<\/p>\n<h2>QBCore, Qbox ou ESX<\/h2>\n<ul>\n<li><strong>Mantenha o QBCore<\/strong> quando seus recursos atuais e equipe j\u00e1 dependem de APIs QBCore documentadas e o caminho de atualiza\u00e7\u00e3o \u00e9 compreendido.<\/li>\n<li><strong>Considere o Qbox<\/strong> quando voc\u00ea deliberadamente deseja suas APIs e receita atuais e pode auditar exce\u00e7\u00f5es de ponte recurso por recurso.<\/li>\n<li><strong>Mantenha o ESX<\/strong> quando seus dados de produ\u00e7\u00e3o, integra\u00e7\u00f5es e conhecimento operacional s\u00e3o espec\u00edficos do ESX e n\u00e3o h\u00e1 motivo testado para migrar.<\/li>\n<\/ul>\n<p>Use o comparativo de frameworks para um m\u00e9todo de decis\u00e3o neutro. Ao selecionar do cat\u00e1logo de scripts <a href=\"\/pt\/fivem-scripts\/\">pagos FiveM<\/a>, comece com <a href=\"\/pt\/scripts-qbcore\/\">Scripts QBCore<\/a>, confirme os requisitos na p\u00e1gina exata do produto e teste o recurso contra um banco de dados representativo antes da produ\u00e7\u00e3o.<\/p>\n<h2>Pr\u00f3ximos passos seguros<\/h2>\n<ol>\n<li>Leia o guia de instala\u00e7\u00e3o do Windows QBCore atual e a receita oficial antes de criar o servidor.<\/li>\n<li>Registre as vers\u00f5es do n\u00facleo implantado e das depend\u00eancias ap\u00f3s a conclus\u00e3o da receita.<\/li>\n<li>Escolha um recurso de cada vez, leia suas notas de instala\u00e7\u00e3o oficiais e teste suas permiss\u00f5es e caminhos de falha.<\/li>\n<li>Mantenha backups do banco de dados e dos recursos juntos para que um rollback restaure um estado consistente.<\/li>\n<\/ol>\n<p><!-- fivemx-blog-content-links:2026-07-23:qbcore --><\/p>\n<section class=\"fivemx-content-links\" aria-labelledby=\"fivemx-qbcore-compare\">\n<h2 id=\"fivemx-qbcore-compare\">Compare QBCore antes de confirmar<\/h2>\n<p>Use o <a href=\"https:\/\/fivemx.com\/pt\/estruturas-fivem\/\">Compara\u00e7\u00e3o entre ESX, QBCore e Qbox<\/a> para a decis\u00e3o mais ampla, em seguida, revise a <a href=\"https:\/\/fivemx.com\/pt\/pilha-qbox-ox\/\">migra\u00e7\u00e3o e fronteira de compatibilidade do Qbox<\/a> se uma pilha orientada para Ox estiver em considera\u00e7\u00e3o.<\/p>\n<\/section>","protected":false},"excerpt":{"rendered":"<p>Entenda o que o QBCore oferece, instale o stack completo atrav\u00e9s da receita oficial do txAdmin e avalie os recursos em rela\u00e7\u00e3o \u00e0 vers\u00e3o exata do seu servidor.<\/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:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/posts\/147431","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=147431"}],"version-history":[{"count":7,"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/posts\/147431\/revisions"}],"predecessor-version":[{"id":215650,"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/posts\/147431\/revisions\/215650"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/media\/152045"}],"wp:attachment":[{"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/media?parent=147431"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/categories?post=147431"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/tags?post=147431"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}