note Help Needed

This wiki is the result of an ongoing community effort — thank you all for helping!

If you want to provide changes to this page then please click here.

SetPlayerPos

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

true - The function executed successfully.

false - The function failed to execute. This means the player specified does not exist.

Examples

public OnPlayerCommandText(playerid,cmdtext[])
{
    if (!strcmp(cmdtext, "/middle", true))
    {
        // Teleports players to the center of San Andreas when they type /middle
        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.

Related Functions

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.