Qbox vs QBCore: Diferenças, Compatibilidade e Migração

Escolha Qbox para um novo servidor quando você quiser seu stack moderno, integrado ao OX, e estiver preparado para seguir suas convenções. Mantenha QBCore quando seu servidor estável depende de recursos específicos do QBCore e uma migração não tem retorno claro. Qbox fornece uma ponte de compatibilidade para a maioria dos scripts QBCore bem escritos, mas a compatibilidade não é universal.

Vai montar seu primeiro servidor? Siga nosso guia passo a passo sobre como criar um servidor FiveM.

Qbox vs QBCore em um relance

Pergunta	Qbox	QBCore
Origem	Começou como um fork do QBCore e agora segue sua própria arquitetura	Framework e ecossistema de roleplay FiveM estabelecidos
Scripts QB existentes	A maioria dos scripts documentados e bem escritos funciona através da ponte	Alvo nativo para recursos QBCore
Integração OX	Projetado em torno de integrações como ox_lib e ox_inventory	Depende da stack escolhida para o servidor e das adaptações dos recursos
Acesso ao core	Usa exports e módulos importados; nenhum objeto principal nativo do Qbox	Muitos recursos usam o familiar objeto principal do QBCore
Risco de migração	Requer auditoria de acesso ao banco de dados, acesso a arquivos principais e recursos personalizados	Nenhuma migração de framework se o servidor já estiver estável

O que é Qbox?

Qbox é um framework de roleplay FiveM criado em 2022. Começou como um fork do QBCore, mantém compatibilidade retroativa para quase todos os scripts QBCore implementados corretamente e usa cada vez mais seus próprios exports, módulos e integrações baseadas em OX. A própria documentação do Qbox recomenda recursos lançados e adverte contra acesso não suportado a tabelas ou arquivos de banco de dados de propriedade do core.

O que é QBCore?

QBCore é um framework de roleplay maduro com um grande catálogo de empregos, inventários, ferramentas de administração e scripts personalizados. Sua principal vantagem para um servidor existente é a previsibilidade: se seus recursos forem testados contra sua versão atual do QBCore, ficar evita o custo e o risco de uma migração de framework.

Os scripts QBCore funcionarão no Qbox?

A maioria sim, mas não todos. O Qbox fornece uma ponte QB para recursos que usam corretamente os exports e eventos documentados do QBCore. Os scripts têm maior probabilidade de falhar quando:

• leem ou modificam diretamente tabelas de banco de dados controladas pelo QBCore;
• abrem ou modificam arquivos internos do core;
• dependem de funções não documentadas ou usam eventos incorretamente;
• substituem dados integrados de múltiplos empregos ou gangues por tabelas incompatíveis;
• presumem que existe um objeto core do Qbox em vez de usar exports e módulos compatíveis.

Quando o Qbox é a melhor escolha

• Você está criando um novo servidor e quer uma base voltada para Qbox/OX.
• Seus scripts essenciais usam APIs documentadas ou já declaram suporte ao Qbox.
• Você quer migrar o código personalizado para exports e módulos em vez de editar o core.
• Você pode testar a migração do banco de dados e dos personagens em uma cópia completa de homologação.

Quando o QBCore é a melhor escolha

• Seu servidor em produção está estável e a migração não resolveria um problema medido.
• Um recurso essencial depende diretamente dos componentes internos do QBCore.
• Você não tem um backup completo do banco de dados nem um ambiente de homologação.
• Sua equipe já mantém um processo testado de implantação e atualização do QBCore.

Migração segura do QBCore para o Qbox

1. Faça um inventário de todos os recursos. Registre a versão, as tabelas de banco de dados, as chamadas ao framework e o estado do suporte.
2. Faça backup dos arquivos e do banco de dados. Comprove que o backup pode ser restaurado antes de modificar a produção.
3. Instale o Qbox com a receita recomendada. Comece pelos arquivos de configuração atuais em vez de misturar arquivos antigos do core com a nova stack.
4. Revise os empregos e as gangues. O Qbox usa níveis numéricos para empregos e gangues, e sua documentação de migração destaca as alterações necessárias nos arquivos compartilhados e na collation.
5. Configure e converta o banco de dados do inventário. Siga a documentação exata do inventário e trabalhe em uma cópia.
6. Teste os scripts por categoria. Comece por identidade, personagens, empregos, dinheiro e inventário, depois passe para veículos, moradias, telefones e ferramentas administrativas.
7. Substitua gradualmente os componentes internos sem suporte. O Qbox permite converter parcialmente chamadas do QBCore em exports e módulos do Qbox.
8. Faça a transição somente depois que os testes de equivalência passarem. Mantenha um plano de reversão com prazos definidos e o backup intacto de antes da migração.

Decisão

Para um novo projeto, o Qbox é uma boa opção padrão quando a equipe quer sua arquitetura e seu conjunto de recursos compatíveis. Para um servidor QBCore lucrativo ou muito personalizado, não migre por moda: mude somente quando uma auditoria em homologação comprovar que o benefício supera os riscos de compatibilidade e para os dados.

Referências oficiais

• Introdução ao Qbox
• Perguntas frequentes sobre compatibilidade do Qbox
• Guia oficial de conversão do QBCore para o Qbox
• Repositório do core do QBCore

A indicação QBCore garante compatibilidade com Qbox?

Não. Qbox documenta uma ponte de compatibilidade, mas scripts que acessam partes internas do framework podem precisar de alterações. Confira a versão exata do recurso, o acesso ao banco e as integrações de inventário e voz antes de comprar. A categoria QBCore, sozinha, não é um teste de compatibilidade com Qbox.

Documentação de compatibilidade do Qbox

Ver os requisitos do pacote FiveM Baby Script

Como Migrar um Servidor ESX para QBCore