GetPickupWeapon: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
| Line 1: | Line 1: | ||
__NOTOC__ | {{Server client function}} | ||
This function retrieves the | __NOTOC__ | ||
This function retrieves the weapon ID of a weapon pickup. | |||
==Syntax== | ==Syntax== | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
| Line 7: | Line 8: | ||
===Required Arguments=== | ===Required Arguments=== | ||
*'''thePickup:''' The pickup | *'''thePickup:''' The pickup of which you wish to retrieve the weapon | ||
===Returns=== | ===Returns=== | ||
Returns | Returns the [[Weapons|Weapon ID]] of the pickup, or ''false'' if the pickup is invalid. | ||
==Example== | ==Example== | ||
This example gives extra ammo to a player if a pickup only has a small amount of ammo. | This example gives extra ammo to a player if a pickup only has a small amount of ammo. | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
function onPickupHitFunc ( | function onPickupHitFunc ( thePlayer ) -- when a pickup is hit | ||
if | if getPickupType ( source ) == 2 then -- check if it's a weapon pickup | ||
local ammo = getPickupAmmo ( source ) -- get the pickup ammo | |||
if ammo < 50 then -- if ammo is less than 50 | |||
local weapon = getPickupWeapon ( source ) -- store pickup weapon | |||
giveWeaponAmmo ( thePlayer, weapon, 50 ) -- give an extra 50 ammo | |||
end | |||
end | |||
end | end | ||
addEventHandler ( "onPickupHit", getRootElement(), onPickupHitFunc ) -- add | addEventHandler ( "onPickupHit", getRootElement(), onPickupHitFunc ) -- add the function as handler for onPickupHit | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Revision as of 15:04, 19 August 2007
This function retrieves the weapon ID of a weapon pickup.
Syntax
int getPickupWeapon ( pickup thePickup )
Required Arguments
- thePickup: The pickup of which you wish to retrieve the weapon
Returns
Returns the Weapon ID of the pickup, or false if the pickup is invalid.
Example
This example gives extra ammo to a player if a pickup only has a small amount of ammo.
function onPickupHitFunc ( thePlayer ) -- when a pickup is hit
if getPickupType ( source ) == 2 then -- check if it's a weapon pickup
local ammo = getPickupAmmo ( source ) -- get the pickup ammo
if ammo < 50 then -- if ammo is less than 50
local weapon = getPickupWeapon ( source ) -- store pickup weapon
giveWeaponAmmo ( thePlayer, weapon, 50 ) -- give an extra 50 ammo
end
end
end
addEventHandler ( "onPickupHit", getRootElement(), onPickupHitFunc ) -- add the function as handler for onPickupHit
See Also
GTASA IDs (vehicles, weapons, weathers, characters, colors): http://info.vces.net/ (Special thanks to Brophy and Ratt for making these lists)