GivePedWeapon

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

• Shared
• getWeaponProperty
• getPickupWeapon
• getOriginalWeaponProperty
• getSlotFromWeapon
• getWeaponIDFromName
• getWeaponNameFromID
• setWeaponAmmo
• setWeaponProperty