SetPlayerCheckpoint

From SA-MP Wiki

Description:

Return Values:

Warning

Known Bug(s): If a checkpoint is already set it will use the size of that checkpoint instead of the new one. Checkpoints created on server-created objects (CreateObject/CreatePlayerObject) will appear down on the 'real' ground, but will still function correctly. A pickup can be used instead.

Important Note

Checkpoints are asynchronous, meaning only one can be shown at a time. To 'stream' checkpoints (only show them when players are close enough), use a checkpoint streamer.

Example Usage:

// In this example the player's checkpoint will be set when they spawn.
// On entering the checkpoint they will receive $1000 and the checkpoint will be disabled.
 
new bool:onCheck[MAX_PLAYERS];
 
public OnPlayerSpawn(playerid)
{
    SetPlayerCheckpoint(playerid, 1982.6150, -220.6680, -0.2432, 3.0);
    onCheck[playerid] = true;
    return 1;
}
 
public OnPlayerEnterCheckpoint(playerid)
{
    if(onCheck[playerid]) // if it's true  
    { 
        GivePlayerMoney(playerid, 1000);
        DisablePlayerCheckpoint(playerid);
        onCheck[playerid] = false;
    }
    return 1;
}

Related Functions

The following functions might be useful, as they're related to this callback in one way or another.

• DisablePlayerCheckpoint: Disable the player's current checkpoint.

• IsPlayerInCheckpoint: Check if a player is in a checkpoint.

• SetPlayerRaceCheckpoint: Create a race checkpoint for a player.

• DisablePlayerRaceCheckpoint: Disable the player's current race checkpoint.

• IsPlayerInRaceCheckpoint: Check if a player is in a race checkpoint.

Related Callbacks

The following callbacks might be useful as well, as they are related to this callback in one way or another.

• OnPlayerEnterCheckpoint: Called when a player enters a checkpoint.

• OnPlayerLeaveCheckpoint: Called when a player leaves a checkpoint.

• OnPlayerEnterRaceCheckpoint: Called when a player enters a race checkpoint.

• OnPlayerLeaveRaceCheckpoint: Called when a player leaves a race checkpoint.