OnPickupHit: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(13 intermediate revisions by 9 users not shown)
Line 1: Line 1:
[[Category:Incomplete Event]]
__NOTOC__
{{Server event}}
This event is triggered when a [[player]] hits a [[pickup]].


__NOTOC__
==Parameters==
This event is triggered when a player hits a pickup.
 
==Syntax==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
void onPickupHit ( player player )
player thePlayer
</syntaxhighlight>  
</syntaxhighlight>  
*'''thePlayer''': a [[player]] element referring to the player who moved over the [[pickup]].
==Source==
The [[event system#Event source|source]] of this event is the [[pickup]] that was hit by the player.
==Cancel effect==
If this event is [[Event system#Canceling|canceled]], the pickup does not disappear and the player does not receive its bonus.


==Example==  
==Example==  
This example does...
This example creates a pickup and outputs a message to the chat box when a player walks over it.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
--This line does...
local thePickup = createPickup( 10, 10, 10, 2, 31, 3000, 50 ) -- Create a M4 weapon pickup when the script starts
blabhalbalhb --abababa
 
--This line does this...
function pickedUpWeaponCheck( player )
mooo
    outputChatBox( "You have picked up a M4.", player ) -- Output a message to the chatbox
end
addEventHandler( "onPickupHit", thePickup, pickedUpWeaponCheck )
</syntaxhighlight>
</syntaxhighlight>
{{See also/Server event|Pickup events}}

Latest revision as of 02:57, 27 September 2018

This event is triggered when a player hits a pickup.

Parameters

player thePlayer
  • thePlayer: a player element referring to the player who moved over the pickup.

Source

The source of this event is the pickup that was hit by the player.

Cancel effect

If this event is canceled, the pickup does not disappear and the player does not receive its bonus.

Example

This example creates a pickup and outputs a message to the chat box when a player walks over it.

local thePickup = createPickup( 10, 10, 10, 2, 31, 3000, 50 ) -- Create a M4 weapon pickup when the script starts

function pickedUpWeaponCheck( player )
    outputChatBox( "You have picked up a M4.", player ) -- Output a message to the chatbox
end
addEventHandler( "onPickupHit", thePickup, pickedUpWeaponCheck )

See Also

Pickup events


Event functions