Garry's Mod Wiki

Home / GM:EntityTakeDamage

GM:EntityTakeDamage

  boolean GM:EntityTakeDamage( Entity target, CTakeDamageInfo dmg )
View Source Search Github

Description

Called when an entity is about to take damage. You can modify all parts of the damage info in this hook or completely block the damage event.

See GM:PostEntityTakeDamage if you wish to hook the final damage event.

Applying damage from this hook to the entity taking damage will lead to infinite loop/crash.

Arguments

1 Entity target
The entity taking damage
2 CTakeDamageInfo dmg
Detailed information about the damage event.

Returns

1 boolean
Return true to completely block the damage event

Example

Explosion damage is reduced to players only.

hook.Add( "EntityTakeDamage", "EntityDamageExample", function( target, dmginfo ) if ( target:IsPlayer() and dmginfo:IsExplosionDamage() ) then dmginfo:ScaleDamage( 0.5 ) // Damage is now half of what you would normally take. end end )

Example

Players in vehicles takes halved damage.

hook.Add( "EntityTakeDamage", "EntityDamageExample2", function( target, dmginfo ) if ( target:IsVehicle() ) then local ply = target:GetDriver() if ( IsValid(ply) && dmginfo:GetDamage() > 1 ) then dmginfo:SetDamage(dmginfo:GetDamage() / 2) ply:TakeDamageInfo(dmginfo) dmginfo:SetDamage(0) end end end )

Account Management

Special Pages

Wiki List