Installation

---

Dependancies

ox_lib (required)
oxmysql (required)
screenshot-basic (required)
ox_inventory / tgiann-inventory (required)
qb-target / ox_target (required)
lb-phone / lb-tablet (optional)
fivemanage / fivemerr / discord webhook (optional for photo/video functionality)

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 HERE

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