# Installation

## ✈️ FRKN-CargoHeist

FRKN-CargoHeist is a cinematic multiplayer heist script designed for high-octane roleplay. Unlike traditional shootouts, this heist focuses on precision and teamwork: infiltrate a cargo plane, push out high-value vehicles mid-air, parachute down to secure them, load them into a transport truck, and drive to the drop-off zone for the final payout. This documentation covers installation, configuration, and basic system usage.

### 🧠 Installation Guide

1. Drag & drop the `frkn-cargoheist` folder into your resources directory.
2. Add `ensure frkn-cargoheist` to your `server.cfg`.
3. If item-based access is used (e.g., hacking device), make sure required items exist in your inventory/database.
4. Import the provided SQL files if the script saves cooldowns or heist history.
5. Edit `config.lua` to customize vehicle models and delivery locations.

### ⚙️ Configuration

Open `config.lua` to adjust the following settings:

* Heist Vehicles: Define which cars appear inside the cargo plane.
* Delivery Truck: Set the model of the transport truck used on the ground.
* Locations: Configure the drop zones, plane altitude, and final delivery point.
* Payout: Adjust the reward money or items upon successful delivery.
* Requirements: Set minimum police count or required items to start the heist.

### 🎯 Target Configuration

You must set the target system in `config.lua` to match your server's dependencies.

Lua

```
targetSettings = {
    name = 'qb-target',
}
```

* Use qb-target if you are using qb-target.
* Use ox\_target if you are using ox\_target.

### 🎮 How it Works

1. Infiltration: The team boards the cargo plane via a cutscene or coordinate.
2. The Drop: Players locate the vehicles inside the cargo hold and push them out of the ramp mid-air.
3. Parachute: The team jumps after the vehicles and parachutes to the landing zone.
4. Transport: On the ground, players must locate the dropped vehicles, load them onto the waiting delivery truck.
5. Delivery: Drive the truck to the designated drop-off point to complete the heist.

### 📌 Notes

* FRKN-CargoHeist works with ESX, QBCore, and Qbox.
* Ensure that the vehicle models used in the config are valid and streamed on your server.
* Restart the server after any config or SQL changes.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.0resmon.org/0resmon/0resmon-1/frkn-resources/frkn-cargo-plane-heist/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.