QBOX vs QBCore: Qual framework FiveM você deve escolher?

Introdução: Por que as estruturas são importantes

Sua estrutura determina a rapidez com que você cria recursos, a estabilidade da sua cidade e a facilidade de escalabilidade. No FiveM, QBCore e Q-BOX (caixa de som) são as duas opções modernas que a maioria dos proprietários avalia. Ambas são capazes, mas otimizam para diferentes compensações: amplitude do ecossistema versus arquitetura moderna que prioriza o boi. Este guia explica as diferenças com orientações práticas que você pode seguir.

Resumo

Novo servidor, pilha moderna, ecossistema Ox desde o primeiro dia? Favor Q-BOX (caixa de som).
Cidade existente com muitos recursos nativos do QB e equipe que conhece o QBCore? Fique ligado QBCore (ou migrar em fases).

Navegue por nosso conteúdo de frameworks selecionados e bibliotecas de scripts:
• Scripts QBOX → https://fivemx.com/qbox-scripts/
• Scripts QBCore → https://fivemx.com/qbcore-scripts/
• Centro de estruturas → https://fivemx.com/frameworks

Definições (em uma linha cada)

QBCore: The most popular Lua RP framework for FiveM, with years of community scripts and tutorials. Essencial repo: qbcore‑framework/qb‑core.
Q-BOX (caixa de som): Um caminho de sucessor moderno com uma filosofia Ox‑first (ox_lib/oxmysql/ox_inventory), além de uma ponte de compatibilidade QB para executar muitos recursos QB com pouca ou nenhuma alteração.

Problema que este artigo resolve

Escolhendo entre QBOX e QBCore sem reformular todo o seu conjunto de recursos. Compararemos recursos, padrões de desempenho, realidades do ecossistema e forneceremos listas de verificação para migração caso você opte pela migração.

O que é QBCore?

Origens. O QBCore surgiu da comunidade como uma estrutura pragmática e modular para acelerar o desenvolvimento de servidores RP. Ele estabeleceu convenções para jogadores, tarefas, inventários, finanças, retornos de chamada, exportações e eventos comuns. Por existir há mais tempo que o QBOX, ele tem a maior catálogo de roteiros prontos (grátis e premium) e a maioria dos tutoriais no YouTube/Discord.

Pontos fortes.

Escala do ecossistema. Milhares de recursos com tags QB, de telefones e empregos a ferramentas administrativas e pacotes de interface. Mais rápido para montar uma cidade a partir de componentes existentes.
Familiaridade com o desenvolvedor. Desenvolvedores, equipe e ajudantes da comunidade geralmente sabem de cor as exportações/eventos do QBCore. A solução de problemas é rápida.
Convenções estáveis. Dados do cidadão, retornos de chamada, estado do servidor/jogador e padrões comuns são bem compreendidos, reduzindo o atrito da integração.
Camada de banco de dados flexível. A maioria dos servidores QBCore modernos executam oxmysql Hoje em dia, pilhas mais antigas usavam ghmattimysql/mysql-async. Você pode manter seu banco de dados e scripts enquanto moderniza em torno deles.

Fraquezas.

Variância legada. Muitos scripts QB 'clássicos' são anteriores às melhores práticas do Ox — qualidade de código mista e mais refatoração quando você pressiona por 0,00–0,01 ms de inatividade.
Fragmentação da interface do usuário. A dependência histórica de UIs/inventários mais antigos significa que você frequentemente substitui ou adapta inventário de bois e kits de interface de usuário mais recentes de qualquer maneira.
Futuras tarefas domésticas. À medida que as melhores práticas avançam em direção aos utilitários Ox/tipificados, você irá refatorar gradualmente o código de colagem ou adicionar adaptadores.

Explore nossa biblioteca de conteúdo QB: Scripts QBCore → https://fivemx.com/qbcore-scripts/
Como fazer: Personalizar scripts QBCore → https://fivemx.com/how-to-customize-qbcore-scripts

Site QBCore

