GetWeaponClipAmmo: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(The code is client-side only, so outputChatBox haven't visibleTo argument.)
mNo edit summary
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Client function}}
{{Client function}}
This function gets the amount of ammo in a custom weapons magazine/clip.
This function gets the amount of ammo left in a [[Element/Weapon|custom weapon]]'s magazine/clip.


==Syntax==
==Syntax==
<syntaxhighlight lang="lua">int getWeaponClipAmmo ( weapon theWeapon )</syntaxhighlight>
<syntaxhighlight lang="lua">int getWeaponClipAmmo ( weapon theWeapon )</syntaxhighlight>
{{OOP||[[Element/Weapon|weapon]]:getClipAmmo|clipAmmo|setWeaponClipAmmo}}


===Required Arguments===
===Required Arguments===
Line 10: Line 11:


===Returns===
===Returns===
Returns the amount of ammo in the custom weapons clip, false otherwise.
Returns the amount of ammo in the [[Element/Weapon|custom weapon]]'s clip, ''false'' if an error occured.


===Example===
===Example===
This example gets your ammo and output it!
This function outputs the remaining ammo in clip of a specific weapon using the command ''/getammoinclip''.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
[lua]
local customWeapon
function getMyAmmo(player) -- Create a function named getMyAmmo and add player as the first parameter of addCommandHandler!
 
  local weapon = getPedWeapon(player) -- Create a local variable with the value of getPedWeapon ( the weapon of the player )!
addEventHandler( "onClientResourceStart", resourceRoot,
  local clipAmmo = getWeaponClipAmmo(weapon) -- Now use the local variable and get the weapon's clip ammo!
    function()
  outputChatBox(tostring(clipAmmo)) -- Output the clipAmmo to the player, Please use tostring for it or it will give you a error that it should be a string!
        local x, y, z = getElementPosition(localPlayer) -- Get player position
end -- End the function
        customWeapon = createWeapon("m4", x, y, z + 1) -- Create a M4
        setWeaponClipAmmo(customWeapon, 99999) -- Set the ammo in clip of the weapon to 99999, so it never should reload
        setWeaponState(customWeapon, "firing") -- Fire it permanently
        -- Add the 'getammoinclip' command to get the remaining ammo in clip of the weapon
        addCommandHandler("getammoinclip", getM4WeaponAmmo)
    end
)
 
function getM4WeaponAmmo()
    if customWeapon then
        -- Tell the player the remaining ammo in clip
        outputChatBox(getWeaponClipAmmo(customWeapon))
    else
        -- Weapon was not created, give an error
        outputChatBox("There is no weapon to get clip ammo of.")
    end
end
</syntaxhighlight>
</syntaxhighlight>


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

Latest revision as of 21:44, 7 May 2017

This function gets the amount of ammo left in a custom weapon's magazine/clip.

Syntax

int getWeaponClipAmmo ( weapon theWeapon )

OOP Syntax Help! I don't understand this!

Method: weapon:getClipAmmo(...)
Variable: .clipAmmo
Counterpart: setWeaponClipAmmo


Required Arguments

  • theWeapon: the weapon to get the clip ammo of.

Returns

Returns the amount of ammo in the custom weapon's clip, false if an error occured.

Example

This function outputs the remaining ammo in clip of a specific weapon using the command /getammoinclip.

local customWeapon

addEventHandler( "onClientResourceStart", resourceRoot,
    function()
        local x, y, z = getElementPosition(localPlayer) -- Get player position
        customWeapon = createWeapon("m4", x, y, z + 1) -- Create a M4
        setWeaponClipAmmo(customWeapon, 99999) -- Set the ammo in clip of the weapon to 99999, so it never should reload
        setWeaponState(customWeapon, "firing") -- Fire it permanently
        -- Add the 'getammoinclip' command to get the remaining ammo in clip of the weapon
        addCommandHandler("getammoinclip", getM4WeaponAmmo)
    end
)

function getM4WeaponAmmo()
    if customWeapon then
        -- Tell the player the remaining ammo in clip
        outputChatBox(getWeaponClipAmmo(customWeapon))
    else
        -- Weapon was not created, give an error
        outputChatBox("There is no weapon to get clip ammo of.")
    end
end

See also