setPedWeaponSlot

Client-side

Server-side

Shared

Pair: getPedWeaponSlot

Manual Review Required

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

This function changes the selected weapon slot of a ped.

OOP Syntax Help! I don't understand this!

Method:ped:setWeaponSlot(...)
Variable: .weaponSlot

Syntax

bool setPedWeaponSlot ( ped thePed, int weaponSlot )

Required Arguments

thePed: the ped whose weapon slot you want to set. In a clientside script, this cannot be used on remote players.
weaponSlot: the weapon slot to set.

Returns

bool: value

Returns true if successful in setting the ped's equipped weapon slot, false otherwise.

Code Examples

shared

This example allows the player to type the command 'giveweapons', which gives the player a weapon for every slot. Instead of equipping the last given weapon, the script randomly decides which weapon to equip after all the weapons are given.

local weaponIDs = {1,22,25,28,30,33,35,16,42,10,44,40} -- Weapon IDs

function givePlayerWeapons ( thePlayer, commandName )
   -- Give the player a weapon for each slot
   for i = 1 , #weaponIDs do
      giveWeapon (thePlayer,weaponIDs[i], 1 )
   end
   -- Randomly select which weapon to equip, slots 1 through 12
   setPedWeaponSlot ( thePlayer, math.random ( 1, 12) )
end
addCommandHandler ( "giveweapons", givePlayerWeapons )

setPedWeaponSlot

OOP Syntax Help! I don't understand this!

Syntax

Required Arguments

Returns

Code Examples

See Also

Ped Functions

Ped Events

Reference