# Installation Guide

{% tabs %}
{% tab title="ESX" %}

This guide will provide step-by-step instructions on how to install and set up the KQ\_SMUGGLERS script for FiveM. This script requires the ESX framework to be installed and running on your server.

### Step 0: <a href="#step-0" id="step-0"></a>

Before installing KQ\_SMUGGLERS, make sure that the `kq_lootareas` script is already installed and started on your server. You can download and install `kq_lootareas` from <https://kuzquality.com/package/5355106>.

### Step 1: <a href="#step-1" id="step-1"></a>

After downloading the KQ\_SMUGGLERS script, unzip the folder and place it in the `resources` directory on your FiveM server.

### Step 2: <a href="#step-2" id="step-2"></a>

Next, you need to import the `kq_smugglers.sql` file into your database. This will create data (items) required for the script to function properly. You can watch this video for instructions on how to import an SQL file into your database: <https://www.youtube.com/watch?v=xBbqDLXrZGY>.

### Step 3: <a href="#step-3" id="step-3"></a>

Once the SQL file has been imported, open the `config.lua` file in the KQ\_SMUGGLERS script folder and make sure that the correct framework is enabled.

### Step 4: <a href="#step-4" id="step-4"></a>

After the config file has been set up, add the KQ\_SMUGGLERS script to your `server.cfg` file. Make sure that it's added **after** the ESX framework, so that it loads and starts properly.

### Step 5: <a href="#step-5" id="step-5"></a>

⚠ Make sure that any script isn't preventing the plane nor pilot from spawning. Anti-cheats often have the `shamal` plane blacklisted!

* plane model = 'shamal'
* plane object model = 'ex\_prop\_exec\_crashedp'
* pilot model = 's\_m\_m\_pilot\_01'
* cartel model = 'g\_m\_m\_armlieut\_01'
  {% endtab %}

{% tab title="QBCore" %}

This guide will provide step-by-step instructions on how to install and set up the KQ\_SMUGGLERS script for FiveM. This script requires the QBCore framework to be installed and running on your server.

### Step 0: <a href="#step-0" id="step-0"></a>

Before installing KQ\_SMUGGLERS, make sure that the `kq_lootareas` script is already installed and started on your server. You can download and install `kq_lootareas` from <https://kuzquality.com/package/5355106>.

### Step 1: <a href="#step-1" id="step-1"></a>

After downloading the KQ\_SMUGGLERS script, unzip the folder and place it in the `resources` directory on your FiveM server.

### Step 2: <a href="#step-2" id="step-2"></a>

Add the items to your qb-core shared.lua file `qb-core/shared/items.lua` or `qb-core/shared.lua`

### Step 3: <a href="#step-3" id="step-3"></a>

Open the `config.lua` file in the KQ\_SMUGGLERS script folder and make sure that the correct framework is enabled.

### Step 4: <a href="#step-4" id="step-4"></a>

After the config file has been set up, add the KQ\_SMUGGLERS script to your `server.cfg` file. Make sure that it's added **after** the ESX framework, so that it loads and starts properly.

### Step 5: <a href="#step-5" id="step-5"></a>

⚠ Make sure that any script isn't preventing the plane nor pilot from spawning. Anti-cheats or qb-smallresources often have the `shamal` plane blacklisted!

* plane model = 'shamal'
* plane object model = 'ex\_prop\_exec\_crashedp'
* pilot model = 's\_m\_m\_pilot\_01'
* cartel model = 'g\_m\_m\_armlieut\_01'
  {% endtab %}
  {% endtabs %}