This page is incomplete! Help wanted!

Please finish this page using the corresponding Old Wiki article.
Go to Contribution guidelines for more information.

---

giveWeapon gives a specified weapon to a certain player or ped. There is an optional argument to specify ammunition. For example, a melee weapon doesn't need an ammo argument.

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

 giveWeapon ( )

Code Examples

Example 1 Example 2 Example 3

server

Example 1:This example gives a player an M4 with 200 ammo whenever they spawn.

function giveWeaponsOnSpawn ( theSpawnpont, theTeam )
    giveWeapon ( source, 31, 200 ) -- Gives the M4 weapon with 200 ammo
end
addEventHandler ( "onPlayerSpawn", root, giveWeaponsOnSpawn ) -- attach the event handler

server

Example 2:This example adds a "give" command in console which allows giving of any weapon by entering "give ".

function consoleGive ( thePlayer, commandName, weaponID, ammo )
  local status = giveWeapon ( thePlayer, weaponID, ammo, true )   -- attempt to give the weapon, forcing it as selected weapon
  if ( not status ) then                                          -- if it was unsuccessful
    outputConsole ( "Failed to give weapon.", thePlayer )   -- tell the player
  end
end
addCommandHandler ( "give", consoleGive )

server

Example 3:This example creates a ped in certain coordinates. You can give him a weapon with "give " command in console.

ped = createPed( 19, -1634.5775, 1203.85, 7.1796 )

addCommandHandler( "give",
  function ( player, command, id, amount )
    if not tonumber ( id ) then return end

    if not tonumber ( amount ) then
        amount = 9001
    end

    giveWeapon( ped, id, amount, true )
  end
)

See Also

Weapon Functions

• getOriginalWeaponProperty
• getSlotFromWeapon
• getWeaponIDFromName
• getWeaponNameFromID
• getWeaponProperty
• giveWeapon
• isWeaponRenderEnabled
• setWeaponAmmo
• setWeaponProperty
• setWeaponRenderEnabled
• takeAllWeapons
• takeWeapon

Weapon Events

• onWeaponFire

Reference

• Scripting Functions