OnPickupUse: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
m (Edited language change)
 
(4 intermediate revisions by 2 users not shown)
Line 2: Line 2:
{{Server event}}
{{Server event}}
This event is triggered when a [[player]] stands on a [[pickup]] while not in a [[vehicle]].
This event is triggered when a [[player]] stands on a [[pickup]] while not in a [[vehicle]].
 
{{Tip|Pickups use [[colshape]]s, you can get the [[colshape]] of the [[pickup]] with [[getElementColShape]] and use [[colshape]] [[event]]s to it.}}
Pickups use [[colshape]]s, you can get the [[colshape]] of the [[pickup]] with [[getElementColShape]] and use [[colshape]] [[event]]s to it.


==Parameters==
==Parameters==
Line 10: Line 9:
</syntaxhighlight>  
</syntaxhighlight>  


*'''playerWhoUsed''': a [[player]] element refering to the player who used the [[pickup]].
*'''playerWhoUsed''': a [[player]] element referring to the player who used the [[pickup]].


==Source==
==Source==
Line 19: Line 18:


==Example==  
==Example==  
This example announces whena  player picks up a pickup
This example outputs a message to the chatbox when a player uses a pickup.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function pickupUse ( thePlayer )
function pickupUse( thePlayer )
     outputChatBox ( getPlayerName ( thePlayer ) .. " picked up a pickup!" )
     outputChatBox( getPlayerName( thePlayer ) .. " used a pickup!" )
end
end
addEventHandler ( "onPickupUse", getRootElement(), pickupUse )
addEventHandler( "onPickupUse", root, pickupUse )
</syntaxhighlight>
</syntaxhighlight>


{{See also/Server event|Pickup events}}
{{See also/Server event|Pickup events}}
[[ru:onPickupUse]]

Latest revision as of 12:13, 8 June 2022

This event is triggered when a player stands on a pickup while not in a vehicle.

[[{{{image}}}|link=|]] Tip: Pickups use colshapes, you can get the colshape of the pickup with getElementColShape and use colshape events to it.

Parameters

player playerWhoUsed
  • playerWhoUsed: a player element referring to the player who used the pickup.

Source

The source of this event is the pickup that is getting used by the player.

Canceling

If this event is canceled, the player will not be given the item they picked up.

Example

This example outputs a message to the chatbox when a player uses a pickup.

function pickupUse( thePlayer )
    outputChatBox( getPlayerName( thePlayer ) .. " used a pickup!" )
end
addEventHandler( "onPickupUse", root, pickupUse )

See Also

Pickup events


Event functions