SetPedWeaponSlot

This function changes the selected weapon slot of a ped.

Syntax

bool setPedWeaponSlot ( ped thePed, int weaponSlot )

OOP Syntax Help! I don't understand this!

Method: ped:setWeaponSlot(...)

Variable: .weaponSlot

Counterpart: getPedWeaponSlot

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.

Weapon Slots

• 0: WEAPONSLOT_TYPE_UNARMED
• 1: WEAPONSLOT_TYPE_MELEE
• 2: WEAPONSLOT_TYPE_HANDGUN
• 3: WEAPONSLOT_TYPE_SHOTGUN
• 4: WEAPONSLOT_TYPE_SMG (used for driveby's)
• 5: WEAPONSLOT_TYPE_RIFLE
• 6: WEAPONSLOT_TYPE_SNIPER
• 7: WEAPONSLOT_TYPE_HEAVY
• 8: WEAPONSLOT_TYPE_THROWN
• 9: WEAPONSLOT_TYPE_SPECIAL
• 10: WEAPONSLOT_TYPE_GIFT
• 11: WEAPONSLOT_TYPE_PARACHUTE
• 12: WEAPONSLOT_TYPE_DETONATOR

Returns

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

Example

Click to collapse [-]

Server

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 )

See Also

• addPedClothes
• getPedClothes
• removePedClothes
• createPed
• getPedAmmoInClip
• getPedArmor
• getPedFightingStyle
• getPedOccupiedVehicle
• getPedOccupiedVehicleSeat
• getPedStat
• getPedTarget
• getPedTotalAmmo
• getPedWalkingStyle
• getPedWeapon
• getPedWeaponSlot
• getPedContactElement
• getValidPedModels
• isPedChoking
• isPedDead
• isPedDoingGangDriveby
• isPedDucked
• isPedHeadless
• isPedInVehicle
• isPedOnFire
• isPedOnGround
• isPedWearingJetpack
• killPed
• removePedFromVehicle
• setPedAnimation
• setPedAnimationProgress
• setPedAnimationSpeed
• setPedArmor
• setPedDoingGangDriveby
• setPedFightingStyle
• setPedHeadless
• setPedOnFire
• setPedStat
• setPedWalkingStyle
• setPedWeaponSlot
• warpPedIntoVehicle