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)
