The open.mp logo
Home
FAQ
Forums
Servers
Partners
Docs
Blog

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.

OnPlayerStateChange

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.

NameDescription
playeridThe ID of the player that changed state.
newstateThe player's new state.
oldstateThe player's previous state.

Refer to Player States for a list of all available player states.

Returns

It is always called first in filterscripts.

Examples

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

Notes

tip

This callback can also be called by NPC.

Related Callbacks

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

  • OnPlayerInteriorChange: This callback is called when a player changes interior.

Related Functions

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

  • GetPlayerState: Get a player's current state.
  • GetPlayerSpecialAction: Get a player's current special action.
  • SetPlayerSpecialAction: Set a player's special action.

Community

  • Discord
  • Instagram
  • Twitter
  • Twitch
  • YouTube
  • Facebook
  • VK

More

  • SA-MP
  • Blog
  • GitHub