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

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

bool: value

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