# 🚗  Garage - Job Vehicle Management

### Welcome to NS Garage!

NS Garage is a comprehensive FiveM resource for managing job vehicles across your server. Perfect for police departments, sheriff offices, EMS, mechanics, and any job that requires vehicle fleet management.

***

### 🎯 What is NS Garage?

This script provides a complete vehicle assignment and management system for job-based organizations. Bosses can assign vehicles to employees, track vehicle usage, manage stock, and return abandoned vehicles - all through an intuitive modern UI.

Perfect for roleplay servers looking to add professional vehicle fleet management without complexity.

***

### ✨ Core Features

#### 👔 Boss Management System

* **Web-Based Boss Menu** - Modern, responsive interface
* **Employee Vehicle Assignment** - Assign specific vehicles to employees
* **Stock Management** - Purchase vehicles for your fleet
* **Vehicle Removal** - Remove vehicles from employees
* **Return System** - Return any employee's vehicle to garage
* **Overview Dashboard** - See all employees and vehicles at a glance

#### 🚓 Employee Features

* **Request Vehicles** - Take out assigned vehicles from garage
* **Park Vehicles** - Return vehicles to garage
* **Personal Return** - Return your own vehicles from menu
* **Multiple Assignments** - Can have multiple vehicles assigned
* **NPC Interaction** - Interact with garage attendant NPCs

#### 🎨 Multi-Job Support

* **Unlimited Jobs** - Configure as many jobs as needed
* **Custom Garages** - Multiple garage locations per job
* **Job-Specific Vehicles** - Each job has its own vehicle list
* **Role Requirements** - Set minimum grade for boss access
* **Custom Plates** - Job-specific plate prefixes (POL, SHF, etc.)

#### 📍 Location System

* **Multiple Garages per Job** - Set up garage locations anywhere
* **NPC Attendants** - Customizable ped models and positions
* **Spawn Points** - Configure multiple vehicle spawn locations
* **Boss Menu Location** - Separate boss menu access point
* **Interaction Distance** - Adjustable interaction ranges

#### 🚗 Vehicle Management

* **Purchase System** - Buy vehicles using society money
* **Stock Tracking** - Monitor available vehicle stock
* **Plate Generation** - Automatic custom plate assignment
* **Vehicle Properties** - Save/restore vehicle modifications
* **Spawn Blocking Detection** - Prevents spawn issues

#### 🔗 Framework Support

* ✅ **QBCore** - Full support
* ✅ **ESX** - Full support
* ✅ **QBox** - Full support
* 🔄 Automatic framework detection

#### 🔌 Integration Support

**Society/Banking:**

* Auto-detection
* renewed-banking
* qb-banking
* qb-management
* esx\_society
* Custom integration

**Fuel Systems:**

* LegacyFuel
* ps-fuel
* ox\_fuel
* lj-fuel
* tam-fuel
* Custom integration

**Vehicle Keys:**

* qb-vehiclekeys
* qbx\_vehiclekeys (qbox)
* ox\_lib keys
* wasabi\_carlock
* renewed\_vehiclekeys
* esx\_vehicleshop keys
* ps-vehiclekeys
* mrnewb\_vehiclekeys
* Custom integration

**Notifications:**

* QB-Core
* ox\_lib
* okokNotify
* ESX
* Custom integration

**Inventory (Trunk/Glovebox):**

* ox\_inventory
* qb-inventory
* ps-inventory
* lj-inventory
* Disable option

#### 🎮 Target System Support

* ✅ **ox\_target** - Modern targeting
* ✅ **qb-target** - QB targeting
* ✅ **Draw Text** - Built-in fallback (no target needed)

#### 🌍 Localization

* 🇬🇧 **English** - Complete translation
* 🇧🇬 **Bulgarian** - Complete translation
* 🇪🇸 **Spanish** - Complete translation
* 📝 Easy to add more languages
* JSON-based locale system

#### 🛡️ Security Features

* **Grade-Based Access** - Boss menu restricted by minimum grade
* **Permission Checks** - All actions verified server-side
* **Return Cooldown** - Prevent return system abuse
* **Spawn Validation** - Checks for blocked spawn points
* **Society Funds Check** - Validates purchases

#### 📊 Advanced Features

