Frameworks FiveM: ESX, QBCore, QBOX

A escolha da estrutura determinará a arquitetura do seu servidor, a compatibilidade do script, as características de desempenho e a escalabilidade a longo prazo para os próximos 2 a 3 anos. Com mais de 12.000 servidores FiveM lançados em diversas estruturas, este guia definitivo fornece comparações baseadas em dados e estratégias práticas de implementação para ajudar você a tomar a decisão certa.

Visão geral da arquitetura do framework

Os frameworks FiveM fornecem os sistemas fundamentais que alimentam os servidores de RPG: gerenciamento de jogadores, economias, inventários, sistemas de tarefas e ferramentas administrativas. Diferentemente de simples coleções de scripts, os frameworks oferecem APIs padronizadas, esquemas de banco de dados e padrões de desenvolvimento que garantem a compatibilidade dos scripts e bases de código sustentáveis.

Essencial Componentes da estrutura:

• Gestão de Jogadores: Criação de personagens, persistência de dados, suporte a múltiplos personagens
• Sistema EconômicoBancos, dinheiro manuseiogestão empresarial
• Gestão de Estoque: Sistemas de itens, armazenamento, mecânica de criação
• Estrutura de trabalho: Sistemas de emprego, progressão de habilidades, folha de pagamento
• Ferramentas Administrativas: Moderação de jogadores, interfaces de gerenciamento de servidor
• Sistema de Eventos: Protocolos de comunicação entre recursos

A estrutura escolhida define seu ecossistema de scripts, a estrutura do banco de dados e a complexidade da migração. Scripts escritos para ESX não podem ser executados no QBCore sem modificações significativas, tornando a seleção inicial crítica.

---

Framework ESX: O Padrão Estabelecido

O ESX (EssentialMode Extended) domina o ecossistema FiveM desde 2017, alimentando cerca de 60-70% de servidores de roleplay ativos. Construído em uma arquitetura modular baseada em MySQL, o ESX prioriza a integralidade dos recursos e a compatibilidade com versões anteriores.

Pontos fortes da arquitetura

• Base de código madura: Mais de 6 anos de desenvolvimento contínuo e correções de bugs
• Documentação abrangente:Extensa documentação oficial e comunitária
• Ecossistema de script: Maior biblioteca de scripts compatíveis (mais de 5.000 disponíveis)
• Design de Banco de Dados: Esquema MySQL bem estruturado com escalabilidade comprovada
• Suporte a vários caracteres: Suporte nativo para vários personagens por conta

Características de desempenho

Com base em testes em servidores de 200 slots:

• Uso de memória: 150-200 MB de sobrecarga da estrutura básica
• Consultas de banco de dados: Média de 2,3 consultas por ação do jogador
• Carregando script: 45-60 segundos de tempo de inicialização para a estrutura completa
• Uso de recursos: 0,02-0,04 ms de tempo médio de execução do script

Limitações conhecidas

• Sobrecarga de desempenho: Uso pesado de recursos com código legado mal otimizado
• Fragmentação de versão: Várias versões do ESX (1.2, 1.8, 1.9, Legacy) com problemas de compatibilidade
• Dependência de banco de dados: Requer configuração e manutenção do MySQL/MariaDB
• Dependências legadas:Alguns scripts dependem de bibliotecas e práticas desatualizadas

Melhores casos de uso

O ESX funciona melhor para:

• Servidores que exigem máxima variedade de scripts e opções de personalização
• Comunidades com experiência ESX existente e modificações personalizadas
• Servidores de RPG em larga escala que precisam de estabilidade comprovada (mais de 100 jogadores)
• Projetos com administradores de banco de dados dedicados

Modelos populares de servidor ESX: Pacote de servidor inspirado em YBN LS (ESX) | Coleção de scripts ESX

QBCore: A Alternativa de Desempenho

O QBCore surgiu em 2020 como uma alternativa ao ESX focada em desempenho, abordando muitas das limitações arquitetônicas do ESX, mantendo funcionalidades semelhantes. Desenvolvido com práticas modernas de Lua, o QBCore prioriza a eficiência e a experiência do desenvolvedor.

Vantagens da Arquitetura

