QBCore é um framework de roleplay de código aberto para FiveM. Seu qb-núcleo 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-núcleo pasta como uma instalação completa.
Principais conclusões
qb-núcleoé o recurso principal, não um servidor de roleplay completo por si só.- O guia oficial do Windows implanta o modelo popular do Framework QBCore através 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 um vencedor universal de desempenho; profile a pilha completa que você planeja executar.
O que o QBCore oferece
O Objeto Principal QBCore é a interface compartilhada usada por muitos recursos QB. A documentação oficial agrupa suas capacidades em torno de funções, dados do jogador, dados compartilhados, configuração e comandos. Um recurso pode solicitar apenas as partes do Objeto Principal de que precisa, mas sua superfície de API necessária ainda deve corresponder à versão principal no servidor.
Definições compartilhadas incluem empregos, gangues, itens e veículos representados em tabelas Lua. Funções principais cobrem operações comuns do framework, enquanto objetos de jogador expõem dados de personagem estruturados e funções relacionadas ao jogador. Comandos e permissões fazem parte do modelo de framework mais amplo. Estas são capacidades arquitetônicas, não provas de que cada servidor ou recurso terá o mesmo desempenho ou comportamento.
Instale o QBCore com a receita oficial
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ção atual do QBCore. O repositório de receitas mostra por que instalar apenas um ZIP é incompleto: ele provisiona o banco de dados e faz o download de uma coleção de recursos em torno de qb-núcleo.
- Prepare um ambiente de servidor FiveM suportado e uma arte atual do FXServer.
- Inicie o txAdmin e crie uma nova implantação usando a receita popular oficial QBCore.
- Forneça a chave do servidor e as configurações do banco de dados solicitadas no fluxo de configuração documentado.
- Deixe a receita implantar seu SQL e recursos em vez de copiar manualmente apenas
qb-núcleo. - Revise o
servidor.cfg, ordem dos recursos e segredos antes de expor o servidor. - Inicie o servidor e verifique a conectividade do banco de dados, a criação de personagens, permissões e logs.
A conexão com o banco de dados pertence à configuração do servidor usada pelo oxmysql. Não procure um campo de conexão com o banco de dados genérico em qb-core/config.lua; esse arquivo é usado para configuração principal e do jogador.
Adicione um recurso QBCore com segurança
Antes de instalar um recurso de trabalho, inventário, alvo, telefone ou interface de usuário, registre a versão exata qb-núcleo e de todo sistema relacionado com o qual ele se integrará. Em seguida, siga este limite:
| Verificar | O que verificar |
|---|---|
| API do Framework | Funções, exportações, eventos e campos de dados do jogador do Core Object obrigatórios. |
| Dependências | Recursos de inventário, alvo, menu, entrada, banco de dados e utilitários com versões exatas. |
| Dados | Migrações SQL, suposições de tabela, definições de item ou trabalho e rollback seguro. |
| Configuração | Permissões, locais, coordenadas, flags de recurso e segredos exclusivos do servidor. |
| Pedido | As dependências começam antes do recurso e nenhuma substituição duplicada está ativa. |
| Validação | Funções permitidas e negadas, 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, alvo ou menu da receita, um script pode exigir um adaptador ou alteração de configuração documentada. Aplique as alterações no banco de dados em uma cópia de teste primeiro e mantenha um rollback que cubra tanto os arquivos quanto os dados.
Para quem o QBCore se encaixa
QBCore é um candidato razoável para um novo servidor cujos recursos necessários suportam explicitamente o ecossistema QB atual, ou um servidor QB existente que já 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íficos do framework ou eventos personalizados não documentados. Nesse caso, inventarie a superfície de migração antes de selecionar um novo framework.
Qbox começou a partir do código base do QBCore e fornece uma ponte de compatibilidade para muitos recursos QB bem escritos, mas a documentação oficial do Qbox lista exceções. Não assuma que todo script QBCore é um script Qbox pronto para uso. Da mesma forma, não migre do ESX para o QBCore com base em uma afirmação de desempenho ampla. Compare a cobertura de recursos, o conhecimento da equipe, a conversão de dados e o plano de teste.
QBCore, Qbox ou ESX
- Mantenha o QBCore quando seus recursos atuais e equipe já dependem de APIs QBCore documentadas e o caminho de atualização é compreendido.
- Considere o Qbox quando você deliberadamente deseja suas APIs e receita atuais e pode auditar exceções de ponte recurso por recurso.
- Mantenha 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 do catálogo de scripts pagos FiveM, comece com Scripts QBCore, confirme os requisitos na página exata do produto e teste o recurso contra um banco de dados representativo antes da produção.
Próximos passos seguros
- Leia o guia de instalação do Windows QBCore atual e a receita oficial antes de criar o servidor.
- Registre as versões do núcleo implantado e das dependências após a conclusão da receita.
- Escolha um recurso de cada vez, leia suas notas de instalação oficiais e teste suas permissões e caminhos de falha.
- Mantenha backups do banco de dados e dos recursos juntos para que um rollback restaure um estado consistente.
Compare QBCore antes de confirmar
Use o Comparação entre ESX, QBCore e Qbox para a decisão mais ampla, em seguida, revise a migração e fronteira de compatibilidade do Qbox se uma pilha orientada para Ox estiver em consideração.
