---
title: "OnPlayerStateChange | open.mp"
description: "Esta callback é chamada quando o estado de um jogador muda."
canonical: https://omp.itsneufox.com/pt-BR/docs/scripting/callbacks/OnPlayerStateChange
language: pt-BR
---

# OnPlayerStateChange

## Descrição

Esta callback é chamada quando o estado de um jogador muda. Por exemplo, quando um jogador deixa de ser o piloto de um veículo e fica a pé.

| Nome | Desrição |
| --- | --- |
| playerid | O ID do jogador que teve o estado alterado. |
| newstate | O novo estado do jogador. |
| oldstate | O antigo estado do jogador. |

Verifique em [Player States](https://omp.itsneufox.com/pt-BR/docs/scripting/resources/playerstates) a lista de todos os estados disponíveis.

## Retorno

Sempre é chamada primeiro em filterscripts.

## Exemplo

```c
public OnPlayerStateChange(playerid, PLAYER_STATE:newstate, PLAYER_STATE:oldstate)
{
    if (oldstate == PLAYER_STATE_ONFOOT && newstate == PLAYER_STATE_DRIVER) // Jogador entrou no veículo como piloto
    {
        new vehicleid = GetPlayerVehicleID(playerid);
        AddVehicleComponent(vehicleid, 1010); // Adiciona nitro ao veículo
    }
    return 1;
}
```

## Notas

nota

Esta callback também pode ser chamada por NPC.

## Callbacks Relacionadas

Os seguintes callbacks podem ser úteis, pois estão relacionados a este callback de alguma forma.

-   [OnPlayerInteriorChange](https://omp.itsneufox.com/pt-BR/docs/scripting/callbacks/OnPlayerInteriorChange): Chamada quando um jogador muda de interior.

## Funções Relacionadas

As seguintes funções podem ser úteis, pois estão relacionadas a esta callback.

-   [GetPlayerState](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/GetPlayerState): Obtém o estado atual do jogador.
-   [GetPlayerSpecialAction](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/GetPlayerSpecialAction): Obtém a ação especial atual do jogador.
-   [SetPlayerSpecialAction](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/SetPlayerSpecialAction): Define uma ação especial a um jogador.

## Recursos relacionados

-   [Estados do jogador](https://omp.itsneufox.com/pt-BR/docs/scripting/resources/playerstates)