1
0
Fork 0
forked from Simnation/Main
Main/resources/[carscripts]/qb-vehicle-tracker/README.md

32 lines
2.1 KiB
Markdown
Raw Normal View History

2025-07-01 07:06:04 +02:00
# 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