O que é QBOX?

Posicionamento. QBOX abraça o Ecossistema de bois pronto para uso: boi_lib, oxmysql, e uma abordagem moderna para exportações, eventos e módulos. Ele vem com um camada de ponte que retém compatibilidade com versões anteriores da maioria dos recursos do QB, permitindo que você adote um núcleo mais limpo sem abrir mão dos seus scripts favoritos.

Características principais.

Fundação Ox‑first. Utilitários consistentes (matemática/tabelas/strings/desenho) e padrões modernos promovem recursos mais limpos e rápidos.
Ponte de compatibilidade. Muitos scripts QB são executados com alterações mínimas ou nenhuma alteração, o que é útil para migrações em fases.
Pilhas incluídas. Multicaractere, multitarefa/gangue, fila e outros itens essenciais são módulos de primeira classe, em vez de complementos ad hoc.

Prós.

Padrões voltados ao desempenho. Os padrões baseados em Ox ajudam a reduzir loops de pesquisa e chamadas de sorteio, desde que você respeite as melhores práticas em todos os recursos.
Postura de segurança e qualidade. Orientações claras para evitar edições essenciais; configuração em vez de patches. Auditorias mais simples.
Preparação para o futuro. Desenvolvido para FiveM 2025+: Lua 5.4, oxmysql e pilhas de UI modernas.

Contras.

Ecossistema menor (por enquanto). Você se apoiará na ponte de compatibilidade ou em scripts de porta que dependem de QB-ismos.
Curva de aprendizado da equipe. A equipe acostumada com eventos/exportações do QBCore precisará se adaptar aos idiomas Ox/Qbox.

Centro QBOX → https://fivemx.com/qbox-ox-stack
Scripts QBOX (selecionados) → https://fivemx.com/qbox-scripts/

Site QBOX

QBOX vs QBCore — Comparação direta (matriz de recursos)

Tabela de resumo

Área	Q-BOX (caixa de som)	QBCore	Veredicto prático
Padrões de desempenho	Módulos enxutos, priorizando o Ox, e menos footguns legados. É mais fácil manter a CPU ociosa entre 0,00 e 0,02 ms quando você segue as práticas do Ox.	Varia de acordo com a safra do recurso; muitos scripts modernos excelentes, alguns mais antigos com muitos loops de tique.	Para uma cidade nova que busca uma marcha lenta ultrabaixa, o QBOX tem a vantagem; uma pilha QBCore bem planejada pode corresponder a isso.
Ecossistema e scripts	Catálogo nativo menor; depende de recursos de ponte + Ox compatíveis com QB.	Maior catálogo de scripts e tutoriais prontos.	Se você precisa de velocidade para conteúdo, o QBCore é a escolha certa hoje.
Camada de banco de dados	oxmysql por padrão; esquema e consultas normalmente no estilo Ox.	Os servidores modernos também usam oxmysql; pilhas legadas podem ser mysql‑async/ghmatti.	Empatou em 2025 se você já estiver no oxmysql; a migração só é necessária se você ainda estiver no mysql-async.
Inventário/UI	Alinhado com o boi (comumente inventário de bois). UIs limpas e extensíveis.	Historicamente qb-inventory e muitos forks; muitos administradores padronizam em inventário de bois de qualquer forma.	Se você quer convenções de interface do usuário do Ox, o QBOX é mais adequado.
Dependências/ferramentas	ox_lib, oxmysql, módulos incorporados; exportações/eventos consistentes.	qb‑core mais muitos recursos qb‑; a qualidade varia.	O QBOX é mais opinativo; o QBCore é mais aberto.
Personalização/DX	Módulos controlados por configuração, separação clara; envie desenvolvedores para APIs baseadas em exportação.	Exportações/eventos familiares; vários exemplos de código online.	O QBCore é mais fácil para equipes com experiência em QB; o QBOX é mais agradável para desenvolvedores greenfield/Ox.
Comunidade e documentos	Documentação menor, mas focada, e mantenedores ativos.	Comunidade ampla, muitos guias não oficiais.	Precisa de respostas rápidas? O QBCore tem mais conteúdo da comunidade; a documentação do QBOX está melhorando.
Preparando-se para o futuro	Construído em torno das melhores práticas atuais (Lua 5.4, pilha Ox, utilitários tipados).	Ainda em evolução; muitos servidores são modernizados aos poucos.	Leve vantagem do QBOX para limpeza a longo prazo; o QBCore permanece viável.
Posição de segurança	Incentiva edições sem núcleo, isolamento de módulo e fluxos de permissão mais limpos.	Depende de recursos específicos; muitos são sólidos, alguns mais antigos nem tanto.	Os padrões do QBOX reduzem edições propensas a acidentes; com o QBCore, imponha revisões e linting.
receitas txAdmin	Orientações e receitas oficiais disponíveis; início rápido.	Receitas e modelos testados em batalha em todos os lugares.	Empate; escolha a receita mais próxima da sua pilha.
Atrito migratório	A ponte QB reduz o atrito; o alinhamento Ox minimiza futuras refatorações.	Mínimo se você permanecer no território dos QBs; migrar mais tarde exige esforço.	Se você prevê Ox em todos os lugares, inicie o QBOX.
Curva de aprendizado	Novidade se seu time só conhece QB; hábitos do Ox para adotar.	Menor para administradores existentes; a maioria da equipe já conhece os fluxos do QB.	Escolha com base nas habilidades atuais da sua equipe.

