OnPickupHit: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(10 intermediate revisions by 8 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
This event is triggered when a player hits a pickup. A pickup is health, armor, or a weapon.
{{Server event}}
This event is triggered when a [[player]] hits a [[pickup]].


==Syntax==  
==Parameters==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
void onPickupHit ( player player )
player thePlayer
</syntaxhighlight>  
</syntaxhighlight>  


==Parameters==
*'''thePlayer''': a [[player]] element referring to the player who moved over the [[pickup]].
*The '''source''' of this event refers to the pickup which was hit by the player.
 
*'''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 creates a pickup and outputs a message to the chat box when the player walks over it
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">
createPickup ( 10.0, 10.0, 10.0, 2, 31, 3000, 50 ) --Create an M4 weapon pickup when script starts
local thePickup = createPickup( 10, 10, 10, 2, 31, 3000, 50 ) -- Create a M4 weapon pickup when the script starts


function pickedUpWeaponCheck ( player, matchingDimension )
function pickedUpWeaponCheck( player )
if source == myPickup then --If the pickup I grabbed was myPickup
    outputChatBox( "You have picked up a M4.", player ) -- Output a message to the chatbox
    outputChatBox ( "You have picked up your pickup weapon" ) --Display this message in the chat box
end
end
end
addEventHandler ( "onPickupHit", getRootElement(), pickedUpWeaponCheck )
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