Guia do Framework QBCore: Arquitetura, Instalação e Compatibilidade

O QBCore é um framework de roleplay de código aberto para FiveM. Seu qb-core recurso expõe dados de jogadores compartilhados, funções do framework, comandos e definições que outros recursos QB podem usar. Para um servidor novo, use a receita oficial QBCore txAdmin em vez de tratar a qb-core pasta como uma instalação completa.

Principais conclusões

• qb-core é o recurso principal, não um servidor de roleplay completo por si só.
• O guia oficial para Windows implanta o modelo popular QBCore Framework por meio do txAdmin.
• A receita oficial inclui a configuração do banco de dados e um conjunto mais amplo de recursos QB.
• A compatibilidade depende das versões exatas, dependências, exports, SQL e ordem dos recursos.
• Nenhuma fonte oficial estabelece o QBCore como vencedor universal em desempenho; faça o profiling da pilha completa que você planeja executar.

O que o QBCore oferece

O Core Object do QBCore é a interface compartilhada usada por muitos recursos QB. A documentação oficial agrupa suas capacidades em funções, dados do jogador, dados compartilhados, configuração e comandos. Um recurso pode solicitar apenas as partes do Core Object de que precisa, mas a superfície de API que ele exige ainda precisa corresponder à versão do core no servidor.

As definições compartilhadas incluem empregos, gangues, itens e veículos representados em tabelas Lua. As funções do core cobrem operações comuns do framework, enquanto os objetos de jogador expõem dados estruturados do personagem e funções relacionadas ao jogador. Comandos e permissões fazem parte do modelo mais amplo do framework. Essas são capacidades arquiteturais, não uma prova de que todo servidor ou recurso terá o mesmo desempenho ou comportamento.

Instale o QBCore com a receita oficial

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ção atual do QBCore. O repositório da receita mostra por que instalar apenas um ZIP é incompleto: ele provisiona o banco de dados e baixa uma coleção de recursos em torno do qb-core.

1. Prepare um ambiente de servidor FiveM suportado e um artefato atual do FXServer.
2. Inicie o txAdmin e crie uma nova implantação usando a receita popular oficial do QBCore.
3. Forneça a chave do servidor e as configurações do banco de dados solicitadas no fluxo de configuração documentado.
4. Deixe a receita implantar seu SQL e seus recursos em vez de copiar manualmente apenas o qb-core.
5. Revise o server.cfg, ordem dos recursos e segredos antes de expor o servidor.
6. Inicie o servidor e verifique a conectividade do banco de dados, a criação de personagens, as permissões e os logs.

A conexão com o banco de dados pertence à configuração do servidor usada pelo oxmysql. Não procure um campo genérico de conexão com o banco de dados em qb-core/config.lua; esse arquivo é usado para a configuração do core e do jogador.

Adicione um recurso QBCore com segurança

Antes de instalar um recurso de emprego, inventário, target, telefone ou interface de usuário, registre a versão exata do qb-core e de todo sistema relacionado com o qual ele vai se integrar. Em seguida, percorra este limite:

Verificação	O que verificar
API do Framework	Funções, exports, eventos e campos de dados do jogador do Core Object exigidos.
Dependências	Recursos de inventário, target, menu, input, banco de dados e utilitários com versões exatas.
Dados	Migrações SQL, premissas de tabelas, definições de itens ou empregos e rollback seguro.
Configuração	Permissões, locales, coordenadas, flags de recurso e segredos exclusivos do servidor.
Ordem	As dependências iniciam antes do recurso e nenhuma substituição duplicada está ativa.
Validação	Cargos permitidos e negados, reconexões, reinícios, logs do cliente e logs do servidor.

Um rótulo de produto que diz QBCore é apenas o primeiro sinal de compatibilidade. Se o servidor substituir a camada de inventário, target ou menu da receita, um script pode exigir um adaptador documentado ou uma alteração de configuração. Aplique as alterações de banco de dados primeiro em uma cópia de teste e mantenha um rollback que cubra tanto arquivos quanto dados.

Para quem o QBCore é indicado

O QBCore é um candidato razoável para um novo servidor cujos recursos necessários suportem explicitamente o ecossistema QB atual, ou para um servidor QB existente que já 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íficos de framework ou eventos personalizados não documentados. Nesse caso, faça um inventário da superfície de migração antes de escolher um novo framework.

O Qbox surgiu a partir do código-base do QBCore e oferece uma ponte de compatibilidade para muitos recursos QB escritos corretamente, mas a documentação oficial do Qbox lista exceções. Não presuma que todo script QBCore seja um script Qbox pronto para uso. Da mesma forma, não migre do ESX para o QBCore com base em uma alegação genérica de desempenho. Compare a cobertura de recursos, o conhecimento da equipe, a conversão de dados e o plano de testes.

QBCore, Qbox ou ESX

• Fique com o QBCore quando seus recursos atuais e sua equipe já dependem de APIs QBCore documentadas e o caminho de atualização é compreendido.
• Considere o Qbox quando você deliberadamente quer suas APIs e receita atuais e pode auditar as exceções da ponte recurso por recurso.
• Fique com o ESX quando seus dados de produção, integrações e conhecimento operacional são específicos do ESX e não há motivo testado para migrar.

Use o comparativo de frameworks para um método de decisão neutro. Ao selecionar no catálogo de scripts pagos de FiveM, comece com QBCore Scripts, confirme os requisitos na página exata do produto e teste o recurso em um banco de dados representativo antes da produção.

Use a receita oficial do QBCore como limite de instalação

Comece com a receita receita txAdmin do QBCore atualmente mantida e o guia de instalação. Uma receita provisiona uma base; ela não prova que um script de terceiros mais antigo suporta as versões instaladas do framework, do banco de dados, do inventário ou do target. Registre o commit da receita e verifique cada recurso adicionado em ambiente de staging antes da produção.