This commit is contained in:
Nordi98 2025-07-01 07:06:04 +02:00
parent 1ed76cfb9b
commit 6c91401253
15 changed files with 1112 additions and 0 deletions

View file

@ -0,0 +1,31 @@
# QB Vehicle Tracker
![QB Vehicle Tracker#1](https://github.com/nitrou5/qb-vehicle-tracker/blob/main/img/vehicletracker.png?raw=true)
![QB Vehicle Tracker#2](https://github.com/nitrou5/qb-vehicle-tracker/blob/main/img/vehicletrackertablet.png?raw=true)

a simple Vehicle GPS Tracker resource for QBCore.

## Dependencies
- [qb-core](https://github.com/qbcore-framework/qb-core)
- [ox_lib](https://github.com/overextended/ox_lib)

## Installation
1) Add the following items into your qb-core/shared/items.lua:
```
vehicletracker = { name = 'vehicletracker', label = 'Vehicle GPS Tracker', weight = 1000, type = 'item', image = 'vehicletracker.png', unique = true, useable = true, shouldClose = true, combinable = nil, description = 'A device placed to track a vehicle\'s location.'},
vehicletrackertablet = { name = 'vehicletrackertablet', label = 'Vehicle Tracker Tablet', weight = 1000, type = 'item', image = 'vehicletrackertablet.png', unique = true, useable = true, shouldClose = true, combinable = nil, description = 'Connects to a vehicle tracker to show it\'s location.'},
vehicletrackerscanner = { name = 'vehicletrackerscanner', label = 'Vehicle Tracker Scanner', weight = 1000, type = 'item', image = 'vehicletrackerscanner.png', unique = true, useable = true, shouldClose = true, combinable = nil, description = 'Scans a vehicle for existence of GPS tracker.'},
```

2) Move all images from img/ folder to your inventory image folder. example qb-inventory/html/images

3) Run **sql/vehicle_trackers.sql** to create the DB table

## Usage
- You must be near a vehicle and **USE** the **vehicletracker** item.
- After using the vehicletracker **USE** the **vehicletrackertablet** you will receive to check its Location.
- **vehicletrackerscanner** can be used to scan and remove a tracker from a vehicle.
https://github.com/nitrou5/qb-vehicle-tracker/assets/157820969/0c1bbd8a-f526-43e2-979f-20c724e4a503

## Notes
- Trackers records older than 7 days will be automatically deleted from DB table. If you want to change/stop this behaviour refer to onResourceStart event handler in server/server.lua