Notas que importam na prática

Seu pior recurso determina o desempenho. A escolha da estrutura ajuda, mas os grandes problemas são a interface do usuário, os recursos de streaming e os loops mal sincronizados. Sempre crie um perfil com resmon e policiar cada RP.
Alinhamento de boi é a tendência. Quer você execute QBOX ou QBCore, migrar para oxmysql, boi_lib, e inventário de bois tende a melhorar a confiabilidade e a experiência do desenvolvedor.

Quando escolher QBOX

Escolha Q-BOX (caixa de som) se a maioria destas for verdadeira:

Você está lançando um novo servidor e não precisa de dezenas de scripts legados somente para QB no primeiro dia.
Você quer Boi em todo lugar: ox_lib, oxmysql, ox_inventory, ox_target.
Você se importa com manutenibilidade de longo prazo mais do que a contagem máxima de scripts do primeiro dia.
Sua equipe se sente confortável adotando novos padrões e lendo documentos oficiais.

Benefícios operacionais:

Uma abordagem mais limpa de configuração sobre patches reduz o risco de “edições de núcleo”.
Menos camadas de cola para alcançar uma UI/UX moderna.
Mais fácil padronizar práticas de codificação entre colaboradores.

Começar: Centro QBOX → https://fivemx.com/qbox-ox-stack • Scripts → https://fivemx.com/qbox-scripts/

Quando escolher QBCore

Escolher QBCore se a maioria for verdadeira:

Você já executou um Cidade QB com jogadores ao vivo e equipe treinada em fluxos de QB.
Você precisa cobertura máxima do ecossistema hoje (telefones, trabalhos, UIs, CADs, pacotes de administração) com portabilidade mínima.
Você planeja modernizar no local: adote o oxmysql, substitua inventários/UIs mais antigos, refatore loops pesados e restrinja as permissões.

Benefícios operacionais:

Contratação e integração mais rápidas: a maioria dos candidatos conhece exportações/eventos de QB.
O tempo para apresentar é curto usando os recursos e guias existentes.

Guias internos úteis:

Catálogo de scripts QBCore → https://fivemx.com/qbcore-scripts/
Como fazer: Personalizar scripts QBCore → https://fivemx.com/how-to-customize-qbcore-scripts

Migração: QBCore → QBOX (com segurança, em fases)

Você pode mudar para o QBOX sem quebrar seu servidor se tratar isso como uma migração de produto: auditoria → adaptação → execução dupla → transição.

1) Auditoria pré-migratória

