BB Garages

BB Garages - Advanced Vehicle Management System for QBCore

Revolutionize how your players interact with vehicles using BB Garages, a comprehensive garage and vehicle management system built specifically for QBCore servers. This isn't just another basic garage script - it's a complete vehicle storage ecosystem that handles everything from spawning and storing to impounding and damage persistence. Whether you're upgrading from the default qb-garages or building a new server from scratch, BB Garages provides the professional-grade vehicle management your community deserves.

Developed by barbaroNN, known for creating the highest-quality QBCore resources in the FiveM community, BB Garages represents years of refinement based on feedback from hundreds of servers. The system seamlessly integrates with QBCore's vehicle ownership database while adding critical features like damage persistence, fuel state saving, impound management, and multi-garage support across your entire map. Players can access their vehicles from any configured garage location, with intelligent systems that track where each vehicle was last parked and prevent duplication exploits.

What's Included

BB Garages arrives as a complete package ready for immediate deployment on your server. The script includes pre-configured garage locations covering all major city areas - Los Santos downtown, Sandy Shores, Paleto Bay, and specialized locations like LSPD impound lots and premium private garages. Each garage can be customized with unique vehicle spawn points, access restrictions (public, job-locked, gang-locked, or property-locked), and visual branding that fits your server's aesthetic.

The system comes with an intuitive UI that displays vehicle information at a glance - model name, plate number, current fuel level, damage status, and storage location. Players can preview vehicles before spawning, see which garage holds each of their cars, and transfer vehicles between storage locations (if configured). Administrative tools are built directly into the script, allowing staff to impound vehicles, force-spawn player cars for troubleshooting, and monitor garage usage across the server.

Key Features

• Damage Persistence System - Vehicles remember their exact damage state when stored, including body damage, engine health, and broken parts
• Fuel State Saving - Gas levels are preserved when storing vehicles, preventing the exploit of using garages to refuel for free
• Multi-Garage Network - Players access all owned vehicles from any public garage, or configure private garages for exclusive access
• Impound System - Built-in impound lot functionality with configurable fees, police-only access, and tow truck integration
• Vehicle Preview - See 3D vehicle models in the UI before spawning, helping players identify cars by appearance
• Spawn Point Management - Intelligent spawn location selection prevents vehicle collision and ensures smooth spawning
• Job Garages - Configure dedicated garages for police, EMS, mechanic, and custom jobs with job vehicle access
• Gang Territory Garages - Create gang-specific storage locations that only members can access
• Property Integration - Link garages to housing scripts for private residential parking
• Anti-Duplication Protection - Robust server-side checks prevent vehicle duplication exploits
• State Transfer System - Vehicles transition between states (out, stored, impounded) with full logging
• Database Migration Tools - Includes SQL scripts to convert from default qb-garages or other vehicle systems
• Admin Commands - Force spawn, impound, delete, or transfer vehicles with administrative permissions
• Parking Spot System - Optional parking locations where players can store vehicles outside garages
• Performance Optimized - 0.00ms idle, minimal resmon during garage interactions

Perfect For

• QBCore servers needing reliable, professional vehicle management
• Servers upgrading from limited default garage scripts
• Roleplay communities wanting immersive vehicle storage with damage/fuel persistence
• Servers with multiple cities, towns, or large maps requiring distributed garage access
• Economy-focused servers where impound fees and retrieval costs matter
• Servers running housing systems that need integrated property parking
• Communities with active police departments using impound mechanics

Technical Details

• Framework: QBCore (designed specifically for QB-Core architecture)
• Performance Impact: 0.00ms idle, ~0.01-0.02ms during garage UI interactions
• Database: Custom bbvehicles table or configurable to use existing player_vehicles structure
• Dependencies: QBCore framework, qb-target or ox_target for interaction points
• Optional Integrations: qb-housing, qb-apartments, qb-policejob, qb-ambulancejob
• Customization: 100+ config options for locations, fees, restrictions, and behavior

Database Migration Made Easy

Switching to BB Garages from another system is straightforward thanks to included SQL migration scripts. The package provides conversion queries that transfer all vehicle data from the default qb-garages player_vehicles table to the optimized bbvehicles structure. The migration preserves critical information like ownership (citizenid), license plates, vehicle models, and mods/customizations.

For servers currently running player_vehicles, the provided SQL commands handle the conversion automatically. The script safely copies all existing vehicle data, initializes the new damage and fuel tracking columns, sets default parking states for vehicles currently out in the world, and assigns appropriate impound statuses for missing vehicles. Post-migration verification queries are included to confirm all vehicles transferred successfully and no data was lost in the conversion process.

Installation

1. Extract bb-garages to your server resources folder
2. Run the provided SQL file to create the bbvehicles table (or use migration scripts if converting from existing system)
3. Configure garage locations in config.lua - dozens of preset locations included
4. Set up impound lot locations and retrieval fees
5. Configure job garages for police, EMS, and other server jobs
6. Add 'ensure bb-garages' to server.cfg and restart
7. Test vehicle storage, spawning, and state persistence

Garage Types and Configurations

BB Garages supports multiple garage types to accommodate different server needs. Public garages are accessible to all players and display their personally-owned civilian vehicles. These locations typically appear in parking lots, along major streets, and in residential areas. Players can store and retrieve vehicles from any public garage, with the system tracking which location currently holds each car.

