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:

-- [[ 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)

Last updated