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.

Qbox vs QBCore em um relance
| Pergunta | Qbox | qbNúcleo |
|---|---|---|
| Origem | Começou como um fork do QBCore e agora segue sua própria arquitetura | Estabeleceu o framework e ecossistema de roleplay FiveM |
| 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 do stack do servidor escolhido e das portas de recursos |
| Acesso principal | 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. Ele começou como um fork do QBCore, mantém compatibilidade com versões anteriores 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 de banco de dados ou arquivos de propriedade do núcleo.
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. Qbox fornece uma ponte QB para recursos que usam exports e eventos QBCore documentados corretamente. Scripts têm mais chances de falhar quando:
- leem ou modificam tabelas de banco de dados de propriedade do QBCore diretamente;
- abrem ou corrigem arquivos internos do núcleo;
- depender de funções não documentadas ou uso de eventos inválidos;
- substituir dados multijob ou multigang embutidos por tabelas incompatíveis;
- assumir que um objeto principal Qbox existe em vez de usar exportações e módulos suportados.
Qbox descreve sua compatibilidade como 99% para scripts QB existentes, mas isso não é um substituto para testar seus recursos pagos e personalizados exatos.
Quando Qbox é a melhor escolha
- Você está construindo um novo servidor e deseja uma base orientada para Qbox/OX.
- Seus scripts críticos usam APIs documentadas ou já declaram suporte a Qbox.
- Você deseja mover o código personalizado em direção a exportações e módulos em vez de editar o núcleo.
- Você pode testar a migração de banco de dados e personagens em uma cópia completa de estágio.
Explorar Scripts Qbox e nossa visão geral do pilha Qbox OX.
Quando QBCore é a melhor escolha
- Seu servidor ao vivo está estável e a migração não resolveria um problema medido.
- Um recurso crítico depende diretamente dos internos do QBCore.
- Você não possui um backup completo do banco de dados e um ambiente de estágio.
- Sua equipe já mantém um processo de implantação e atualização QBCore testado.
Navegar Scripts QBCore e o centro de guias QBCore.
migração segura QBCore para Qbox
- Inventarie todos os recursos. Registre sua versão, tabelas de banco de dados, chamadas de framework e status de suporte.
- Faça backup de arquivos e banco de dados. Prove que o backup restaura antes de modificar a produção.
- Instale Qbox com a receita recomendada. Comece a partir dos arquivos de configuração atuais em vez de misturar arquivos de núcleo antigos na nova pilha.
- Reveja jobs e gangs. Qbox usa classificações numéricas de emprego e gangue, e sua documentação de migração destaca as alterações necessárias de arquivos compartilhados e colação.
- Configure e converta o banco de dados de inventário. Siga a documentação exata do inventário e trabalhe em uma cópia.
- Teste os scripts por categoria. Comece com identidade, personagens, empregos, dinheiro e inventário, depois veículos, moradia, telefones e ferramentas administrativas.
- Substitua gradualmente os internos não suportados. Qbox suporta conversão parcial de chamadas QBCore para exports e módulos Qbox.
- Faça a migração apenas após os testes de paridade serem aprovados. Mantenha um plano de rollback com tempo definido e o backup pré-migração intacto.
Decisão
Para um novo projeto, Qbox é um padrão forte quando a equipe deseja sua arquitetura e conjunto de recursos compatíveis. Para um servidor QBCore lucrativo ou altamente personalizado, não migre por moda: mova-se apenas quando uma auditoria em etapas prova que o benefício supera o risco de compatibilidade e dados.