Installation


Dependancies

ox_lib (required)
oxmysql (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 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

Last updated