Skip to content
⌘ K

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

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