# Events

{% hint style="info" %}

#### **Note**

These events are entirely optional and can be triggered as needed to integrate cd\_dispatch3d with your own scripts or custom systems.
{% endhint %}

***

## Client

{% hint style="success" %}

#### **Client-Side Events**

* Defined with **`RegisterNetEvent`** or **`AddEventHandler`** **in client files**.
* Triggered using **`TriggerEvent`** (if from client) or **`TriggerClientEvent`** (if from server).
* Run only on **one player’s game client** (the player’s PC).
  {% endhint %}

### Panic Button

Activates your panic alert.

{% code title="client-side to client-side" %}

```lua
TriggerEvent('cd_dispatch:PanicButtonEvent')
```

{% endcode %}

{% code title="server-side to client-side" %}

```lua
TriggerClientEvent('cd_dispatch:PanicButtonEvent', source)
```

{% endcode %}

***

### Toggle Quick View UI

Toggles the visibility of the quick view dispatch UI.

{% code title="client-side to client-side" %}

```lua
TriggerEvent('cd_dispatch:KEY_smallui')
```

{% endcode %}

{% code title="server-side to client-side" %}

```lua
TriggerClientEvent('cd_dispatch:KEY_smallui', source)
```

{% endcode %}

***

### Hide Quick View UI

Hides the quick view dispatch UI.

{% code title="client-side to client-side" %}

```lua
TriggerEvent('cd_dispatch:KEY_smallui_hide')
```

{% endcode %}

{% code title="server-side to client-side" %}

```lua
TriggerClientEvent('cd_dispatch:KEY_smallui_hide', source)
```

{% endcode %}

***

### Show Quick View UI

Shows the quick view dispatch UI.

{% code title="client-side to client-side" %}

```lua
TriggerEvent('cd_dispatch:KEY_smallui_show')
```

{% endcode %}

{% code title="server-side to client-side" %}

```lua
TriggerClientEvent('cd_dispatch:KEY_smallui_show', source)
```

{% endcode %}

***

### Open Main Dispatch UI

Opens the main dispatch interface.

{% code title="client-side to client-side" %}

```lua
TriggerEvent('cd_dispatch:KEY_largeui')
```

{% endcode %}

{% code title="server-side to client-side" %}

```lua
TriggerClientEvent('cd_dispatch:KEY_largeui', source)
```

{% endcode %}

***

### Responding

Marks the player as responding to a notification.

{% code title="client-side to client-side" %}

```lua
TriggerEvent('cd_dispatch:KEY_responding')
```

{% endcode %}

{% code title="server-side to client-side" %}

```lua
TriggerClientEvent('cd_dispatch:GpsTrackerDisable', source)
```

{% endcode %}

***

### Disable GPS Tracker

Disables a player’s access to the dispatch system.

{% code title="client-side to client-side" %}

```lua
TriggerEvent('cd_dispatch:GpsTrackerDisable')
```

{% endcode %}

{% code title="server-side to client-side" %}

```lua
TriggerClientEvent('cd_dispatch:GpsTrackerDisable', source)
```

{% endcode %}

***

### Enable GPS Tracker

Restores a player’s access to the dispatch system after being disabled.

{% code title="client-side to client-side" %}

```lua
TriggerEvent('cd_dispatch:GpsTrackerEnable')
```

{% endcode %}

{% code title="server-side to client-side" %}

```lua
TriggerClientEvent('cd_dispatch:GpsTrackerEnable', source)
```

{% endcode %}

***

## Server

{% hint style="success" %}

#### **Server-Side Events**

* Defined with **`RegisterServerEvent`** or **`AddEventHandler`** **in server files**.
* Triggered using **`TriggerEvent`** (if from server) or **`TriggerServerEvent`** (if from client).
* Run on the **server**, not on any individual player’s game client.
  {% endhint %}

### Radio Channel Event

Used to update a player’s radio channel on the dispatch system.\
This event should be triggered from your **radio resource** whenever a player **joins, leaves, or changes** a radio channel.

{% code title="@parameters" %}

```lua
--- @param radioChannel string or number The player’s current radio channel.
--- @example
--- local radioChannel = 1
--- TriggerServerEvent('cd_dispatch:GetRadioChannel', radioChannel)
```

{% endcode %}

{% code title="client-side to server-side" %}

```lua
TriggerServerEvent('cd_dispatch:GetRadioChannel', radioChannel)
```

{% endcode %}

{% code title="server-side to server-side" %}

```lua
TriggerEvent('cd_dispatch:GetRadioChannel', radioChannel, source)
```

{% endcode %}