onPlayerWeaponSwitch | Multi Theft Auto: Wiki Skip to content
Multi Theft Auto: Wiki

onPlayerWeaponSwitch

Client-side
Server-side
Shared

This event is triggered whenever a player's equipped weapon slot changes. This means giveWeapon and takeWeapon will trigger this event if the equipped slot is forced to change.

Parameters

int previousWeaponID, int currentWeaponID
  • previousWeaponID: An integer representing the weapon that was switched from.
  • currentWeaponID: An integer representing the weapon that was switched to.

Source

element: The source of this event is the player that switched his weapon.

Canceling

If this event is canceled, then the player's weapon won't be switched.

Code Examples

server

This example allows you to disable shoot ability for certain weapons, it should be noted that it will be more efficient if done on client-side.

local weaponsToBlock = {
  [38] = true, -- minigun
}


function onPlayerWeaponSwitch(previousWeaponID, currentWeaponID)
  local blockFire = (not weaponsToBlock[currentWeaponID]) -- reverse bool, true/worthy will give us false, and false/unworthy will give us true


  toggleControl(source, "fire", blockFire) -- toggle player control to fire weapon
end
addEventHandler("onPlayerWeaponSwitch", root, onPlayerWeaponSwitch)

See Also

Player Events
Player Functions
Reference