GetPickupAmount: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
Line 4: Line 4:
==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
float getPickupAmount ( pickup pickup )         
int getPickupAmount ( pickup thePickup )         
</syntaxhighlight>  
</syntaxhighlight>  


===Required Arguments===  
===Required Arguments===  
*'''pickup:''' The pickup you wish to retrieve the amount from.
*'''thePickup:''' The pickup you wish to retrieve the amount from.


===Returns===
===Returns===
Returns an integer of the amount the pickup is set to.
Returns an ''integer'' of the amount the pickup is set to, ''false'' if it's invalid.


==Example==  
==Example==  
This example takes a player's money appropriately according to the amount of health he 'buys'.
This example outputs the amount of health a player picked up.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
addEventHandler ( "onPickupHit", root, "onPickupHit" ) --add an event handler for onPickupHit
function onPickupHitFunction ( player ) --when someone hits a pickup
function onPickupHit ( player ) --when someone hits a pickup
     if getPickupType ( source ) == 0 then --check the type of pickup, if it is a health pickup then
     if getPickupType ( source ) == 0 then --check the type of pickup, if it is a health pickup then
         amount = getPickupAmount ( source )
         amount = getPickupAmount ( source )
         takePlayerMoney ( player, amount ) -- take the player's money according to the amount in the pickup
         outputChatBox("You picked up "..amount.." health",player)
     end
     end
end
end
addEventHandler ( "onPickupHit", root, onPickupHitFunction ) --add an event handler for onPickupHit
</syntaxhighlight>
</syntaxhighlight>


==See Also==
==See Also==
{{Pickup functions}}
{{Pickup functions}}

Revision as of 20:35, 28 July 2007

This function retreives the amount of health or armour given from a pickup.

Syntax

int getPickupAmount ( pickup thePickup )        

Required Arguments

  • thePickup: The pickup you wish to retrieve the amount from.

Returns

Returns an integer of the amount the pickup is set to, false if it's invalid.

Example

This example outputs the amount of health a player picked up.

function onPickupHitFunction ( player ) --when someone hits a pickup
    if getPickupType ( source ) == 0 then --check the type of pickup, if it is a health pickup then
        amount = getPickupAmount ( source )
        outputChatBox("You picked up "..amount.." health",player)
    end
end
addEventHandler ( "onPickupHit", root, onPickupHitFunction ) --add an event handler for onPickupHit

See Also