OnPlayerStateChange

From SA-MP Wiki

Jump to: navigation, search


Description:

This callback is called when a player changes state. For example, when a player changes from being the driver of a vehicle to being on-foot.


Image:32px-Ambox_warning_orange.png

Note

This callback can also be called by NPC.


Parameters:
(playerid, newstate, oldstate)
playeridThe ID of the player that changed state.
newstateThe player's new state.
oldstateThe player's previous state.


Return Values:

This callback does not handle returns.
  • It is always called first in filterscripts.


Example Usage:

public OnPlayerStateChange(playerid, newstate, oldstate)
{
    if(oldstate == PLAYER_STATE_ONFOOT && newstate == PLAYER_STATE_DRIVER) // Player entered a vehicle as a driver
    {
        new vehicleid = GetPlayerVehicleID(playerid);
        AddVehicleComponent(vehicleid, 1010); // Add NOS to the vehicle
    }
    return 1;
}

Related Callbacks

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


Related Functions

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

Personal tools
Navigation
Toolbox
In other languages