> For the complete documentation index, see [llms.txt](https://docs.rytrak.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rytrak.fr/scripts/advanced-police-grab-ped/general-events.md).

# General Events

This page explains the available events for the **r\_grab** script and their usage. These events allow you to interact with the script programmatically from other resources.

### 1. Client-Side Events

#### **1.1 Grab or Release a Player**

**Event Name:** `r_grab:client:grabPlayer`

**Description:** This event allows grabbing or releasing a target player.

**Parameters:**

* `targetId` *(integer)*: The server ID of the player to grab.

***

#### **1.2 Put the Grabbed Player in a Vehicle**

**Event Name:** `r_grab:client:putPlayerInVehicle`

**Description:** Places the currently grabbed player into the nearest vehicle.

***

#### **1.3 Remove the Grabbed Player from a Vehicle**

**Event Name:** `r_grab:client:removePlayerFromVehicle`

**Description:** Removes the currently grabbed player from the vehicle they are in.

***

### 2. Server-Side Events

#### **2.1 Initiate Grab Action**

**Event Name:** `r_grab:server:grabPlayer`

**Description:** Initiates the grab action for a target player, ensuring the source and target are within range.

**Parameters:**

* `targetId` *(integer)*: The server ID of the player being grabbed.

**Notes:**

* The function checks if the target ID is valid.
* It verifies if the source player is within a 10.0 unit range of the target.
* If conditions are met, it triggers client-side events to update both players.

***

### 3. Example Usage

Below is an example of how to use these events in your script:

```lua
-- [[ Grab or release a player ]]
-- Client to server
TriggerServerEvent('r_grab:server:grabPlayer', 1)
-- Server to client
TriggerClientEvent('r_grab:client:grabPlayer', source, 1)

-- [[ Put the grabbed player in a vehicle ]]
-- Only server to client
TriggerClientEvent('r_grab:server:putPlayerInVehicle', source)

-- [[ Remove the grabbed player from the vehicle ]]
-- Only server to client
TriggerClientEvent('r_grab:client:removePlayerFromVehicle', source)
```