* **Vehicle Return Cooldown** - Configurable cooldown system
* **Personal Return** - Employees can return their own vehicles
* **Boss Return** - Bosses can return any vehicle
* **Vehicle Status Tracking** - See which vehicles are out/in garage
* **Stock Purchase System** - Buy multiple vehicles at once
* **Real-time Updates** - All changes sync immediately

***

### 🔧 Technical Specifications

#### Dependencies

* ✅ **ox\_lib** (Required) - Menu and UI framework
* ✅ **oxmysql** (Required) - Database operations
* ✅ Framework (QBCore/ESX/QBox)
* ✅ Target system (ox/qb) - Optional, has built-in fallback

#### Performance

* 🚀 **Optimized** - 0.00ms idle
* 💾 **Database Efficient** - Clean SQL queries
* 🔄 **Real-time Sync** - Instant updates

#### Database

* **Auto-Setup** - Tables created automatically
* **Table Name** - Configurable (default: `job_vehicles`)
* **Saves**: Vehicle plate, model, job, owner, status, properties

***

### 📋 Server Requirements

Before installing, ensure you have:

* ✅ **FiveM Server** (Latest artifact recommended)
* ✅ **ox\_lib** resource
* ✅ **oxmysql** resource
* ✅ **Framework**: QBCore, ESX, or QBox
* ✅ **MySQL/MariaDB** database
* ✅ **Target System** (optional): ox\_target or qb-target

***

### 🚀 Quick Overview

#### For Bosses

1. Access boss menu at configured location
2. View all employees and their assigned vehicles
3. Assign vehicles to employees
4. Purchase vehicles for stock
5. Return abandoned vehicles
6. Remove vehicles from employees

#### For Employees

1. Go to garage NPC
2. Request your assigned vehicle
3. Vehicle spawns at designated spot
4. Park vehicle when done
5. Or return from menu anywhere

***

### 💼 Perfect For

**Job Types:**

* 🚓 Police Departments
* 🚑 EMS/Medical Services
* 🔧 Mechanic Shops
* 👮 Sheriff Offices
* 🚁 Any job needing vehicles

**Server Types:**

* 🎭 Roleplay Servers
* 🏢 Whitelist Jobs
* 👥 Government Roles
* 🏆 Professional Organizations

***

### 🎯 Use Cases

#### Police Department

* Assign patrol cars to officers
* Helicopter access for air units
* Rank-based vehicle restrictions
* Fleet management for chiefs
* Return abandoned units

#### Sheriff Office

* Multiple garage locations (Sandy, Paleto)
* Different vehicles per location
* Coordinated fleet across county
* Helipad access

#### Mechanic Shop

* Assign tow trucks
* Flatbed distribution
* Work vehicle management
* Shop fleet control

#### Custom Jobs

* Configure any job name
* Set custom vehicles
* Define garage locations
* Custom plate prefixes

***

### 📦 What's Included

* ✅ Complete resource files
* ✅ Configuration file (config.lua)
* ✅ Discord webhook support (webhook.lua)
* ✅ Custom edit functions (edit.lua)
* ✅ Locale files (EN, BG, ES)
* ✅ Modern web UI
* ✅ Example job configurations
* ✅ NPC ped models

***

### 🆚 Why Choose NS Garage?

**vs Other Garage Scripts:**

* ✅ Job-specific vehicle assignment
* ✅ Boss management system
* ✅ Stock purchase system
* ✅ Multiple garages per job
* ✅ Modern web-based UI
* ✅ Extensive integrations
* ✅ Active support

**Advantages:**

* Easy to configure
* No framework modifications needed
* Works with existing systems
* Professional appearance
* Regular updates

***

### 💬 Support & Community

Need help or want to share feedback?

* 💬 **Discord**: [Discord](https://discord.gg/gVMh5MfAWZ)
* 🌟 **Tebex Store**: [Tebex](https://nss.tebex.io/)
* 📝 **Documentation**: You're reading it!

***

### 📄 License

This resource is a **paid** product. Redistribution or resale is strictly prohibited. By using this resource, you agree to our Terms of Service.

***

### 🎉 Ready to Transform Your Server?

NS Garage brings professional vehicle fleet management to your FiveM server with minimal setup and maximum features.

**Start now**: [Installation Guide →](https://ns-scripts.gitbook.io/ns-scripts/pay-scripts/garage-job-vehicle-management/installation-guide)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ns-scripts.gitbook.io/ns-scripts/pay-scripts/garage-job-vehicle-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.