Inventário e UI: Liste tudo relacionado ao qb-inventory/UIs mais antigas. Decida se deve adotar inventário de bois (recomendado) e um kit de interface de usuário consistente.
Banco de dados: Confirme que você está ligado oxmysql. Caso contrário, migre primeiro: MySQL‑Async → oxmysql guia → https://fivemx.com/mysql-async-to-oxmysql
Identificadores: Padronize seu modelo de identificador (steam, license, citizenid, discord). Mapeie como ele é armazenado e referenciado. Veja: Migração de Identificadores SQL → https://fivemx.com/sql-identifiers-migration
Scripts para portar: Marcar recursos por esforço: compatível como está, precisa de um pequeno adaptador, reescrever/substituir. Mantenha uma planilha ativa.

2) Crie adaptadores onde vale a pena

Usar padrões de adaptadores para expor as mesmas exportações/eventos esperados pelos seus scripts existentes, enquanto chama internamente módulos QBOX ou utilitários Ox. Referência: Convertendo scripts FiveM → https://fivemx.com/converting-fivem-scripts e Padrões de Adaptadores → https://fivemx.com/adapter-patterns
Sempre que possível, prefira substituições de bois (por exemplo, recursos do ox_inventory) em vez de atualizar APIs antigas.

3) Estratégia de migração de dados

Jogadores e personagens: Escreva SQL idempotente para mapear/renomear colunas e garantir que chaves/índices existam para os módulos QBOX. Mantenha um script de rollback.
Itens/lojas/veículos: Normalize as tabelas para seus novos sistemas de estoque/garagem. Teste os fluxos de compra, estoque, depósito, porta-luvas, porta-malas e evidências.
Permissões: Recrie funções de equipe e trabalho usando as novas exportações/eventos; verifique portas de comando e ferramentas administrativas.

4) Dupla execução e verificação

Executar um cidade de encenação com snapshots de BD espelhados e conjuntos de recursos semelhantes aos de produção.
Validar resmon em modo ocioso e sob carga (pontos críticos de trabalho, picos, relatórios). Defina limites máximos por recurso e corrija discrepâncias antes da transição.
Teste de fumaça: integração, multicaractere, alojamento, veículos, telefone, cobrança, criação, policiamento, EMS, evidências, roubos.

5) Corte e endurecimento

Anuncie uma janela de manutenção; migre dados; troque receitas; re-semeie caches.
Monitore os logs de perto (txAdmin, console do servidor, registrador Ox). Adicione alertas de tempo de execução para picos de erro.
Planeje um janela de hotfix com seus desenvolvedores on-line.

Listas de verificação e guias de migração

Convertendo scripts FiveM → https://fivemx.com/converting-fivem-scripts
MySQL‑Async para oxmysql → https://fivemx.com/mysql-async-to-oxmysql
Migração de Identificadores SQL → https://fivemx.com/sql-identifiers-migration
Centro de conversão de estrutura → https://fivemx.com/framework-conversion

Recomendações para 2025

Se você está começando do zero: escolher Q-BOX (caixa de som) para se alinhar às melhores práticas do Ox desde o primeiro dia. Você escreverá recursos mais limpos, minimizará a dívida tecnológica legada e ainda executará muitos scripts criados pelo QB pela ponte.

Se você opera uma cidade QB madura: fique ligado QBCore e modernizar no local: oxmysql, ox_inventory, orçamentos agressivos de resmon e padrões de revisão de código. Planeje um Piloto QBOX na preparação para quantificar os benefícios antes de qualquer mudança.

Se você estiver indeciso: Protótipos com pacotes de conteúdo idênticos e métricas: tempo de execução, resposta em modo inativo/sob carga e satisfação da equipe. Escolha o que reduz seu custo contínuo de mudança.

Conclusão e próximos passos

Ambas as estruturas podem administrar uma cidade de alto nível. A diferença está no legado que você deseja transmitir e no quão padronizado você deseja que seu futuro seja.

Próximos passos: