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.
OnPlayerPickUpPlayerPickup
warning
This callback was added in omp v1.1.0.2612 and will not work in earlier versions!
Description
This callback is called when a player picks up a player-pickup created with CreatePlayerPickup.
| Name | Description |
|---|---|
| playerid | The ID of the player that picked up the player-pickup. |
| pickupid | The ID of the player-pickup, returned by CreatePlayerPickup |
Returns
It is always called first in gamemode.
Examples
new player_pickup_Cash[MAX_PLAYERS];
new player_pickup_Health[MAX_PLAYERS];
public OnPlayerConnect(playerid)
{
player_pickup_Cash[playerid] = CreatePlayerPickup(playerid, 1274, 2, 2009.8658, 1220.0293, 10.8206, -1);
player_pickup_Health[playerid] = CreatePlayerPickup(playerid, 1240, 2, 2009.8474, 1218.0459, 10.8175, -1);
return 1;
}
public OnPlayerPickUpPlayerPickup(playerid, pickupid)
{
if (pickupid == player_pickup_Cash[playerid])
{
GivePlayerMoney(playerid, 1000);
}
else if (pickupid == player_pickup_Health[playerid])
{
SetPlayerHealth(playerid, 100.0);
}
return 1;
}
Related Callbacks
The following callbacks might be useful, as they're related to this callback in one way or another.
- OnPlayerPickupStreamIn: Called when a player-pickup enters the visual range of the player.
- OnPlayerPickupStreamOut: Called when a player-pickup leaves the visual range of the player.
Related Functions
The following functions might be useful, as they're related to this callback in one way or another.
- CreatePlayerPickup: Creates a pickup which will be visible to only one player.
- DestroyPlayerPickup: Destroy a player-pickup.