SetPlayerPos

Tags: player

Description

Set a player's position.

Name Description
playerid The ID of the player to set the position of.
Float:x The X coordinate to position the player at.
Float:y The Y coordinate to position the player at.
Float:z The Z coordinate to position the player at.

Returns

1: The function executed successfully.

0: The function failed to execute. This means the player specified does not exist.

Examples

// Teleports players to the center of San Andreas when they type /middle
public OnPlayerCommandText(playerid,cmdtext[])
{
    if(!strcmp(cmdtext, "/middle", true))
    {
        SetPlayerPos(playerid, 0.0, 0.0, 3.0);
        return 1;
    }
    return 0;
}

Notes

TIP

Using this function on a player in a vehicle will instantly remove them from the vehicle. Useful for quickly ejecting players.

TIP

When setting a player's position to an interior, their interior must be set also.

  • SetPlayerPosFindZ: Set a player's position and find the ground.
  • GetPlayerPos: Get a player's position.
  • SetVehiclePos: Set the position of a vehicle.
  • GetVehiclePos: Get the position of a vehicle.