# ⚡ LG Thunder Garage
## Premium Vehicle Garage & Asset Management System
LG Thunder Garage is a complete FiveM garage system designed for **ESX, QB-Core and QBox** servers.
It provides public garages, private garages, job fleets, vehicle transfers, impounds, optional garage interiors and persistent vehicle condition data through a premium automotive management interface.
---
## ✨ Main Features
- 🚗 Public vehicle garages
- 🔐 Private garages
- 👮 Job and emergency vehicle garages
- 🚨 Advanced vehicle impound system
- 🏢 Optional garage interiors
- 🔄 Garage-to-garage vehicle transfers
- 👤 Player vehicle ownership transfers
- ⛽ Persistent fuel level
- 🛠️ Persistent engine, body and damage data
- 🎨 Vehicle liveries and extras
- 🖼️ Optional real vehicle images
- 📋 Vehicle search, filtering and sorting
- 🖥️ Grid and list display modes
- 🛡️ Server-side ownership and permission validation
- 🌍 Multi-language support
---
## 🎨 Premium Interface
LG Thunder Garage includes a completely redesigned automotive interface featuring:
- Dark premium vehicle terminal design
- Realistic vehicle presentation
- Vehicle condition indicators
- Fuel, engine and body status
- Vehicle plate and location information
- Responsive layouts
- Compact interior garage interface
- Technical image fallback for missing vehicle images
- Correct NUI focus and startup behavior
---
## 🏢 Garage Types
### Public Garages
Create configurable car, boat and aircraft garages with:
- Multiple spawn points
- Custom map blips
- E-key or target interaction
- Optional garage interiors
- Individual interior settings
- Vehicle type restrictions
### Private Garages
- Owner-restricted access
- Configurable private garage locations
- Optional interiors
- Custom access permissions
- Database persistence
### Job Garages
Suitable for:
- Police
- Ambulance
- Mechanic
- Taxi
- Government jobs
- Custom server jobs
Job vehicles can use:
- Minimum job grades
- Custom vehicle lists
- Liveries
- Extras
- Custom plates
- Maximum modifications
- Job-specific spawn points
---
## 🚨 Advanced Impound System
- Vehicle impound reason
- Retrieval cost
- Retrieval delay
- Retrievable or restricted vehicle states
- Job-restricted impound access
- Vehicle owner impound visibility
- Server-side retrieval validation
- Payment validation
- Automatic refund protection
- Vehicle ownership protection
Restricted vehicles remain visible in the impound interface but cannot be retrieved until permitted.
---
## ⛽ Persistent Vehicle Data
LG Thunder Garage can save and restore:
- Fuel level
- Engine health
- Body health
- Vehicle modifications
- Vehicle properties
- Vehicle deformation
- Vehicle damage
- Vehicle plate
- Garage location
- Vehicle state
Includes dedicated compatibility handling for `ox_fuel`.
---
## 🖼️ Vehicle Images
Vehicle images are optional.
```lua
Config.Interface.EnableVehicleImages = true
```
Supported image sources:
- Local vehicle images
- Vehicle-specific custom images
- GTA vehicle reference images
- Included fallback vehicle assets
Custom images can be placed inside:
```text
vehicle_images/.png
```
---
## 🔧 Framework Compatibility
- ✅ ESX
- ✅ QB-Core
- ✅ QBox
---
## 📦 Required Dependencies
- `ox_lib`
- `oxmysql`
- One supported framework:
- `es_extended`
- `qb-core`
- `qbx_core`
---
## 🔌 Optional Integrations
- `ox_target`
- `qb-target`
- `ox_fuel`
- Vehicle key systems
- Banking systems
- Society accounts
- Mileage systems
- Mechanic systems
- Dealership systems
- Notification systems
- Discord webhook logging
The resource can also be configured for direct **E-key interaction without NPCs or target systems**.
---
## 🌍 Included Languages
- English
- Simplified Chinese
- German
- French
- Spanish
- Italian
- Portuguese
- Dutch
- Swedish
- Danish
- Finnish
- Czech
- Hungarian
- Romanian
- Lithuanian
- Bulgarian
- Vietnamese
---
## 🔒 Cfx Asset Escrow
The core Lua logic is protected through the official **Cfx Asset Escrow** system.
Editable files include:
- Configuration files
- Locale files
- SQL files
- Vehicle image files
- Required integration settings
No custom IP lock, external license token or mandatory Discord verification is required.
---
## 📥 Installation
```cfg
ensure oxmysql
ensure ox_lib
ensure LG-ThunderGarage
```
Configure your framework, fuel system, vehicle keys, banking integration and garage locations before starting the resource.
---
## 🆕 Current Version
**Version 1.2.4**
Includes:
- Premium LG garage interface
- Public and private garages
- Job garages
- Garage interiors
- Vehicle transfers
- Persistent vehicle data
- Advanced impound system
- Realistic vehicle assets
- ESX, QB-Core and QBox bridges
- Improved fuel restoration
- Improved impound vehicle visibility
- Improved startup and NUI handling
---
⚡ **LG Thunder Garage — Premium Vehicle Management for FiveM**
