Garagens BB

BB Garages – Sistema Avançado de Gerenciamento de Veículos para QBCore

Revolucione a forma como seus jogadores interagem com veículos usando o BB Garages, um sistema abrangente de gerenciamento de garagens e veículos construído especificamente para servidores QBCore. Este não é apenas mais um script básico de garagem – é um ecossistema completo de armazenamento de veículos que lida com tudo, desde o spawn e armazenamento até o reboque e a persistência de danos. Se você está atualizando do qb-garages padrão ou construindo um novo servidor do zero, o BB Garages oferece o gerenciamento de veículos de nível profissional que sua comunidade merece.

Desenvolvido por barbaroNN, conhecido por criar os recursos QBCore de mais alta qualidade na comunidade FiveM, o BB Garages representa anos de aprimoramento baseado no feedback de centenas de servidores. O sistema se integra perfeitamente ao banco de dados de propriedade de veículos do QBCore, adicionando recursos críticos como persistência de danos, salvamento do estado do combustível, gerenciamento de reboque e suporte a várias garagens em todo o seu mapa. Os jogadores podem acessar seus veículos de qualquer local de garagem configurado, com sistemas inteligentes que rastreiam onde cada veículo foi estacionado pela última vez e evitam exploits de duplicação.

O que está incluído

O BB Garages chega como um pacote completo pronto para implantação imediata em seu servidor. O script inclui locais de garagem pré-configurados cobrindo todas as principais áreas da cidade – centro de Los Santos, Sandy Shores, Paleto Bay e locais especializados como pátios de reboque da LSPD e garagens privadas premium. Cada garagem pode ser personalizada com pontos de spawn de veículos exclusivos, restrições de acesso (público, trabalho-bloqueado, bloqueado por gangue ou bloqueado por propriedade) e branding visual que se adapta à estética do seu servidor.

O sistema vem com uma UI intuitiva que exibe informações do veículo rapidamente – nome do modelo, número da placa, nível atual de combustível, status de danos e local de armazenamento. Os jogadores podem visualizar os veículos antes de fazer o spawn, ver qual garagem guarda cada um de seus carros e transferir veículos entre locais de armazenamento (se configurado). Ferramentas administrativas são incorporadas diretamente ao script, permitindo que a equipe reboque veículos, force o spawn de carros de jogadores para solução de problemas e monitore o uso da garagem em todo o servidor.

Principais características

• Sistema de Persistência de Danos – Os veículos lembram seu estado exato de dano quando armazenados, incluindo danos na carroceria, saúde do motor e peças quebradas
• Salvamento do Estado do Combustível – Os níveis de gasolina são preservados ao armazenar veículos, evitando o exploit de usar garagens para reabastecer gratuitamente
• Rede Multi-Garagem – Os jogadores acessam todos os veículos próprios de qualquer garagem pública, ou configuram garagens privadas para acesso exclusivo
• Sistema de Apreensão – Funcionalidade de pátio de reboque integrada com taxas configuráveis, polícia-apenas acesso e integração de caminhão de reboque
• Prévia do veículo – Veja modelos de veículos 3D na UI antes de fazer o spawn, ajudando os jogadores a identificar carros pela aparência
• Gerenciamento de Pontos de Spawn – A seleção inteligente do local de spawn evita colisão de veículos e garante um spawn suave
• Garagens de emprego – Configure garagens dedicadas para polícia, EMS, mecânico e trabalhos personalizados com acesso a veículos de trabalho
• Garagens de Território de Gangue – Crie locais de armazenamento específicos para gangues que apenas membros podem acessar
• Integração de propriedades – Vincule garagens a scripts de moradia para estacionamento residencial privado
• Proteção contra duplicação – Verificações robustas do lado do servidor evitam exploits de duplicação de veículos
• Sistema de Transferência de Estado – Os veículos transitam entre estados (fora, armazenado, rebocado) com registro completo
• Ferramentas de Migração de Banco de Dados – Inclui scripts SQL para converter de qb-garages padrão ou outros sistemas de veículos
• Comandos de administrador – Forçar spawn, apreender, deletar ou transferir veículos com permissões administrativas
• Sistema de Estacionamento – Locais de estacionamento opcionais onde os jogadores podem guardar veículos fora das garagens
• Desempenho otimizado – 0.00ms ocioso, resmon mínimo durante interações com a garagem

