From SA-MP Wiki

Jump to: navigation, search


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.



This callback can also be called by NPC.

(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
In other languages