Job garages provide access to department vehicles for police, EMS, mechanics, and custom jobs. These locations are restricted by job name and sometimes by job grade, ensuring only authorized personnel can spawn emergency vehicles or work trucks. Job garages can pull from shared job vehicle pools or allow employees to store personal work vehicles. The system tracks job vehicle spawns to prevent duplication while allowing multiple officers to use identical patrol cars.

Gang garages create territory-based storage for criminal organizations. Configure these garages in gang headquarters or territory zones, restricting access to members only. Gang leaders can use these locations to store shared resources like getaway vehicles, armored trucks, or specialized equipment cars. The script integrates with qb-gangs or similar gang management systems to verify membership before granting access.

Impound lots serve as penalty storage for abandoned, illegal, or police-seized vehicles. Players must pay configurable fees to retrieve impounded cars, with costs scaling based on how long the vehicle's been impounded. Police can impound player vehicles through commands or integrated scripts, sending them to the pound with notes visible to players explaining why their car was seized. Unclaimed vehicles can be automatically deleted after configured time periods to keep the database clean.

Damage and Fuel Persistence

One of BB Garages' most valuable features is true vehicle state persistence. When players store a damaged vehicle with a broken windshield, dented fenders, and 40% engine health, that exact damage state is saved to the database. When they retrieve the car later - even days later from a different garage - it spawns with identical damage. This creates realistic consequences for reckless driving and encourages players to visit mechanics for repairs rather than using the garage as a free reset.

Fuel persistence works the same way. A car stored with 15% fuel spawns with 15% fuel when retrieved. Players can't use garages to magically refill their tanks, maintaining the value of gas stations and fuel economy mechanics. The system saves precise fuel percentages, not rounded values, ensuring accuracy across multiple store/retrieve cycles. Combined with damage persistence, this creates a realistic vehicle ownership experience where cars require actual maintenance and care.

What Makes BB Garages Stand Out

BB Garages isn't trying to reinvent vehicle management - it's perfecting it. barbaroNN built this system after observing the limitations and bugs in countless garage scripts across hundreds of servers. The result is a script that handles every edge case, prevents every known exploit, and provides smooth, reliable performance under heavy server load. Vehicle duplication? Impossible with the built-in state validation. Garage camping? Spawn location randomization prevents it. Missing vehicles? The impound system captures them automatically.

The script's architecture prioritizes server performance without sacrificing features. Intelligent caching reduces database queries, client-server communication is optimized to minimize network overhead, and UI rendering uses efficient frameworks that don't tank FPS. Even servers with thousands of vehicles in the database maintain instant garage menu load times. The code is clean, well-documented, and designed for easy customization by server developers who want to add unique features.

Support for BB Garages goes beyond basic troubleshooting. barbaroNN provides extensive documentation covering every configuration option, example setups for common scenarios, and video guides for complex integrations. The Discord support community includes server owners who've successfully implemented advanced configurations like property-linked parking, shared gang storage, and custom job vehicle systems. When framework updates arrive, BB Garages receives compatibility updates quickly, ensuring your vehicle system never breaks due to QBCore changes.

Advanced Configuration Options

Server owners can fine-tune every aspect of the garage experience through the extensive config.lua file. Set different impound fees for different vehicle classes - cheap fees for compact cars, expensive fees for supercars. Configure how long vehicles can sit before auto-impounding, encouraging players to regularly use their cars or risk losing access. Set maximum vehicle limits per player to prevent garage hoarding, or create VIP tiers with increased storage capacity.

Spawn point behavior is fully configurable. Choose whether vehicles spawn in fixed locations, randomly selected spots within a zone, or the closest available space to the garage interaction point. Set minimum spacing between spawned vehicles to prevent collision, configure spawn heading for consistent orientation, and define backup spawn locations if primary spots are blocked. The system can even validate that spawn locations are clear before attempting to spawn, preventing the frustration of vehicles spawning inside other cars.

Access control goes beyond simple job checks. Configure garages to require specific items (parking permits, garage keys), charge access fees each time the menu is opened, or limit access to players with certain licenses. Create premium garages that charge storage fees while providing benefits like free repairs or cosmetic washes. The flexibility allows you to create unique garage experiences that match your server's economy and roleplay style.

Migration SQL Scripts Explained

The provided SQL migration scripts handle the technical complexity of switching to BB Garages. The first script creates the bbvehicles table structure with proper indexes for performance. The second script copies all vehicle data from player_vehicles to bbvehicles, matching columns and converting data types as needed. The third script initializes new columns like damage stats and fuel levels with sensible defaults - setting fuel to 100% and damage to minimal for existing vehicles.

State conversion logic determines whether each migrated vehicle should be marked as stored, out, or impounded based on its current status in the old system. Vehicles marked as stored remain stored. Vehicles currently out in the world receive special handling - they can be auto-impounded or left in an out state for players to store manually. The parking location field gets set appropriately, with stored vehicles assigned to the nearest garage and out vehicles marked with empty parking data until they're stored properly.

Video Preview

Database Conversion Reference

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

Related QBCore Scripts

• Punch Machine V2
• CD Dispatch
• LMX iFruitPods
• UZ Cargo Job Shipping