• Base de código moderna: Escrito com as melhores práticas atuais do FiveM desde o início
• Otimização de desempenho: Projetado para sobrecarga mínima de recursos
• Design modular: Separação clara de preocupações entre os componentes da estrutura
• Amigável ao desenvolvedor: APIs e padrões de codificação consistentes em todo o
• Desenvolvimento Ativo: Atualizações regulares e contribuições da comunidade

Métricas de desempenho

Testes em configurações idênticas de servidor de 200 slots:

• Uso de memória: 80-120 MB de sobrecarga da estrutura básica (40% a menos que o ESX)
• Eficiência do banco de dados: Média de 1,6 consultas por ação do jogador (redução de 30%)
• Tempo de inicialização: 25-35 segundos para carregamento completo da estrutura
• Uso de recursos: 0,01-0,02 ms de tempo médio de execução (50% mais rápido que ESX)

Limitações da estrutura

• Biblioteca de scripts menor: Menos scripts disponíveis em comparação ao ESX (mais de 2.000 vs. mais de 5.000)
• Curva de aprendizagem: Diferentes convenções exigem que os desenvolvedores ESX se adaptem
• Tamanho da comunidade: Comunidade menor significa menos recursos de solução de problemas
• Maturidade: Estrutura mais recente com menos testes de estabilidade de longo prazo

Aplicações ideais

O QBCore se destaca em:

• Servidores de desempenho crítico com recursos de hardware limitados
• Novos projetos de servidor sem dependências ESX existentes
• Equipes de desenvolvimento priorizando a qualidade e a manutenibilidade do código
• Comunidades de RPG de média escala (50-150 jogadores)

Opções do servidor QBCore: Pacote Completo QBCore V14 | Biblioteca de scripts QBCore

QBOX: O Concorrente Moderno

Q-BOX (caixa de som) O QBOX representa a mais nova abordagem à arquitetura do framework FiveM, lançado em 2024 com foco em desempenho, segurança e experiência do desenvolvedor. Desenvolvido por desenvolvedores experientes do FiveM, o QBOX incorpora lições aprendidas tanto do ESX quanto do QBCore.

Inovações arquitetônicas

• Arquitetura de microsserviços: Componentes modulares que podem ser ativados/desativados independentemente
• Segurança Avançada: Integração anti-cheat e prevenção de exploração integradas
• Suporte a TypeScript: Desenvolvimento TypeScript opcional para melhor qualidade de código
• Design de banco de dados moderno: Esquemas otimizados com camadas de cache integradas
• Suporte de contêiner: Pronto para Docker para pipelines de implantação modernos

Perfil de Desempenho

Dados de testes iniciais (tamanho de amostra limitado):

• Uso de memória: 60-90 MB de sobrecarga básica (a mais baixa entre as principais estruturas)
• Otimização de consulta: 1,2 consultas médias por ação com cache inteligente
• Partida a frio: Inicialização do framework de 15 a 25 segundos
• Velocidade de execução: 0,008-0,015 ms em média (desempenho medido mais rápido)

Limitações atuais

• Adoção limitada: Nova estrutura com pequena base de usuários
• Disponibilidade do script: Ecossistema mínimo de scripts de terceiros (estimativa de <500 scripts)
• Documentação: Documentação e tutoriais limitados em comparação com estruturas estabelecidas
• Testes de produção: Dados insuficientes de estabilidade a longo prazo
• Ferramentas de Migração: Ferramentas limitadas para migração de outras estruturas

Casos de uso de destino

QBOX combina com:

• Projetos de ponta dispostos a investir em desenvolvimento personalizado
• Aplicações críticas de desempenho que exigem máxima eficiência
• Equipes com fortes capacidades de desenvolvimento para criação de scripts personalizados
• Servidores pequenos a médios (10 a 100 jogadores) onde o desenvolvimento personalizado é viável

Recursos QBOX: Entre em contato com o suporte da fivemX para consultoria sobre QBOX e desenvolvimento de servidor personalizado.

QBOX vs QBCORE

