npc_headcrab
![]() |
---|
CHeadcrab |
![]() |
npc_headcrab
is a point entity available in Half-Life 2,
Half-Life 2: Episode One,
Half-Life 2: Episode Two,
Half-Life 2: Deathmatch, and
Black Mesa.
These are the classic, slow-moving headcrabs. They attack by jumping at the player's head and inflict a nominal amount of damage. Almost any weapon can dispatch them easily.
Commonly found attached to a zombie host body, they will detach if that host is sufficiently damaged below the head.
There are several other headcrab variants and associated zombie types.
See also env_headcrabcanister which is a mortar shell containing a payload of headcrabs. The mortar shell inflicts damage within a radius of where it lands and releases headcrabs after impact. Triggers and entity options offer control over impact damage and when the headcrabs are released, among other options.



Dedicated Console Variables
- sk_headcrab_health <int>
- A headcrab's spawn health.
- sk_headcrab_melee_dmg <int>
- Melee damage.
- g_debug_headcrab <bool>
- Toggle headcrab debugging.
- sk_headcrab_min_jump_dist <int>
- Headcrab min jump distance. Only in Black Mesa 2012.
- sk_headcrab_max_jump_dist <int>
- Headcrab max jump distance. Only in Black Mesa 2012.
- sv_headcrab_can_latch_on_player <bool>
- Toggles headcrab's ability to attach player's head (if player catches it with head). Only in Black Mesa 2012. Requires this texture to display properly as the texture has been removed.
Keyvalues
CBaseCombatCharacter:
CAI_BaseNPC:
DamageFilter:
|
- Parent (parentname) <targetname>
- Specifies a movement parent. An entity will maintain its initial offset from its parent. An attachment point can be added to the end of the name, separated by a comma.
- Start burrowed ([todo internal name (i)]) <boolean>
- Should this npc start burrowed? Will unburrow via input or if an enemy gets near.
Flags
- Wait Till Seen : [1]
- Prevents this NPC from seeing (or being seen) until it enters a player's viewcone.
- Gag : [2]
- Won't make IDLE sounds until it's angry.
- Fall to ground (unchecked means teleport to ground) : [4]
- Drop Healthkit : [8]
- Causes this NPC to drop an item_healthvial upon dying.
- Efficient : [16]
- Don't acquire enemies or avoid obstacles
- Wait For Script : [128]
- Forces this NPC to "wait" in an idle state until it finishes playing a scripted_sequence.
- Long Visibility/Shoot : [256]
- By default, increases a NPC's sight range to
6,000
units and allows it to attack from anywhere within that distance.
- Fade Corpse : [512]
- Think outside PVS : [1024]
- Allows this NPC to run its regular AI outside of any player's PVS.
- Template NPC : [2048]
- Marks this NPC as a template for entities like npc_template_maker. The NPC will not spawn on its own. This is not needed for point_template.
- Do Alternate collision for this NPC (player avoidance) : [4096]
- Don't drop weapons : [8192]
- Ignore player push : [16384] (in all games since
)
- Entity won't give way to player.
- Start hidden : [65536]
- Start hanging from ceiling : [131072]
Inputs
- Burrow <void>
- Burrow. If no burrow points within 512 units, does nothing.
- BurrowImmediate <void>
- Burrow immediate.
- Unburrow <void>
- Unburrow.
CAI_BaseNPC:
- ActivateSpeedModifier !FGD
- DisableSpeedModifier !FGD
- Break
- Smash into pieces. If this is not possible, disappear.
- BecomeRagdoll (in all games since
)
- Remove itself and instantly become a ragdoll with zero force (just go limp). OnDeath, etc. outputs will NOT be fired.
- ForceInteractionWithNPC <string> <string> (in all games since
)
- Force the NPC to use a dynamic interaction with another NPC. Syntax is <targetname> <dynamic interaction>.
- ForgetEntity <targetname >
- Clears out the NPC's knowledge of a named entity.
- UpdateEnemyMemory (in all games since
)
- Update (or create) this NPC's memory of of the given entity.
- GagEnable
- GagDisable
- Gagged NPCs won't speak (or moan, caw, etc.) unless made to be a choreographed scene.
- HolsterWeapon (in all games since
)
- UnholsterWeapon (in all games since
)
- Force the NPC to holster or unholster their weapon. Ignored if the NPC is scripting or if the NPC doesn't use weapons.
- HolsterAndDestroyWeapon (in all games since
)
- Same as
HolsterWeapon
, except the weapon is destroyed once it has been concealed.
- IgnoreDangerSounds <float >
- Ignore danger sounds for the specified number of seconds.
- InsideTransition !FGD
- OutsideTransition !FGD
- SetBodyGroup <integer >
- HACK: Sets this NPC's body group (from 0–n).
- SetEnemyFilter <string >
- SetHealth <integer >
- Set the NPC's health.
- SetMaxLookDistance <float > (only in
)
- Sets the maximum look distance for the NPC. Defaults are 2048 and 6000 for long range NPCs.
- SetRelationship <string|targetname or classname> <string|disposition> <int|rank>
- Changes whether this NPC likes or dislikes certain others. Used like the ai_relationship entity, with this NPC as the subject.
- Values for
disposition
are:D_HT
: HateD_FR
: FearD_LI
: LikeD_NU
: Neutral
- SetSquad <string >
- Change the name of this NPC's squad. Leaving the parameter blank will remove the NPC from any existing squad.
- StartScripting
- StopScripting
- Enter/exit scripting state, where NPCs ignore a variety of stimulus that would make them break out of their scripts. They ignore danger sounds, ignore +Use, don't idle speak or respond to other NPCs' idle speech, and so on.
- Wake
- Wakes up the NPC if it is sleeping.
CBaseCombatCharacter:
- KilledNPC !FGD
- Tells the entity it killed something. Despite the name, this can include a player. This input will be automatically sent by the victim when they die.
- physdamagescale <float >
- Scales damage energy when this character is hit by a physics object. With a value of 0 the NPC will take no damage from physics.
DamageFilter:
- SetParent <string >
- Move with this entity. See Entity Hierarchy (parenting).
- SetParentAttachment <string >
- Change this entity to attach to a specific attachment point on its parent. The entity will teleport so that the position of its root bone matches that of the attachment. Entities must be parented before being sent this input.
- SetParentAttachmentMaintainOffset <string >
- As above, but without teleporting. The entity retains its position relative to the attachment at the time of the input being received.
- ClearParent
- Removes this entity from the the movement hierarchy, leaving it free to move independently.
- StartHangingFromCeiling
- Start hanging from ceiling.
- DropFromCeiling
- Drop if hanging from ceiling.
Outputs
|
See also
- CBaseAnimating
- Point entities
- Non-internal Half-Life 2 entities
- Half-Life 2 entities
- Half-Life 2 point entities
- Non-internal Half-Life 2: Episode One entities
- Half-Life 2: Episode One entities
- Half-Life 2: Episode One point entities
- Non-internal Half-Life 2: Episode Two entities
- Half-Life 2: Episode Two entities
- Half-Life 2: Episode Two point entities
- Non-internal Half-Life 2: Deathmatch entities
- Half-Life 2: Deathmatch entities
- Half-Life 2: Deathmatch point entities
- Non-internal Black Mesa entities
- Black Mesa entities
- Black Mesa point entities
- NPC entities
- Half-Life 2 NPCs
- Headcrabs