<function name="WeaponEquip" parent="GM" type="hook"> <ishook>yes</ishook> <description> Called as a weapon entity is picked up by a player. See also <page>GM:PlayerDroppedWeapon</page>. <note>At the time when this hook is called <page>Entity:GetOwner</page> will return NULL. The owner is set on the next frame</note>⤶ <note>This will not be called when picking up a weapon you already have as the weapon will be removed and <page>WEAPON:EquipAmmo</page> will be called instead</note>⤶ <note>At the time when this hook is called <page>Entity:GetOwner</page> will return `NULL`. The owner is set on the next frame.</note>⤶ <note>This will not be called when picking up a weapon you already have as the weapon will be removed and <page>WEAPON:EquipAmmo</page> will be called instead.</note>⤶ </description> <realm>Server</realm> <predicted>No</predicted> <args> <arg name="weapon" type="Weapon">The equipped weapon.</arg> <arg name="owner" type="Player">The player that is picking up the weapon.</arg> </args> </function> <example> <description>Drops the player's weapons as soon as they pick one up.</description> <code> hook.Add( "WeaponEquip", "WeaponEquipExample", function( wep, ply ) timer.Simple( 0, function() ply:DropWeapon( wep ) end ) hook.Add( "WeaponEquip", "WeaponEquipExample", function( weapon, ply ) timer.Simple( 0, function() ply:DropWeapon( weapon )⤶ end )⤶ end ) </code> </example>