🚁Drone Drops!

Installation Guide!

A customizable drone delivery system for GTA V FiveM servers, featuring randomized drops, configurable locations, alerts, and interactive case retrieval.

---

📦 Requirements

Before installing, ensure you have:

• A working FiveM server

• An item system (like ox_inventory, qb-core, or equivalent)

• A targeting system (e.g. ox_target)

• Bridge Resource: xmmx_bridge

---

🔧 Installation Steps

1. Download the Resource

Download the xmmx_dronedrops resource into your resources/[local] folder.

Keymaster: https://keymaster.fivem.net/asset-grants

2. Add to server.cfg

Ensure the script starts by adding to your server config:

ensure xmmx_bridge
ensure xmmx_dronedrops

---

⚙️ Configuration Overview

Open config.lua to customize how drone drops function. Here's a breakdown:

🔹 General Settings

Option	Description	Example
DropItem	The item required to call a drone	"xm_dronebeacon"
Timeout	Time (in minutes) the drone stays on map	30
AlertAll	Should everyone be alerted	true or false
ExcludeJobs	Jobs that cannot see the alert	{ "police", "trooper" }

🔹 Props

Drones and cases are props spawned in the world:

Props = {
  Drone = { Model = "xs_prop_arena_drone_01" },
  Case = {
    [1] = { Model = "prop_security_case_01", Offset = vec3(0, 0, 0.11) },
    [2] = { Model = "prop_ld_suitcase_02", Offset = vec3(0, 0, 0.21) },
    [3] = { Model = "prop_idol_case_01", Offset = vec3(0, 0, 0.13) },
  }
}

🔹 Blip Configuration

Custom blip when a drone spawns:

Blip = {
  label = "Drone Drop",
  sprite = 161,
  scale = 2.0,
  color = 1,
  alpha = 180
}

---

📍 Drop Locations

Edit or add spawn locations via the Locations list:

Locations = {
  vec4(1664.361, -28.181, 198.0, 100.0), -- Water Damn Tower
  vec4(721.64, 1293.75, 364.25, 91.1),   -- Vinewood Hills Satellite
  ...
}

These are randomized unless you enforce a selection logic manually.

---

🎁 Drone Rewards

Customize the items found in each drop:

Rewards = {
  ["Test Drop"] = {
    description = "Test location 1",
    ["sandwich"] = 1,
    ["water"] = 1
  },
  ["Test Drop 2"] = {
    description = "Test location 2",
    ["sandwich"] = 1,
    ["water"] = 1
  }
}

• RandomReward = true will pick one of the entries randomly.

• RewardsAmt = 8 controls the total options in the menu if RandomReward = false.

---

🌐 Localization

All Menu and Notification text is editable in the Locales table:

Locales = {
  DroneMenu   = "Drone Drop Menu",
  MenuDesc    = "Request this drone drop?",
  DroneLabel  = "Collect Case",
  DroneNotify = "Someone used a Drone Beacon. You have %s minutes to retrieve the case!",
}

---

🚨 Alerts & Sounds

When a drop is summoned, players are notified using:

AlertSound = {
  audio = "CHALLENGE_UNLOCKED",
  reference = "HUD_AWARDS"
}

Control who sees alerts with:

AlertAll = true
ExcludePD = true
ExcludeJobs = { "police", "trooper" }

---

🎮 In-Game Use

1. Use the item defined in DropItem (e.g., xm_dronebeacon)

2. Confirm summon via menu

3. A drone will fly to a random location and drop a case

4. Players can collect the case using target interaction (ox_target)

5. After Timeout minutes, the case disappears

---

🧪 Debugging & Version Check

• Enable debug logs with:

  Debug = true

• Enable version check (recommended):

  Version = true

---

🧼 Cleanup

• Cases remove themselves after timeout

• You can manually despawn drones/cases by editing server-side logic

---