Perfeito para

• Servidores que precisam de gerenciamento de veículos confiável e profissional
• Servidores que estão atualizando de scripts de garagem padrão limitados
• Comunidades que desejam armazenamento de veículos imersivo com persistência de danos/combustível
• Servidores com várias cidades, vilas ou mapas grandes que exigem acesso distribuído à garagem
• Servidores focados na economia onde as taxas de apreensão e os custos de recuperação são importantes
• Servidores que executam sistemas de habitação que precisam de estacionamento de propriedade integrado
• Comunidades com departamentos de polícia ativos usando mecânicas de apreensão

Detalhes técnicos

• Estrutura: (projetado especificamente para arquitetura )
• Impacto no desempenho: 0.00ms ocioso, ~0.01-0.02ms durante interações com a garagem
• Banco de dados: Tabela bbvehicles personalizada ou configurável para usar a estrutura player_vehicles existente
• Dependências: Framework QBCore, qb-target ou ox_target para pontos de interação
• Integrações opcionais: qb-housing, qb-apartments, qb-policejob, qb-ambulancejob
• Personalização: Mais de 100 opções de configuração para locais, taxas, restrições e comportamento

Migração de Banco de Dados Facilitada

Mudar para BB Garages de outro sistema é simples graças aos scripts de migração incluídos. O pacote fornece consultas de conversão que transferem todos os dados do veículo da tabela player_vehicles padrão do qb-garages para a estrutura otimizada do bbvehicles. A migração preserva informações críticas como propriedade (citizenid), placas, modelos de veículos e modificações/personalizações.

Para servidores que atualmente executam player_vehicles, os comandos fornecidos lidam com a conversão automaticamente. O script copia com segurança todos os dados de veículos existentes, inicializa as novas colunas de rastreamento de danos e combustível, define estados de estacionamento padrão para veículos atualmente “fora” no mundo e atribui status de apreensão apropriados para veículos ausentes. Consultas de verificação pós-migração são incluídas para confirmar que todos os veículos foram transferidos com sucesso e que nenhum dado foi perdido no processo de conversão.

Instalação

1. Extraia bb-garages para a pasta de recursos do seu servidor
2. Execute o arquivo fornecido para criar a tabela bbvehicles (ou use scripts de migração se estiver convertendo de um sistema existente)
3. Configure os locais da garagem em config.lua – dezenas de locais predefinidos incluídos
4. Configure os locais do pátio de apreensão e as taxas de recuperação
5. Configure garagens de trabalho para a polícia, e outros trabalhos do servidor
6. Adicione ‘ensure bb-garages’ ao server.cfg e reinicie
7. Teste de armazenamento de veículos, geração e persistência de estado

Tipos e Configurações de Garagens

BB Garages suporta múltiplos tipos de garagem para acomodar diferentes necessidades do servidor. Garagens públicas são acessíveis a todos os jogadores e exibem seus veículos civis de propriedade pessoal. Esses locais geralmente aparecem em estacionamentos, ao longo de ruas principais e em áreas residenciais. Os jogadores podem armazenar e recuperar veículos de qualquer garagem pública, com o sistema rastreando qual local atualmente guarda cada carro.

Garagens de trabalho fornecem acesso a veículos de departamento para polícia, EMS, mecânicos e trabalhos personalizados. Esses locais são restritos por nome de trabalho e, às vezes, por nível de trabalho, garantindo que apenas pessoal autorizado possa gerar veículos de emergência ou caminhões de trabalho. As garagens de trabalho podem usar pools de veículos de trabalho compartilhados ou permitir que os funcionários armazenem veículos de trabalho pessoais. O sistema rastreia as gerações de veículos de trabalho para evitar duplicação, permitindo que vários policiais usem carros de patrulha idênticos.

