Como configurar um sistema de garagem no FiveM (ESX e QBCore)

Um sistema de garagem é essencial para qualquer servidor de roleplay — é assim que os jogadores de fato guardam e usam os veículos que compram. Este tutorial coloca uma garagem funcionando direito no ESX ou no QBCore, e cobre os erros que fazem os carros “sumirem”.

Passo 1 — Dependências

As garagens modernas costumam depender de:

• oxmysql (banco de dados)
• ox_lib (interface/menus)
• Seu framework (es_extended / qb-core / qbx_core)
• Um sistema de target para interação (ex.: ox_target), se a garagem usar “olhar para o marcador para abrir”

Confirme que esses iniciam antes da garagem.

Passo 2 — Adicione o recurso + importe o SQL

1. Jogue a pasta da garagem em resources/.
2. Importe o .sql dela (garagens costumam adicionar uma tabela de veículos guardados / estados da garagem). Faça backup primeiro.
3. Se ela se conecta à sua tabela owned_vehicles existente, não crie uma duplicada — leia a documentação.

Passo 3 — Ordem de carga

ensure oxmysql
ensure ox_lib
ensure es_extended
ensure ox_target
ensure minha-garagem

Passo 4 — Configure locais, spawns e blips

Essa é a parte que faz uma garagem parecer boa:

• Locais das garagens — coordenadas onde os jogadores abrem o menu.
• Pontos de spawn — onde o veículo aparece de fato. Deixe longe da geometria para os carros não nascerem dentro de uma parede.
• Blips — marcadores no mapa para os jogadores acharem as garagens.
• Categorias de veículos — carros, barcos, aeronaves em garagens separadas, se o seu script suportar.
• Apreensão / veículos perdidos — para onde os carros vão quando destruídos, e a taxa para recuperá-los.

Passo 5 — Teste o ciclo completo

• Compre ou spawne um veículo do jogador.
• Guarde na garagem.
• Reconecte, reabra a garagem, retire o mesmo veículo (placa correta, estado de dano se suportado).
• Destrua um carro e recupere-o da apreensão.

Se um carro guardado não volta, quase sempre é divergência de placa entre a tabela da garagem e a tabela de propriedade.

Escolhendo um script de garagem

As garagens padrão dos frameworks funcionam, mas parecem datadas. As opções pagas trazem interiores personalizáveis, garagens compartilhadas/de facção, gestão de placas e uma interface moderna. Há opções pagas respeitadas em todo o ecossistema; uma escolha polida e multi-framework é a Quasar Garages, que oferece garagens pessoais decoradas, vários interiores IPL e permissões de acesso — dá para ver na Quasar Store. Escolha o que escolher, verifique o resmon sob carga, porque uma garagem que faz checagens de distância a cada frame pode custar FPS em silêncio — veja nosso guia de otimização.

Para onde ir agora

A garagem é uma peça de uma experiência de veículos coerente. Junte a ela um HUD limpo e um inventário sólido (para o porta-malas), e você tem as bases de uma economia de roleplay crível.