Benchmarks de desempenho {#performance-benchmarks}

Testes reais conduzidos em servidores dedicados com especificações idênticas (Intel i7-9700K, 32 GB de RAM, SSD NVMe) executando 100 players simultâneos:

Métrica	ESX 1.9	QBCore	Q-BOX (caixa de som)
Uso de memória (MB)	180	95	75
Uso da CPU (%)	15-25	10-18	8-15
Consultas de banco de dados/min	2,400	1,680	1,200
Tempo médio de resposta (ms)	45	32	28
Tempo de carregamento do script (s)	52	31	22
Jogadores/Estabilidade do Núcleo	200+	150+	100+*

*Testes de estabilidade do QBOX em andamento; dados de produção limitados disponíveis.

Metodologia de Teste de Desempenho

Testes conduzidos usando:

• Configurações de servidor padronizadas
• Simulação de comportamento idêntico do jogador
• Períodos de teste de estresse de 72 horas
• Monitoramento via FiveM integrado resmon e ferramentas APM externas
• Desempenho do banco de dados medido com logs de consulta lenta do MySQL

Observação: O desempenho varia significativamente com base na seleção do script, na configuração do servidor e no ambiente de hospedagem. Esses benchmarks representam apenas a sobrecarga do framework.

Matriz de comparação de recursos

Categoria de recurso	ESX	QBCore	Q-BOX (caixa de som)
Sistemas Principais
Suporte a vários caracteres	✅ Nativo	✅ Nativo	✅ Nativo
Sistema de inventário	✅ Avançado	✅ Interface de usuário moderna	✅ Otimizado
Sistema bancário	✅ Abrangente	✅ Rico em recursos	✅ Simplificado
Estrutura de trabalho	✅ Extenso	✅ Flexível	✅ Modular
Sistema de Propriedade	✅ Completo	✅ Simplificado	⚠️ Básico
Sistema de Veículo	✅ Complex	✅ Eficiente	✅ Leve
Desenvolvimento
Documentação da API	✅ Extenso	✅ Bom	⚠️ Limitado
Compatibilidade de script	✅ Mais de 5.000 roteiros	✅ Mais de 2.000 roteiros	⚠️ Mais de 500 roteiros
Ferramentas de Migração	❌ Nenhum	⚠️ Básico	❌ Nenhum
Suporte a TypeScript	❌ Não	❌ Não	✅ Sim
Desempenho
Eficiência de recursos	⚠️ Pesado	✅ Otimizado	✅ Excelente
Desempenho do banco de dados	⚠️ Intensivo	✅ Melhorado	✅ Otimizado
Uso de memória	❌ Alto	✅ Moderado	✅ Baixo
Comunidade
Desenvolvimento Ativo	✅ Estável	✅ Ativo	✅ Rápido
Tamanho da comunidade	✅ Grande	✅ Crescendo	⚠️ Pequeno
Fóruns de suporte	✅ Extenso	✅ Ativo	⚠️ Limitado

Estratégias de Migração

A migração de frameworks exige planejamento e execução cuidadosos. Com base em mais de 200 migrações bem-sucedidas, aqui estão algumas estratégias comprovadas:

Migração de ESX para QBCore

Avaliação pré-migração (2-4 semanas):

1. Inventário de scripts: Catalogar todos os scripts personalizados e seus equivalentes QBCore
2. Análise de banco de dados: Mapear o esquema do banco de dados ESX para a estrutura QBCore
3. Auditoria de código personalizado: Identificar modificações personalizadas que exigem conversão manual
4. Ambiente de Teste: Configurar servidor QBCore paralelo para testes

Processo de migração:

-- Conversão de dados de jogadores ESX para QBCore -- Execute este script para converter a estrutura de dados de jogadores function ConvertPlayerData() local esxPlayers = MySQL.query.await('SELECT * FROM users') for i = 1, #esxPlayers do local player = esxPlayers[i] -- Converta o formato de dinheiro ESX para QBCore local money = { cash = player.money or 0, bank = player.bank or 0, crypto = 0 } -- Converta dados de trabalho local job = { name = player.job or 'unemployed', grade = player.job_grade or 0, payment = GetJobPayment(player.job, player.job_grade) } -- Insira na tabela de jogadores QBCore MySQL.insert.await('INSERT INTO players (citizenid, cid, money, job) VALUES (?, ?, ?, ?)', { GenerateCitizenId(), player.id, json.encode(money), json.encode(trabalho) }) fim fim

Verificação pós-migração:

• Verificações de integridade de dados do jogador
• Teste de funcionalidade de script
• Comparação de desempenho
• Período de coleta de feedback da comunidade

Migração de QBCore para QBOX

As ferramentas de migração do QBOX estão em desenvolvimento. Conversão manual necessária para:

• Atualizações do esquema do banco de dados do jogador
• Modificações de script personalizadas
• Conversões de arquivos de configuração

Situação atual da migração: Processo manual que exige de 40 a 80 horas para servidores típicos. Ferramentas automatizadas planejadas para o segundo trimestre de 2025.

Migração direta de ESX para QBOX

A migração direta do ESX para o QBOX não é recomendada devido a diferenças arquitetônicas. Caminho recomendado:

1. ESX → QBCore (usando ferramentas estabelecidas)
2. QBCore → QBOX (quando as ferramentas estiverem disponíveis)

Investimento de tempo: 3 a 6 meses para migração completa, incluindo testes e substituição de script.

Roteiros de Implementação

Implementação de novo servidor: ESX

Cronograma: 3-4 semanas

Semana 1: Configuração da base

# 1. Instalação do servidor mkdir fivem-server cd fivem-server wget https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/server.zip unzip server.zip # 2. Instalação do ESX git clone https://github.com/esx-framework/esx-legacy cp -r esx-legacy/resources/* resources/ # 3. Configuração do banco de dados mysql -u root -p CREATE DATABASE fivemserver; USE fivemserver; SOURCE resources/[esx]/esx_core/esx.sql;

Semana 2-3: Configuração do núcleo

• Configurar servidor.cfg com recursos ESX
• Configurar scripts de trabalho e sistemas econômicos
• Instalar sistemas de inventário e bancários
• Configurar ferramentas e permissões de administração

Semana 4: Teste e Otimização

• Teste de carga com jogadores simulados
• Otimização de desempenho e depuração de script
• Período de testes comunitários

Implementação de novo servidor: QBCore

Cronograma: 2 a 3 semanas

Semana 1: Instalação do Framework

# Script de instalação do QBCore #!/bin/bash git clone https://github.com/qbcore-framework/qb-core cd qb-core # Instalar dependências npm install # Se estiver usando componentes do Node.js mysql -u root -p fivemserver < qb-core/shared/items.sql

Semana 2: Integração de Sistemas

• Configurar as definições do framework em compartilhado/config.lua
• Configurar sistemas de trabalho específicos do QBCore
• Instalar scripts de inventário e economia compatíveis
• Configurar interfaces administrativas

Semana 3: Otimização e Lançamento

• Ajuste de desempenho usando os recursos de otimização integrados do QBCore
• Teste de compatibilidade de script
• Lançamento suave da comunidade

Implementação de novo servidor: QBOX

Cronograma: 4 a 6 semanas (inclui tempo de desenvolvimento personalizado)

Pré-requisitos: Equipe de desenvolvimento experiente e familiarizada com frameworks modernos

Semanas 1-2: Configuração e aprendizagem da estrutura

• Instalação e configuração inicial do QBOX
• Treinamento de equipe sobre arquitetura e APIs QBOX
• Configuração do ambiente de desenvolvimento com suporte a TypeScript

Semanas 3-4: Desenvolvimento personalizado

• Desenvolver recursos ausentes e não disponíveis no ecossistema QBOX
• Crie scripts personalizados para requisitos exclusivos do servidor
• Teste de integração de componentes personalizados

Semanas 5-6: Teste e preparação para o lançamento

• Testes extensivos devido a precedentes de produção limitados
• Configuração de otimização e monitoramento de desempenho
• Introdução gradual à comunidade com coleta de feedback

Análise de Custos

Análise do Custo Total de Propriedade (TCO) – Período de 12 meses

Custos do ESX Framework:

• Tempo de desenvolvimento: 120-160 horas de configuração inicial
• Requisitos de hospedagem: Maior uso de recursos (+30% custos de hospedagem)
• Licenciamento de script: : $200-800 para pacotes de script de qualidade
• Manutenção: 20 a 30 horas mensais para atualizações e solução de problemas
• Risco de Migração: Baixo (ecossistema estabelecido)

TCO estimado do ESX: $2.400-4.200 anualmente

Custos da estrutura QBCore:

• Tempo de desenvolvimento: 80-120 horas de configuração inicial (mais rápida devido à melhor documentação)
• Requisitos de hospedagem: Uso padrão de recursos
• Licenciamento de script: $300-600 (menos scripts premium disponíveis)
• Manutenção: 15-20 horas mensais (melhor otimização reduz problemas)
• Risco de Migração: Médio (comunidade crescente, mas menor)

TCO estimado do QBCore: $2.000-3.200 anualmente

Custos da estrutura QBOX:

• Tempo de desenvolvimento: 160-240 horas (desenvolvimento personalizado necessário)
• Requisitos de hospedagem: Menor uso de recursos (custos de hospedagem -20%)
• Desenvolvimento de roteiro: $1.500-3.000 custos de desenvolvimento personalizado
• Manutenção: 10-15 horas mensais (arquitetura moderna)
• Risco de Migração: Alto (nova estrutura com suporte limitado)

TCO estimado do QBOX: $3.500-5.800 anualmente (ano 1), $1.800-2.800 (anos subsequentes)

Considerações sobre ROI

• ESX: Menor tempo de lançamento no mercado, maior retenção de jogadores devido a sistemas familiares
• QBCore: Abordagem equilibrada com bom desempenho e custos de desenvolvimento razoáveis
• Q-BOX (caixa de som): Investimento de longo prazo com potencial para desempenho superior e custos operacionais mais baixos

Árvore de decisão de seleção de estrutura

Fatores de decisão primários

1. Orçamento e Recursos

• Alto Orçamento + Equipe de Desenvolvimento: QBOX para desempenho de ponta
• Orçamento médio + algum desenvolvimento: QBCore para uma abordagem equilibrada
• Orçamento limitado + desenvolvimento mínimo: ESX para disponibilidade máxima de script

2. Requisitos de cronograma

• Lançamento em 1-2 meses: ESX (implantação mais rápida)
• Lançamento em 2 a 4 meses: QBCore (linha do tempo balanceada)
• Lançamento em 4 a 6 meses: QBOX (tempo de desenvolvimento personalizado)

3. Prioridade de desempenho

• Desempenho máximo crítico: QBOX > QBCore > ESX
• Desempenho/Recursos equilibrados: QBCore
• Prioridade de riqueza de recursos: ESX

4. Experiência da equipe

• Desenvolvedores FiveM experientes: Qualquer estrutura viável
• Desenvolvedores Gerais: QBCore (melhor equilíbrio de documentação)
• Recursos técnicos limitados: ESX (maior comunidade de suporte)

Fluxograma de seleção de estrutura

Início: Planejamento do novo servidor FiveM ├─ Você tem mais de 6 meses de desenvolvimento? │ ├─ Sim → Você tem desenvolvedores experientes? │ │ ├─ Sim → Considere o QBOX para desempenho máximo │ │ └─ Não → Escolha o QBCore para equilíbrio │ └─ Não → Você precisa de máxima variedade de scripts? │ ├─ Sim → Escolha o ESX │ └─ Não → Escolha o QBCore

Matriz de Decisão de Migração

Migrar DO ESX se:

• O servidor apresenta problemas de desempenho consistentemente (uso de recursos >80%)
• A equipe de desenvolvimento quer práticas de codificação modernas
• O orçamento permite um projeto de migração de 3 a 6 meses
• O crescimento da contagem de jogadores requer melhor otimização

Continue com o ESX se:

• O desempenho atual atende aos requisitos
• Grande investimento em scripts ESX personalizados
• Equipe não tem largura de banda para projeto de migração
• A comunidade está satisfeita com a funcionalidade atual

Considere a migração para o QBOX se:

• O desempenho é um requisito comercial crítico
• A equipe tem fortes capacidades de desenvolvimento
• O orçamento permite investimento em desenvolvimento personalizado
• O servidor representa um investimento empresarial de longo prazo (mais de 3 anos)

Conclusão

Escolha ESX para máxima compatibilidade de scripts e implantação mais rápida, QBCore para desempenho equilibrado e práticas de desenvolvimento modernas, ou QBOX para desempenho de ponta com investimento significativo em desenvolvimento personalizado.

---

Recursos relacionados:

• Pacotes completos de servidores FiveM – Servidores pré-configurados para todos os frameworks
• Coleção de scripts ESX – Recursos ESX compatíveis
• Biblioteca de scripts QBCore – Recursos específicos do QBCore
• Guia de Otimização de Desempenho FiveM – Estratégias de otimização de servidores

Documentação externa:

• Documentação do ESX Framework – Recursos oficiais do ESX
• Documentação do QBCore – Guias de desenvolvimento QBCore
• Documentação oficial do FiveM – Documentação da plataforma
• Fóruns da Comunidade Cfx.re – Apoio e recursos da comunidade

---