Base × framework × scripts
Muita gente confunde os três. Separar isso evita comprar/instalar coisa errada:
- Framework (qb-core): o “sistema operacional” do RP — player data, jobs, dinheiro, permissões, exports.
- Base: framework + banco + conjunto mínimo de resources que deixam o jogador criar personagem, spawnar, abrir inventário e circular na cidade.
- Scripts: empregos, utilitários, HUD avançado, gangs, etc. — entram depois da base estável.
Sem base sólida, todo script novo vira dor de cabeça (export missing, SQL faltando, ordem errada no server.cfg).
As camadas de uma base boa
Pense em camadas. Só avance quando a anterior estiver ok:
- Infra: FXServer, license key, MySQL, oxmysql, firewall.
- Core: qb-core + shared (items, jobs, vehicles básicos).
- Identidade: multichar, spawn, clothing/aparência.
- Sobrevivência urbana: inventário, HUD, target/menu, voice (se usar).
- Economia e cidade: shops, banking, garagem, combustível, veículos.
- Empregos e imersão: polícia, EMS, mecânica, jobs civis, housing.
- Custom / premium: seus scripts exclusivos (DEVELOPERWHS ou próprios).
Stack mínima recomendada (QBCore)
Uma base “mínima jogável” costuma incluir (nomes podem variar conforme a versão):
- oxmysql — conexão com o banco
- qb-core — framework
- qb-multicharacter — criação/seleção de personagem
- qb-spawn — locais de spawn
- qb-inventory (ou inventário compatível) — itens
- qb-hud — status do jogador
- qb-menu / qb-target — interação
- qb-clothing (ou equivalente) — aparência
Só depois disso faça ensure de jobs, phone, houses, etc. Base inchada demais no dia 1 é a receita de console vermelho.
Como organizar as pastas
Organização evita “sumiu o resource”. Um padrão comum:
resources/
[standalone]/ → oxmysql, voz, libs
[qb]/ → qb-core, qb-inventory, qb-hud...
[voice]/ → pma-voice / similar
[maps]/ → MLOs e mapas
[scripts]/ → seus scripts / premium
[teste]/ → nunca vá para produção sem revisar Pastas entre colchetes ([qb]) são categorias no FiveM — o nome do resource continua sendo a pasta interna (qb-core).
Ordem de start no server.cfg
Regra de ouro: dependência sobe antes de quem depende.
- Resources nativos / sessão (chat, spawnmanager, etc.)
- oxmysql (ou conector)
- qb-core
- Identidade (multichar, spawn, clothing)
- Inventário, HUD, menu/target
- Economia e cidade
- Jobs e scripts custom
Se um script reclama de export do qb-core, quase sempre ele está no ensure antes do core — ou a versão do script não combina com a do framework.
Banco de dados: o que a base espera
- Database dedicado (ex.:
qbcore) - SQL do qb-core + SQLs dos resources que você ativou
- Connection string correta no cfg
- Backup antes de qualquer update grande
Personagem que “não salva”, inventário vazio ou erro ao logar quase sempre é SQL incompleto ou tabela desatualizada após update de resource.
Checklist: “minha base está pronta?”
- Servidor sobe sem erro crítico no console
- Cria personagem e spawna no mundo
- Inventário abre e persiste após relog
- HUD e status (fome/sede/vida) funcionam
- Pelo menos um job civil testado
- Admin/ACE configurado para staff
- resmon sem resource em idle absurdo
- Backup do MySQL + pasta resources testado
Se esses 8 pontos passam, aí sim vale adicionar scripts premium e sistemas pesados.
Erros clássicos ao “montar base”
- Misturar QBCore antigo com scripts novos (ou o contrário)
- Instalar 80 resources de uma vez e não saber qual quebrou
- Esquecer SQL de um job/inventory
- Dois inventários/HUDs ao mesmo tempo
- Mexer em shared sem versionar (Git)
Evoluir a base com scripts
Com a fundação estável, o diferencial do servidor são os scripts (empregos, utilitários, sistemas de cidade). Você pode desenvolver em Lua ou usar scripts prontos do catálogo DEVELOPERWHS — sempre um de cada vez, com backup e teste.
Se ainda não tem FXServer no ar, comece por como criar um servidor FiveM ou pelo guia Windows + QBCore .
Próximos passos no blog: instalar scripts , emotes , phone ou implantação na VPS .