🧠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.