> For the complete documentation index, see [llms.txt](https://nayzeee-dev.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nayzeee-dev.gitbook.io/docs/nayzeee-scripts/nayzeee-drug-selling/events.md).

# Events

***

### Client Events

<details>

<summary>nayzeee-drugselling:notify</summary>

Sends a notification to the player.

```lua
TriggerClientEvent('nayzeee-drugselling:notify', playerId, message, type)
```

**Parameters:**

| Parameter  | Type   | Description                      |
| ---------- | ------ | -------------------------------- |
| `playerId` | number | Player server ID                 |
| `message`  | string | Notification message             |
| `type`     | string | `'success'`, `'error'`, `'info'` |

</details>

<details>

<summary>nayzeee-drugselling:startSelling</summary>

Initiates the drug selling process.

```lua
TriggerEvent('nayzeee-drugselling:startSelling', pedNetId, drugType)
```

**Parameters:**

| Parameter  | Type   | Description           |
| ---------- | ------ | --------------------- |
| `pedNetId` | number | Target NPC network ID |
| `drugType` | string | Type of drug to sell  |

</details>

<details>

<summary>nayzeee-drugselling:updateUI</summary>

Updates the selling UI with current data.

```lua
TriggerEvent('nayzeee-drugselling:updateUI', data)
```

</details>

***

### Server Events

<details>

<summary>nayzeee-drugselling:recoverDrugs</summary>

Triggered when player recovers drugs from a ped.

```lua
TriggerServerEvent('nayzeee-drugselling:recoverDrugs', pedNetId)
```

</details>

<details>

<summary>nayzeee-drugselling:sellComplete</summary>

Called when a drug sale is completed.

```lua
AddEventHandler('nayzeee-drugselling:sellComplete', function(playerId, drugType, amount, profit)
    -- Handle sale completion
end)
```

**Parameters:**

| Parameter  | Type   | Description       |
| ---------- | ------ | ----------------- |
| `playerId` | number | Seller player ID  |
| `drugType` | string | Type of drug sold |
| `amount`   | number | Quantity sold     |
| `profit`   | number | Money earned      |

</details>

<details>

<summary>nayzeee-drugselling:policeAlert</summary>

Triggered when police are alerted to drug activity.

```lua
AddEventHandler('nayzeee-drugselling:policeAlert', function(coords, drugType)
    -- Handle police dispatch
end)
```

</details>

***

### ox\_lib Callbacks

<details>

<summary>nayzeee-drugselling:getRank</summary>

Gets player's trap rank/level.

```lua
local rank = lib.callback.await('nayzeee-drugselling:getRank', false)
```

**Returns:**

```lua
{
    level = number,
    xp = number,
    xpNeeded = number,
    multiplier = number
}
```

</details>

<details>

<summary>nayzeee-drugselling:getStats</summary>

Gets player's selling statistics.

```lua
local stats = lib.callback.await('nayzeee-drugselling:getStats', false)
```

**Returns:**

```lua
{
    totalSold = number,
    totalProfit = number,
    successRate = number
}
```

</details>

<details>

<summary>nayzeee-drugselling:canSell</summary>

Checks if player can sell drugs.

```lua
local canSell, reason = lib.callback.await('nayzeee-drugselling:canSell', false, drugType)
```

</details>

***

### Dispatch Integration

The script supports multiple dispatch systems:

| System          | Event/Export                                             |
| --------------- | -------------------------------------------------------- |
| cd\_dispatch    | `TriggerServerEvent('cd_dispatch:AddNotification', ...)` |
| ps-dispatch     | `exports['ps-dispatch']:DrugSale(...)`                   |
| lb-tablet       | `exports['lb-tablet']:SendAlert(...)`                    |
| origen\_police  | `TriggerServerEvent('origen_police:createCall', ...)`    |
| rcore\_dispatch | `exports['rcore_dispatch']:Alert(...)`                   |