> For the complete documentation index, see [llms.txt](https://derass.gitbook.io/derass-script/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://derass.gitbook.io/derass-script/sell-drugs-to-npc/documentation.md).

# Documentation

## Setup your framework

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

#### Config

```
Config.framework = "esx"
```

{% endtab %}

{% tab title="QB-Core" %}

#### Config

```
Config.framework = "qbcore"
```

{% endtab %}
{% endtabs %}

## Setup your inventory system

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

#### Config

```
Config.inventoryType = "esx"
```

{% endtab %}

{% tab title="QB-Core" %}

#### Config

```
Config.inventoryType = "qbcore"
```

{% endtab %}
{% endtabs %}

## Config

#### Money type

```
Config.moneyType            = "money" -- Money type from your framework
```

{% hint style="info" %}
After each sell you get $$, chose your

It's 'money' by default
{% endhint %}

#### Use ox\_target

```
Config.useOxTarget          = true -- Use ox_target or not
```

{% hint style="info" %}
This script can works with ox\_target
{% endhint %}

{% hint style="info" %}
If you don't use ox\_target, you can configure IN-GAME, the keybind.\
By default **T**

<pre class="language-lua"><code class="lang-lua"><strong>RegisterKeyMapping('sellDrugs', 'Sell Drugs', 'keyboard', 't')
</strong></code></pre>

{% endhint %}

#### Cops required and Count

```
Config.copsCountRefreshTime = 5     -- Time in minutes to refresh cops count
Config.minCopsOnline        = 0         -- Cops required to sell drugs
```

#### Ped reject and Ped Call Cops

```lua
Config.pedReject            = 25    -- Percent chance that the ped will reject the drugs
Config.pedCallCops          = 25    -- Percent chance that the ped will call the cops
```

{% hint style="info" %}
You can configure the percentage of chance that the ped will refuse your drugs and the percentage that he will call the police after the refusal
{% endhint %}

#### BlacklistedJobs and CallCopsJobs

```lua
Config.blacklistedJobs      = { "police", "bcso", "ambulance" } -- Job that can't sell drugs
Config.callCopsJos          = { "police", "bcso" }   -- Job who receive alert when ped call cops
```

{% hint style="info" %}
**BlacklistestJobs** are not allowed to sell drugs

**CallCopsJobs** will receive alerte after peds call him
{% endhint %}

#### Max drugs to sell

```lua
Config.maxDrugsToSell       = 10    -- Max drugs to sell at once
```

{% hint style="info" %}
Tha maxium amount of drugs you can sell at once
{% endhint %}

#### Drugs amount for price variation and PriceVariation

```lua
Config.drugsSellQttyForVariation = 10 --Qtty of drugs to sell for price variation
Config.drugsPriceVariation       = 0.05   -- 0.5% of variation
```

{% hint style="info" %}
**drugsSellQttyForVariation** represents the amount of drugs that all players must sell for a price variation to occur\
**drugsPriceVariation** represents the variation in % which will be applied to the current price
{% endhint %}

### Drugs

```lua
Config.Drugs = {
    weed = {            -- Item name
        price = 60,     -- Price of the item
        min = 40,       -- Min price of the item
        max = 80,        -- Max price of the item
        variation = {   -- Item variation when you sell more than Config.drugsSellQttyForVariation
            'meth'      -- Item name
        }
    },
    coke = {
        price = 80,
        min = 60,
        max = 100,
        variation = {
            'weed',
            'meth'
        }
    },
    meth = {
        price = 70,
        min = 50,
        max = 90,
        variation = {
            'cook'
        }
    }
}
```

{% hint style="info" %}
Here you can add your own drugs

* The array must be the name item name in your database (Not the label)
* price : The default price of the item
* min : The minimum price of the item (cannot go under after variation)
* max : The maximum price of the item (cannot go upper after variation)
* variation : The list of other drugs which impacted by the variation (see exemple above)
  {% endhint %}

## Client : Notify.lua

#### Notify

{% hint style="info" %}
You can change the lib.notify by your own notification system
{% endhint %}

```lua
---@param message string
---@param type 'success' | 'error'
function notify(message, type)
    lib.notify({
        title = locale('sell_drugs'),
        description = message,
        type = type,
    })
end
```

#### Call cops event

{% hint style="info" %}
You can implemente your system for cops notification after peds calling them
{% endhint %}

```lua
---@param streetName string
---@param coords vector3
---@param pedMugshot image
RegisterNetEvent('axio_sellDrugs:client:callCops', function(streetName, coords, pedMugshot)
 ...
end)
```

## Client : inventory.lua

{% hint style="info" %}
Si vous n'utilisez pas les inventaires ESX ou QB par default, vous pouvez configurer le votre ici
{% endhint %}

{% hint style="info" %}
**You must respect the format indicated in the file**
{% endhint %}

## Server : functions.lua

#### removeItemAndGiveMoney

{% hint style="info" %}
Here is the function call for remove the item from player inventory and give him money after selling drugs\
You can change for your own system with the param
{% endhint %}

<pre class="language-lua"><code class="lang-lua">---@param source int
---@param drug string
---@param qtty int
---@param price int
<strong>function removeItemAndGiveMoney(source, drug, qtty, price)
</strong>    if Config.framework == "esx" then
        player = ESX.GetPlayerFromId(source)
    elseif Config.framework == "qbcore" then
        player = QB.Functions.GetPlayer(source)
    end

    --[[ Remove item ]]
    if Config.inventoryType == "esx" then
        player.removeInventoryItem(drug, qtty)
    elseif Config.inventoryType == "qbcore" then
        player.Functions.RemoveItem(drug, qtty)
    end

    --[[ Give money ]]
    if Config.framework == "esx" then
        player.addAccountMoney(Config.moneyType, price)
    elseif Config.framework == "qbcore" then
        player.Functions.AddMoney(Config.moneyType, price)
    end
end
</code></pre>

#### call Cops Event

{% hint style="info" %}
This event is trigger when a ped call the cops
{% endhint %}

```lua
---@param streetName string
---@param coords vector3
---@param pedMugshot image
RegisterNetEvent('axio_sellDrugs:server:callCops', function(streetName, coords, pedMugshot)
 ...
end)
```