Qbox é um framework de roleplay FiveM que começou como um fork QBCore e agora fornece suas próprias APIs e recursos principais. Ele mantém 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ão suportados são exceções documentadas. Use a receita oficial Qbox txAdmin para uma nova instalação e audite cada recurso antes de uma migração.
Principais conclusões
- Qbox é um framework, não apenas um pacote de utilitários Ox ou uma pasta QBCore renomeada.
- O caminho de instalação oficial atual é a receita QBox mais popular no txAdmin.
- A ponte QB pode ajudar com recursos compatíveis, mas não é uma garantia para cada script QBCore.
- A migração inclui configuração, grades, inventário e conversão de banco de dados, além de testes por recurso.
- Não há um ranking de desempenho universal com suporte de origem entre Qbox, QBCore e ESX.
O que é Qbox
O registro oficial de introdução Qbox registra a criação do projeto em 27 de setembro de 2022 e descreve sua origem no QBCore. O projeto desde então desenvolveu seu próprio núcleo 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óprio framework e receita.
O atual qbx_núcleo manifest declara diretamente boi_lib e oxmysql dependências. A receita oficial reúne Qbox e recursos de terceiros selecionados em um stack de partida completo. Como o conteúdo da receita pode mudar, link para a receita atual em vez de congelar uma longa lista de dependências em um tutorial de instalação evergreen.
Instale Qbox através da receita oficial
- Prepare um ambiente FXServer suportado e abra sua configuração txAdmin embutida.
- Atenda aos requisitos de banco de dados listados na documentação de instalação atual Qbox.
- Selecione a receita oficial QBox popular em vez de montar um núcleo parcial manualmente.
- Complete as variáveis da receita, configuração do banco de dados e configuração do servidor usando a documentação atual.
- Revise a lista de recursos gerada e a ordem de inicialização antes da primeira inicialização pública.
- Verifique o carregamento de jogadores, criação de personagens, permissões, persistência e logs em um servidor de teste.
Não substitua os manifests do fornecedor por exemplos encurtados copiados de um guia. Instale as versões oficiais ou da receita e trate seus manifests como parte do contrato de dependência. Quando uma atualização altera um requisito de núcleo ou biblioteca, compare a documentação da versão contra cada recurso dependente antes do implantação.
Qbox e a ponte QBCore
O guia de conversão oficial Qbox explica como a ponte QB suporta a compatibilidade enquanto as APIs são substituídas gradualmente. O FAQ Qbox afirma que a maioria dos scripts QBCore bem escritos pode funcionar através dessa ponte, e depois identifica exceções importantes: recursos que acessam diretamente tabelas de banco de dados, leem ou modificam arquivos internos do núcleo ou dependem de comportamentos não suportados podem precisar de alterações.
| Comportamento do recurso | Expectativa de migração |
|---|---|
| Usa APIs QB documentadas cobertas pela ponte | Candidato para teste de ponte; a compatibilidade ainda precisa ser verificada. |
| Lê tabelas de framework diretamente | Audite consultas e suposições de esquema antes de tocar em dados ao vivo. |
| Carrega arquivos internos do núcleo | Refatore para exportações ou módulos suportados onde documentado. |
| Assume trabalho de texto ou notas de gangues | Reveja os requisitos de conversão de notas numéricas do Qbox. |
| Possui dados de inventário ou de personagem | Use o caminho de conversão documentado e valide cada relação. |
Um produto marcado como compatível 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ário e alvo ele espera, e se seu SQL assume um esquema QB que o Qbox não expõe da mesma maneira.
Checklist de migração para um servidor QBCore existente
- Congelar e inventariar: registre núcleo, banco de dados, inventário, trabalhos, gangues, veículos, moradias, telefones, permissões e recursos personalizados.
- Faça backup: crie snapshots restauráveis do banco de dados e recursos antes do trabalho de conversão.
- Reveja a configuração: Qbox documenta alterações nos arquivos de configuração e acesso à API; não copie os internos antigos do núcleo de forma cega.
- Converta notas e dados: siga os passos oficiais atuais para notas numéricas de trabalho e gangues, conversão de inventário e banco de dados.
- Audite recursos: classifique cada integração como coberta pela ponte, adaptável ou incompatível.
- Teste em etapas: valide personagens, dinheiro, trabalhos, gangues, inventário, veículos, permissões e comportamento de reconexão.
- Inspecione evidências: reveja logs do servidor, cliente e banco de dados e compare contagens de registros-chave antes da mudança.
- Mantenha o rollback disponível: não mutar o único banco de dados de produção com um snippet de conversão genérico.
Escolha Qbox por razões explícitas
Qbox se encaixa em um novo servidor que deliberadamente deseja a receita atual Qbox e APIs. Também pode se encaixar em uma equipe QBCore preparada para auditar a compatibilidade da ponte e completar o trabalho de conversão documentado. É um alvo de migração pobre quando recursos críticos dependem de internos principais não documentados e a equipe não pode substituí-los ou adaptá-los com segurança.
Não escolha Qbox porque uma página promete que um inventário, biblioteca de banco de dados ou framework é automaticamente mais rápido. O desempenho depende do conjunto completo de recursos, carga de trabalho do banco de dados, comportamento do jogador, artefato e configuração do servidor. Se o desempenho for um fator de decisão, faça benchmark de ações representativas em ambientes equivalentes e mantenha os logs.
Validação de produção
Teste ações bem-sucedidas e negadas, não apenas o caminho feliz. Confirme que as alterações de dinheiro acontecem uma vez, as permissões de emprego e gangue rejeitam jogadores não autorizados, o inventário permanece consistente em reconexões, os veículos adquiridos persistem e as ações administrativas são registradas. Os pedidos do cliente devem ser validados no servidor; um evento acionado pelo cliente não é seguro apenas porque o UI o esconde de jogadores normais.
Use the framework comparison for the wider ESX/QBCore/Qbox decision. When selecting from the pagos FiveM, comece com Scripts QBOX and verify the current framework, bridge, inventory and dependency requirements on the product page before purchase.
Coloque Qbox no quadro de decisão
Compare a receita atual Qbox com a dedicada Guia de arquitetura QBCore e o completo Guia de decisão para ESX, QBCore e Qbox antes de converter os dados de produção.
