{"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-09T14:39:21","modified_gmt":"2026-08-09T12:39:21","slug":"qbcore","status":"publish","type":"post","link":"https:\/\/rpcrate.com\/pt\/qbcore\/","title":{"rendered":"Guia do Framework QBCore: Arquitetura, Instala\u00e7\u00e3o e Compatibilidade"},"content":{"rendered":"<p class=\"translation-block\"><strong>O QBCore \u00e9 um framework de roleplay de c\u00f3digo aberto para FiveM.<\/strong> Seu recurso <code>qb-core<\/code> disponibiliza dados compartilhados de jogadores, fun\u00e7\u00f5es do framework, comandos e defini\u00e7\u00f5es que outros recursos QB podem usar. Para um servidor novo, use a receita oficial do QBCore para txAdmin em vez de tratar a pasta <code>qb-core<\/code> como uma instala\u00e7\u00e3o completa.<\/p>\n<h2 id=\"key-takeaways\">Principais conclus\u00f5es<\/h2>\n<ul>\n<li><code data-no-translation=\"\" translate=\"no\">qb-core<\/code> \u00e9 o recurso principal, n\u00e3o um servidor de roleplay completo por si s\u00f3.<\/li>\n<li>O guia oficial para Windows implanta o modelo popular QBCore Framework por meio 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 vencedor universal em desempenho; fa\u00e7a o profiling da pilha completa que voc\u00ea planeja executar.<\/li>\n<\/ul>\n<h2 id=\"what-qbcore-provides\">O que o QBCore oferece<\/h2>\n<p>O Core Object do QBCore \u00e9 a interface compartilhada usada por muitos recursos QB. A documenta\u00e7\u00e3o oficial agrupa suas capacidades em fun\u00e7\u00f5es, dados do jogador, dados compartilhados, configura\u00e7\u00e3o e comandos. Um recurso pode solicitar apenas as partes do Core Object de que precisa, mas a superf\u00edcie de API que ele exige ainda precisa corresponder \u00e0 vers\u00e3o do core no servidor.<\/p>\n<p>As defini\u00e7\u00f5es compartilhadas incluem empregos, gangues, itens e ve\u00edculos representados em tabelas Lua. As fun\u00e7\u00f5es do core cobrem opera\u00e7\u00f5es comuns do framework, enquanto os objetos de jogador exp\u00f5em dados estruturados do personagem e fun\u00e7\u00f5es relacionadas ao jogador. Comandos e permiss\u00f5es fazem parte do modelo mais amplo do framework. Essas s\u00e3o capacidades arquiteturais, n\u00e3o uma prova de que todo servidor ou recurso ter\u00e1 o mesmo desempenho ou comportamento.<\/p>\n<h2 id=\"install-qbcore-with-the-official-recipe\">Instale o QBCore com a receita oficial<\/h2>\n<p>O caminho oficial atual no Windows usa a interface txAdmin integrada ao FXServer. No implantador de receitas, selecione o modelo popular QBCore Framework e siga o guia de instala\u00e7\u00e3o atual do QBCore. O reposit\u00f3rio da receita mostra por que instalar apenas um ZIP \u00e9 incompleto: ele provisiona o banco de dados e baixa uma cole\u00e7\u00e3o de recursos em torno do <code data-no-translation=\"\" translate=\"no\">qb-core<\/code>.<\/p>\n<ol>\n<li>Prepare um ambiente de servidor FiveM suportado e um artefato atual do FXServer.<\/li>\n<li>Inicie o txAdmin e crie uma nova implanta\u00e7\u00e3o usando a receita popular oficial do 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 seus recursos em vez de copiar manualmente apenas o <code data-no-translation=\"\" translate=\"no\">qb-core<\/code>.<\/li>\n<li class=\"translation-block\">Revise o arquivo <code>server.cfg<\/code> gerado, a ordem dos recursos e os 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, as permiss\u00f5es e os 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 gen\u00e9rico de conex\u00e3o com o banco de dados em <code data-no-translation=\"\" translate=\"no\">qb-core\/config.lua<\/code>; esse arquivo \u00e9 usado para a configura\u00e7\u00e3o do core e do jogador.<\/p>\n<h2 id=\"add-a-qbcore-resource-safely\">Adicione um recurso QBCore com seguran\u00e7a<\/h2>\n<p>Antes de instalar um recurso de emprego, invent\u00e1rio, target, telefone ou interface de usu\u00e1rio, registre a vers\u00e3o exata do <code data-no-translation=\"\" translate=\"no\">qb-core<\/code> e de todo sistema relacionado com o qual ele vai se integrar. Em seguida, percorra este limite:<\/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>Verifica\u00e7\u00e3o<\/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, exports, eventos e campos de dados do jogador do Core Object exigidos.<\/td>\n<\/tr>\n<tr>\n<td>Depend\u00eancias<\/td>\n<td>Recursos de invent\u00e1rio, target, menu, input, 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, premissas de tabelas, defini\u00e7\u00f5es de itens ou empregos e rollback seguro.<\/td>\n<\/tr>\n<tr>\n<td>Configura\u00e7\u00e3o<\/td>\n<td>Permiss\u00f5es, locales, coordenadas, flags de recurso e segredos exclusivos do servidor.<\/td>\n<\/tr>\n<tr>\n<td>Ordem<\/td>\n<td>As depend\u00eancias iniciam 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>Cargos permitidos e negados, reconex\u00f5es, rein\u00edcios, logs do cliente e logs do servidor.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\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, target ou menu da receita, um script pode exigir um adaptador documentado ou uma altera\u00e7\u00e3o de configura\u00e7\u00e3o. Aplique as altera\u00e7\u00f5es de banco de dados primeiro em uma c\u00f3pia de teste e mantenha um rollback que cubra tanto arquivos quanto dados.<\/p>\n<h2 id=\"who-qbcore-fits\">Para quem o QBCore \u00e9 indicado<\/h2>\n<p>O QBCore \u00e9 um candidato razo\u00e1vel para um novo servidor cujos recursos necess\u00e1rios suportem explicitamente o ecossistema QB atual, ou para um servidor QB existente que j\u00e1 use seu Core Object e modelo de dados. A escolha se torna mais custosa quando a equipe tem um grande conjunto de dados ESX, scripts espec\u00edficos de framework ou eventos personalizados n\u00e3o documentados. Nesse caso, fa\u00e7a um invent\u00e1rio da superf\u00edcie de migra\u00e7\u00e3o antes de escolher um novo framework.<\/p>\n<p>O Qbox surgiu a partir do c\u00f3digo-base do QBCore e oferece uma ponte de compatibilidade para muitos recursos QB escritos corretamente, mas a documenta\u00e7\u00e3o oficial do Qbox lista exce\u00e7\u00f5es. N\u00e3o presuma que todo script QBCore seja um script Qbox pronto para uso. Da mesma forma, n\u00e3o migre do ESX para o QBCore com base em uma alega\u00e7\u00e3o gen\u00e9rica de desempenho. Compare a cobertura de recursos, o conhecimento da equipe, a convers\u00e3o de dados e o plano de testes.<\/p>\n<h2 id=\"qbcore-qbox-or-esx\">QBCore, Qbox ou ESX<\/h2>\n<ul>\n<li><strong>Fique com o QBCore<\/strong> quando seus recursos atuais e sua 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 quer suas APIs e receita atuais e pode auditar as exce\u00e7\u00f5es da ponte recurso por recurso.<\/li>\n<li><strong>Fique com 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 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-qbcore\/\">QBCore Scripts<\/a>, confirme os requisitos na p\u00e1gina exata do produto e teste o recurso em um banco de dados representativo antes da produ\u00e7\u00e3o.<\/p>\n<h2 id=\"use-the-official-qbcore-recipe-as-the-installation-boundary\">Use a receita oficial do QBCore como limite de instala\u00e7\u00e3o<\/h2>\n<p class=\"translation-block\">Comece pela <a href=\"https:\/\/github.com\/qbcore-fivem\/txAdminRecipe\" rel=\"nofollow noopener\">receita do QBCore para txAdmin atualmente mantida<\/a> e pelo <a href=\"https:\/\/qbcore.org\/docs\/guides\/windows-installation\" rel=\"nofollow noopener\">guia oficial de instala\u00e7\u00e3o<\/a>. Uma receita fornece uma base; ela n\u00e3o comprova que um script antigo de terceiros \u00e9 compat\u00edvel com as vers\u00f5es instaladas do framework, banco de dados, invent\u00e1rio ou sistema de intera\u00e7\u00e3o. Registre o commit da receita e verifique cada recurso adicionado em homologa\u00e7\u00e3o antes da produ\u00e7\u00e3o.<\/p>","protected":false},"excerpt":{"rendered":"<p class=\"translation-block\"><strong>O QBCore \u00e9 um framework de roleplay de c\u00f3digo aberto para FiveM.<\/strong> Seu recurso <code>qb-core<\/code> disponibiliza dados compartilhados de jogadores, fun\u00e7\u00f5es do framework, comandos e defini\u00e7\u00f5es que outros recursos QB podem usar. Para um servidor novo, use a receita oficial do QBCore para txAdmin em vez de tratar a pasta <code>qb-core<\/code> como uma instala\u00e7\u00e3o completa.<\/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:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/posts\/147431","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=147431"}],"version-history":[{"count":7,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/posts\/147431\/revisions"}],"predecessor-version":[{"id":215650,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/posts\/147431\/revisions\/215650"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/media\/152045"}],"wp:attachment":[{"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/media?parent=147431"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/categories?post=147431"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/tags?post=147431"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}