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 | 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
- 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.
- Faça backup dos arquivos e do banco de dados. Comprove que o backup pode ser restaurado antes de modificar a produção.
- 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.
- 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.
- Configure e converta o banco de dados do inventário. Siga a documentação exata do inventário e trabalhe em uma cópia.
- Teste os scripts por categoria. Comece por identidade, personagens, empregos, dinheiro e inventário, depois passe para veículos, moradias, telefones e ferramentas administrativas.
- Substitua gradualmente os componentes internos sem suporte. O Qbox permite converter parcialmente chamadas do QBCore em exports e módulos do Qbox.
- 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