GetWeaponAmmo: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
mNo edit summary
(Remove obsolete Requirements section)
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Client function}}
{{Client function}}
{{Needs_Example}}
This function gets the total ammo a [[Element/Weapon|custom weapon]] has.
This function gets the total ammo a [[Element/Weapon|custom weapon]] has.


Line 14: Line 13:
Returns an [[int|integer]] containing how many ammo left has the weapon. Returns ''false'' if an error occured.
Returns an [[int|integer]] containing how many ammo left has the weapon. Returns ''false'' if an error occured.


==Requirements==
==Example==
{{Requirements|n/a|1.3.0-9.04555|}}
This example gets the ammo of the custom weapon and outputs it to the chatbox.
<syntaxhighlight lang="lua">
function createCustomWeapon()
  local position = Vector3(getElementPosition(localPlayer)) -- get the localPlayer position
  local weapon = createWeapon ("m4",position.x,position.y,position.z) -- Create the weapon
    if weapon then -- If the weapon exist then
      setWeaponAmmo(weapon,5000)
      local ammo = getWeaponAmmo(weapon) 
      outputChatBox("Total ammo: "..ammo) -- output to the chatbox
    end
end
addCommandHandler("weapon",createCustomWeapon)
</syntaxhighlight>


==See also==
==See also==
{{Client weapon creation functions}}
{{Client weapon creation functions}}

Latest revision as of 17:05, 7 November 2024

This function gets the total ammo a custom weapon has.

Syntax

int getWeaponAmmo ( weapon theWeapon )

OOP Syntax Help! I don't understand this!

Method: weapon:getAmmo(...)
Variable: .ammo
Counterpart: setWeaponAmmo


Required arguments

  • theWeapon: The weapon to get the ammo of.

Returns

Returns an integer containing how many ammo left has the weapon. Returns false if an error occured.

Example

This example gets the ammo of the custom weapon and outputs it to the chatbox.

function createCustomWeapon()
   local position = Vector3(getElementPosition(localPlayer)) -- get the localPlayer position
   local weapon = createWeapon ("m4",position.x,position.y,position.z) -- Create the weapon
     if weapon then -- If the weapon exist then
       setWeaponAmmo(weapon,5000) 
       local ammo = getWeaponAmmo(weapon)  
       outputChatBox("Total ammo: "..ammo) -- output to the chatbox
    end 
end 
addCommandHandler("weapon",createCustomWeapon)

See also