Inventories: All inventory functions are editable. Any inventory system that supports item metadata functionality can be compatible. ox_inventory & tgiann-inventory work out the box.
IMPORTANT: QB-INVENTORY IS NOT COMPATIBLE
1. Add to server resources
Drop the fiveous_drones folder into your server's resources directory.
Add to server.cfg:
ensure fiveous_drones
Important:fiveous_drones must start after all dependencies.
Inventory: ox_inventory or tgiann-inventory is required. qb-inventory is not supported because it does not reliably persist item metadata (drone serials, battery charge, etc.).
2. Add Items
You will find the tgiann and ox item configuration in INSTALL/items.lua, add these items into your inventory's config file
ox_inventory:ox_inventory/data/items.lua
tgiann-inventory:tgiann-inventory/items/items.lua
3. Add Item Images
Place your item images in your inventory's image folder:
ox_inventory:ox_inventory/web/images/
tgiann-inventory:inventory_images/images/
Files needed:
fiveous_drone.png
fiveous_controller.png
fiveous_battery.png
fiveous_drone_parts.png
4. How It Works
Step
What Happens
1
Player uses the Drone item from inventory
2
Drone prop (ch_prop_casino_drone_02a) spawns on the ground in front of them
3
Player gets a notification: "Use your controller or walk up to the drone to connect"
4
Player either uses the Controller item OR walks up and uses qb-target on the drone
5
Drone "spins up" for 2 seconds, then takes flight
6
Camera switches to drone POV — player ped stays behind doing a controller animation
7
If drone hits a wall/ground/object or is shot down → it crashes, a broken drone prop spawns at crash site
8
Anyone can walk up to the broken prop → qb-target prompt: "Salvage Crashed Drone" → receives fiveous_drone_parts with serial number, owner ID, cause of crash, and flight stats
9
If player presses L → drone lands safely, player can walk to it
10
Player walks up to landed drone → qb-target prompt: "Pick Up Drone" → item returned with all stats
Serial Numbers & Stats
Every drone gets a unique serial number (e.g. FVD-A3B7C2) on first use
The owner's citizen ID is stamped on the drone metadata
Flight stats track: total flights, distance flown (metres), and battery swap cycles
All metadata persists through the item — pick up, put down, trade, crash
When a drone crashes, the parts carry the same serial + stats + cause of death
5. Controls (During Flight)
Key
Action
WASD
Fly forward/back/left/right
Mouse
Look / aim
Space
Fly up
X
Fly down
Shift
Fast speed
Ctrl
Slow/precise speed
Scroll
Adjust speed
Ctrl + Scroll
Adjust FOV (zoom)
G
Cycle post-FX filters
P
Capture photo (requires Fivemanage)
O
Start / stop recording (requires Fivemanage)
L
Land the drone
Z
Toggle HUD
6. Configuration
Everything is in config/config.lua & config/server_config.lua