GetPlayerPos

GetPlayerPos

Description:

Function GetPlayerPos get the position of a player, represented by X, Y and Z coordinates.

This function is known to return unreliable values when used in OnPlayerDisconnect and OnPlayerRequestClass. This is because the player is not spawned.

Parameters:

(playerid, &Float:x, &Float:y, &Float:z)

int

playerid

The ID of the player to get the position of.

float

X

A float variable in which to store the X coordinate in, passed by reference.

float

Y

A float variable in which to store the Y coordinate in, passed by reference.

float

Z

A float variable in which to store the Z coordinate in, passed by reference.

Return Values:

• true on success.
• false on failure (i.e. player not connected).

Examples:

Example 1

public OnPlayerDeath(playerid, killerid, reason)
{
    // Declare 3 float variables to store the X, Y and Z coordinates in
    new Float:x, Float:y, Float:z;
 
    // Use GetPlayerPos, passing the 3 float variables we just created
    GetPlayerPos(playerid, x, y, z);
 
    // Create a cash pickup at the player's position
    CreatePickup(1212, 4, x, y, z, -1);
   return 1;
}

Related Functions

The following functions may be useful, as they are related to this function in one way or another.

• SetPlayerPos: Set a player's position.
• GetVehiclePos: Get the position of a vehicle.
• IsPlayerInRangeOfPoint: Check whether a player is in range of a point.
• GetPlayerDistanceFromPoint: Get the distance between a player and a point.