SetPlayerPos

From SA-MP Wiki

Jump to: navigation, search


Description:

Set a player's position.


Parameters:
(playerid, Float:x, Float:y, Float:z)
playeridThe ID of the player to set the position of.
Float:xThe X coordinate to position the player at.
Float:yThe Y coordinate to position the player at.
Float:zThe Z coordinate to position the player at.


Return Values:

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


Image:32px-Ambox_warning_orange.png

Note

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


Tip

Image:Light_bulb_icon.png

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


Example Usage:

// 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;
}

Related Functions

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

Personal tools