GivePedWeapon: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
mNo edit summary
(Minor category change at →‎See Also)
Line 38: Line 38:


==See Also==
==See Also==
{{Client weapon functions}}
{{Client ped functions}}

Revision as of 16:59, 19 November 2014

This function gives a specified weapon to the specified ped, this function cannot be used for players. There is an optional argument to specify ammunition and whether to set as current weapon. For example, a melee weapon doesn't need an ammo argument.

[[{{{image}}}|link=|]] Note:
  • When setting ammo for weapons in slot 0,1,10,11 or 12, the ammo max is 1
  • When setting ammo for weapons in slot 3,4,5, the ammo is added
  • When setting ammo for weapons in slot 2,6,7,8,9 and the slot weapon is changing, the ammo is replaced

Syntax

bool givePedWeapon ( ped thePed, int weapon [, int ammo=30, bool setAsCurrent=false ] )

Required Arguments

  • thePed: A ped element.
  • weapon: A whole number integer that refers to a Weapon ID. Click here for a list of possible weapon IDs.

Optional Arguments

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.

  • ammo: A whole number integer serving as the ammo amount for the given weapon. For weapons that do not require ammo, such as melee, this should be at least 1.
  • setAsCurrent: A boolean value determining whether or not the weapon will be set as the players current.

Returns

Returns true if weapon was successfully given to the ped, false otherwise.

Example

Example 1: This example creates a client side ped, gives them an M4 and make them shoot once you do the command '/armedped'

function cmdArmedPed( command )
    local x, y, z = getElementPosition(localPlayer) -- Get your position
    local thePed = createPed(0, x + 1, y, z) -- Create a CJ ped nearby
    givePedWeapon(thePed, 31, 5000, true) -- Give him 5000 rounds of M4
    setControlState(thePed, "fire", true) -- Make him shoot continuously
end
addCommandHandler("armedped", cmdArmedPed)

See Also