Garagens de gangues criam armazenamento baseado em território para organizações criminosas. Configure essas garagens em sedes de gangues ou zonas de território, restringindo o acesso apenas aos membros. Líderes de gangues podem usar esses locais para armazenar recursos compartilhados, como veículos de fuga, caminhões blindados ou carros de equipamentos especializados. O script se integra com qb-gangs ou sistemas de gerenciamento de gangues semelhantes para verificar a associação antes de conceder acesso.

Pátios de apreensão servem como armazenamento de penalidade para veículos abandonados, ilegais ou apreendidos pela polícia. Os jogadores devem pagar taxas configuráveis para recuperar carros apreendidos, com custos escalonados com base em quanto tempo o veículo foi apreendido. A polícia pode apreender veículos de jogadores por meio de comandos ou scripts integrados, enviando-os para o pátio com notas visíveis para os jogadores explicando por que seu carro foi apreendido. Veículos não reclamados podem ser automaticamente excluídos após períodos de tempo configurados para manter o banco de dados limpo.

Persistência de Danos e Combustível

Uma das características mais valiosas do BB Garages é a verdadeira persistência do estado do veículo. Quando os jogadores armazenam um veículo danificado com um para-brisa quebrado, para-lamas amassados e 40% de saúde do motor, esse estado exato de dano é salvo no banco de dados. Quando eles recuperam o carro mais tarde – mesmo dias depois de uma garagem diferente – ele aparece com o dano idêntico. Isso cria consequências realistas para a direção imprudente e incentiva os jogadores a visitar mecânicos para reparos, em vez de usar a garagem como um reset gratuito.

A persistência de combustível funciona da mesma forma. Um carro armazenado com 15% de combustível aparece com 15% de combustível quando recuperado. Os jogadores não podem usar garagens para reabastecer magicamente seus tanques, mantendo o valor dos postos de gasolina e da mecânica de economia de combustível. O sistema salva porcentagens precisas de combustível, não valores arredondados, garantindo precisão em vários ciclos de armazenamento/recuperação. Combinado com a persistência de danos, isso cria uma experiência realista de propriedade de veículos, onde os carros exigem manutenção e cuidado reais.

O que faz o BB Garages se Destacar

BB Garages não está tentando reinventar o gerenciamento de veículos – está aperfeiçoando-o. barbaroNN construiu este sistema após observar as limitações e bugs em inúmeros scripts de garagem em centenas de servidores. O resultado é um script que lida com todos os casos extremos, previne todos os exploits conhecidos e oferece desempenho suave e confiável sob forte carga do servidor. Duplicação de veículos? Impossível com a validação de estado integrada. Acampamento em garagem? A randomização do local de geração impede isso. Veículos perdidos? O sistema de apreensão os captura automaticamente.

A arquitetura do script prioriza o desempenho do servidor sem sacrificar recursos. O cache inteligente reduz as consultas ao banco de dados, a comunicação cliente-servidor é otimizada para minimizar a sobrecarga da rede e a renderização da interface do usuário usa estruturas eficientes que não afetam o FPS. Mesmo servidores com milhares de veículos no banco de dados mantêm tempos de carregamento instantâneos do menu da garagem. O código é limpo, bem documentado e projetado para fácil personalização por desenvolvedores de servidor que desejam adicionar recursos exclusivos.

O suporte para BB Garages vai além da solução básica de problemas. barbaroNN fornece documentação extensa cobrindo todas as opções de configuração, exemplos de configurações para cenários comuns e guias em vídeo para integrações complexas. A comunidade de suporte do Discord inclui proprietários de servidores que implementaram com sucesso configurações avançadas, como estacionamento vinculado a propriedades, armazenamento compartilhado de gangues e sistemas personalizados de veículos de trabalho. Quando as atualizações do framework chegam, o BB Garages recebe atualizações de compatibilidade rapidamente, garantindo que seu sistema de veículos nunca quebre devido a mudanças no FiveM.

Opções de configuração avançadas

