GivePedWeapon: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Minor category change at →‎See Also)
No edit summary
Line 2: Line 2:
{{Client function}}
{{Client function}}
{{New feature/item|3.0141|1.4.1|6937|
{{New feature/item|3.0141|1.4.1|6937|
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.
This function gives the specified weapon to the specified ped. This function can't be used on players, use [[giveWeapon]] for that.
 
This function is mainly useful for client side created peds however you can use it on a server side ped, though note that the weapon wouldn't be synced between clients unless your script gives the weapon to the ped on every client.
 
There is an optional argument to specify ammunition and whether to set as the current weapon. If you don't specify an ammo value it will give 30 ammo by default and for a melee weapon you can specify just 1 or above.
}}
}}
{{Note|
{{Note|
*When setting ammo for [[Weapon|weapons in slot]] 0,1,10,11 or 12, the ammo max is 1
*When setting ammo for [[Weapon|weapons in slot]] 0,1,10,11 or 12 the ammo max is 1
*When setting ammo for [[Weapon|weapons in slot]] 3,4,5, the ammo is added
*When setting ammo for [[Weapon|weapons in slot]] 3,4,5 the ammo is added
*When setting ammo for [[Weapon|weapons in slot]] 2,6,7,8,9 and the slot weapon is changing, the ammo is replaced
*When setting ammo for [[Weapon|weapons in slot]] 2,6,7,8,9 and the slot weapon is changing, the ammo is replaced
}}
}}
Line 19: Line 23:
===Optional Arguments===
===Optional Arguments===
{{OptionalArg}}
{{OptionalArg}}
*'''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.
*'''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.
*'''setAsCurrent:''' A boolean value determining whether or not the weapon will be set as the peds currently selected weapon.


===Returns===
===Returns===

Revision as of 19:22, 20 November 2014

This function gives the specified weapon to the specified ped. This function can't be used on players, use giveWeapon for that.

This function is mainly useful for client side created peds however you can use it on a server side ped, though note that the weapon wouldn't be synced between clients unless your script gives the weapon to the ped on every client.

There is an optional argument to specify ammunition and whether to set as the current weapon. If you don't specify an ammo value it will give 30 ammo by default and for a melee weapon you can specify just 1 or above.

[[{{{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 peds currently selected weapon.

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