Os proprietários de servidores podem ajustar todos os aspectos da experiência da garagem por meio do extenso arquivo config.lua. Defina diferentes taxas de apreensão para diferentes classes de veículos – taxas baratas para carros compactos, taxas caras para supercarros. Configure quanto tempo os veículos podem ficar antes da apreensão automática, incentivando os jogadores a usar regularmente seus carros ou arriscar perder o acesso. Defina limites máximos de veículos por jogador para evitar o acúmulo de garagens, ou crie níveis VIP com maior capacidade de armazenamento.

O comportamento do ponto de geração é totalmente configurável. Escolha se os veículos aparecem em locais fixos, pontos selecionados aleatoriamente dentro de uma zona ou o espaço disponível mais próximo do ponto de interação da garagem. Defina o espaçamento mínimo entre os veículos gerados para evitar colisão, configure a direção de geração para orientação consistente e defina locais de geração de backup se os pontos primários estiverem bloqueados. O sistema pode até validar se os locais de geração estão livres antes de tentar gerar, evitando a frustração de veículos gerando dentro de outros carros.

O controle de acesso vai além de simples verificações de trabalho. Configure garagens para exigir itens específicos (licenças de estacionamento, chaves de garagem), cobrar taxas de acesso cada vez que o menu é aberto ou limitar o acesso a jogadores com certas licenças. Crie garagens premium que cobram taxas de armazenamento, ao mesmo tempo em que oferecem benefícios como reparos gratuitos ou lavagens cosméticas. A flexibilidade permite que você crie experiências de garagem exclusivas que correspondam à economia e ao estilo de roleplay do seu servidor.

Scripts de Migração Explicados

Os scripts de migração fornecidos lidam com a complexidade técnica de mudar para o BB Garages. O primeiro script cria a estrutura da tabela bbvehicles com índices adequados para desempenho. O segundo script copia todos os dados do veículo de player_vehicles para bbvehicles, combinando colunas e convertendo tipos de dados conforme necessário. O terceiro script inicializa novas colunas como estatísticas de danos e níveis de combustível com padrões sensatos – definindo o combustível para 100% e o dano para o mínimo para veículos existentes.

A lógica de conversão de estado determina se cada veículo migrado deve ser marcado como armazenado, fora ou apreendido com base em seu status atual no sistema antigo. Veículos marcados como armazenados permanecem armazenados. Veículos atualmente “fora” no mundo recebem tratamento especial – eles podem ser apreendidos automaticamente ou deixados em um estado “fora” para os jogadores armazenarem manualmente. O campo de localização de estacionamento é definido apropriadamente, com veículos armazenados atribuídos à garagem mais próxima e veículos fora marcados com dados de estacionamento vazios até que sejam armazenados corretamente.

Prévia do vídeo

Referência de Conversão de Banco de Dados

Converter (bem, mais ou menos) executar em SQL:

INSERT INTO bbvehicles (citizenid,plate,model) SELECT citizenid,plate,vehicle FROM player_vehicles

UPDATE `bbvehicles` SET `stats`='{"damage":10,"fuel":98}' WHERE stats is NULL

UPDATE `bbvehicles` SET `props`='{}' WHERE props? is NULL

UPDATE `bbvehicles` SET `state`='impound' WHERE state = 'unknown' or state is NULL

UPDATE `bbvehicles` SET `parking` = '' WHERE parking is NULL

Scripts relacionados ao QBCore

• Máquina de soco V2
• CD Dispatch
• iFruitPods LMX
• UZ Cargo Job Shipping

Converter (bem, mais ou menos) executar em SQL:

INSERT INTO bbvehicles (citizenid,plate,model) SELECT citizenid,plate,vehicle FROM player_vehicles

UPDATE `bbvehicles` SET `stats`='{"damage":10,"fuel":98}' WHERE stats is NULL

UPDATE `bbvehicles` SET `props`='{}' WHERE props? is NULL

UPDATE `bbvehicles` SET `state`='impound' WHERE state = 'unknown' or state is NULL

UPDATE `bbvehicles` SET `parking` = '' WHERE parking is NULL