Left 4 Dead 2/Scripting/Game Events

This is a wiki porting page.
This page was ported from a page from AlliedModders Wiki. It was originally at Left 4 Dead 2 Events. The original authors of this page are shown on the page's edit history page.

Refer back to Game Events (Source) for more events.

player_death

a game event, name may be 32 characters long; this extends the original player_death by a new field

userid (short) - user ID who died
entityid (long) - entity ID who died, userid should be used first, to get the dead Player. Otherwise, it is not a player, so use this.
attacker (short) - user ID who killed
attackername (string) - What type of zombie, so we don't have zombie names
attackerentid (long) - if the killer is not a player, the entindex of who killed. Again, use the attacker first
weapon (string) - weapon name killer used
headshot (bool) - signals a headshot
attackerisbot (bool) - is the attacker a bot
victimname (string) - What type of zombie, so we don't have zombie names
victimisbot (bool) - is the victim a bot
abort (bool) - did the victim abort
type (long) - damage type
victim_x (float) - victim's position in the x-axis
victim_y (float) - victim's position in the y-axis
victim_z (float) - victim's position in the z-axis

player_hurt

Called: Fires when a player entity takes damage.

Note: Does not fire when a survivor takes enough damage to become incapacitated.

Registers all playable classes (Hunter, Smoker, Boomer, Tank, Survivors). See infected_hurt for Witch and Common Infected

local (1) - Not networked
userid (short) - user ID who was hurt
attacker (short) - user id who attacked
attackerentid (long) - entity id who attacked, if attacker not a player, and userid therefore invalid
health (short) - remaining health points
armor (byte) - remaining armor points
weapon (string) - weapon name attacker used, if not the world
dmg_health (short) - damage done to health
dmg_armor (byte) - damage done to armor
hitgroup (byte) - hitgroup that was damaged
type (long) - damage type

player_activate

The earliest game event that generates when a CTerrorPlayer entity is being spawned

userid (short) - user ID on server

player_team

Called: Fires when a player switches team.

userid (short) - user ID on server
team (byte) - team id
oldteam (byte) - old team id
disconnect (bool) - team change because player disconnects
name (string) -
isbot (bool) -

player_bot_replace

Called: Fires when a bot replaces a player.
Related Events: Fires alongside player_first_spawn in order to spawn the bot; this event fires afterwards.

player (short) - user ID of the player
bot (short) - user ID of the bot

bot_player_replace

Called: Fires when a player replaces a bot.

bot (short) - user ID of the bot
player (short) - user ID of the player

Tip:Imagine using the slot operator when reading the name of these events bot <- player to remember whether the bot is being replaced or a player

player_afk

player (short) - user ID of the player

weapon_fire

Note: It fires before firing the weapon, even if it's being interrupted. For example: interrupting a Molotov throw by switching right before it's about to be thrown.

local (1) - don't network this, its way too spammy
userid (short) - user ID of the player who fires their weapon
weapon (string) - used weapon name
weaponid (short) - used weapon ID
count (short) - number of bullets

weapon_fire_on_empty

local (1) - don't network this, its way too spammy
userid (short) - user ID of the player who fires their weapon
weapon (string) - weapon name used
count (short) - number of bullets

weapon_reload

Called: Fires when a survivor reloads their weapon.

userid (short) - user ID of the player who reloads
manual (bool) - player manually started the reload

weapon_zoom

Called: Fires when a survivor uses the zoom feature on snipers.

Note: It fires when pressing the zoom button while holding a sniper, instead of zooming the weapon.

userid (short) - user ID of the survivor who zooms their weapon

ability_use

Called: Fires when an infected uses their ability
Issues: Doesn't fire for jockey

userid (short) - user ID of the player who uses their ability
ability (string) - Classname of ability. Possible values: 'ability_tongue', 'ability_vomit', 'ability_lunge', 'ability_spit', 'ability_charge', 'ability_throw' for the Smoker, Boomer, Hunter, Spitter, Charger and Tank, respectively.
context (short) - enum of the way it was used (different for each ability)

ammo_pickup

Called: Fires when a survivor fills their primary weapon's ammo by using weapon_ammo_spawn entity.

userid (short) - The player who got some ammo from a weapon_ammo_spawner

item_pickup

Called: Fires when a survivor picks up a weapon.

Note: It does not fire when picking up primary weapons and pistols on non weapon_*_spawn entities, excluding the give command.

userid (short) -
item (string) - either a weapon such as 'tmp' or 'hegrenade', or an item such as 'nvgs'

golden_crowbar_pickup

Called: Fires when a survivor picks up a golden crowbar.

userid (short) - The player who picked up the crowbar

grenade_bounce

Called: Fires when a grenade launcher projectile lands, or a thrown pipe bomb/molotov/bile jar bounces.

userid (short) - user ID of the projectile's owner
x (float) - the projectile's position in the x-axis
y (float) - the projectile's position in the y-axis
z (float) - the projectile's position in the z-axis

hegrenade_detonate

Called: Fires when molotov projectiles, pipe bomb projectiles, propane tanks or oxygen tanks detonate.

userid (short) - user ID of the detonated entities' owner
x (float) - detonated entity's position in the x-axis
y (float) - detonated entity's position in the y-axis
z (float) - detonated entity's position in the z-axis

bullet_impact

Called: Fires on bullet impact.

Bug*:Does not fire for the grenade launcher and miniguns.

userid (short) -
x (float) - bullet's position in the x-axis
y (float) - bullet's position in the y-axis
z (float) - bullet's position in the z-axis

player_footstep

userid (short) -

player_jump

Called: Fires when a player jumps.

userid (short) - user ID of the player who jumps

player_blind

userid (short) -

player_falldamage

Called: Fires when a player takes fall damage.

userid (short) - Who got hurt
damage (float) - for how much
causer (short) - Who caused them to do so (if anyone)

player_ledge_grab

Called: Fires when a survivor hangs from a ledge.

userid (short) - Who grabbed the ledge
causer (short) - Who caused them to do so (if anyone)

player_ledge_release

userid (short) - person who released from the ledge

door_moving

entindex (long) -
userid (short) -

door_open

userid (short) - Who opened the door
checkpoint (bool) - Is the door a checkpoint door
closed (bool) - Was the door closed when it started opening?

door_close

userid (short) - Who closed the door
checkpoint (bool) - Is the door a checkpoint door

door_unlocked

userid (short) - Who opened the door
checkpoint (bool) - Is the door a checkpoint door

rescue_door_open

userid (short) - Who opened the door
entindex (long) - door that opened

waiting_checkpoint_door_used

Someone tried to open a checkpoint door that is locked till everyone loads in

userid (short) - player who tried to open it
entindex (long) - door that was used

waiting_door_used_versus

Someone tried to open a checkpoint door that is locked till everyone loads in

userid (short) - player who tried to open it
entindex (long) - door that was used

waiting_checkpoint_button_used

Someone tried to push a button that's locked until everyone is gathered

userid (short) - player who tried to open it

success_checkpoint_button_used

Someone pushed a button that's locked until everyone is gathered

userid (short) - player who openned it

round_freeze_end

None (None) -

round_start

Related Events: Fires alongside round_start_pre_entity and round_start_post_nav.
Event order: round_start_pre_entity, round_start_post_nav, round_start.

timelimit (long) - round time limit in seconds
fraglimit (long) - frag limit in seconds
objective (string) - round objective

round_start_pre_entity

Related Events: Fires alongside round_start_post_nav and round_start.
Event order: round_start_pre_entity, round_start_post_nav, round_start.

None (None) -

round_start_post_nav

Related Events: Fires alongside round_start_pre_entity and round_start.
Event order: round_start_pre_entity, round_start_post_nav, round_start.

None (None) -

nav_blocked

area (long) -
blocked (bool) -

nav_generate

None (None) -

round_end_message

winner (byte) - winner team/user i
reason (byte) - reson why team won
message (string) - end round message

round_end

winner (byte) - winner team/user i
reason (byte) - reson why team won
message (string) - end round message
time (float) -

vote_ended

None (None) -

vote_started

issue (string) -
param1 (string) -
votedata (string) -
team (byte) -
initiator (long) - entity id of the player who initiated the vote
reliable (1) - this event is reliable

vote_changed

yesVotes (byte) -
noVotes (byte) -
potentialVotes (byte) -

vote_passed

details (string) -
param1 (string) -
team (byte) -
reliable (1) - this event is reliable

vote_failed

team (byte) -
reliable (1) - this event is reliable

vote_cast_yes

Called: Fires when a player votes yes on an ongoing vote.

team (byte) -
entityid (long) - entity id of the voter

vote_cast_no

Called: Fires when a player votes no on an ongoing vote.

team (byte) -
entityid (long) - entity id of the voter

infected_hurt

Called: Fires when an infected takes damage.
Registers for non-playable classes (Common Infected, Witch). See player_hurt for other playable classes

local (1) - don't network this, its way too spammy
attacker (short) - player userid who attacked
entityid (long) - entity id of infected
hitgroup (byte) - hitgroup that was damaged
amount (short) - how much damage was done
type (long) - damage type

infected_death

Called: Fires when an infected dies.

attacker (short) - user ID who killed
infected_id (short) - ID of the infected that died
gender (short) - gender (type) of the infected
weapon_id (short) - ID of the weapon used
headshot (bool) - signals a headshot
minigun (bool) - signals a minigun kill
blast (bool) - signals a death from blast damage
submerged (bool) - indicates the infected was submerged

hostname_changed

hostname (string) -

difficulty_changed

Called: Fires when the difficulty is changed ingame.

Note: Alongside a successful vote, it also fires when the difficulty is manually changed via z_difficulty convar.

It appears that strDifficulty is z_difficulty value

newDifficulty (short) -
oldDifficulty (short) -
strDifficulty (string) -

finale_start

rushes (short) -

finale_rush

None (None) -

finale_escape_start

None (None) -

finale_vehicle_incoming

campaign (string) -

finale_vehicle_ready

campaign (string) -

finale_vehicle_leaving

survivorcount (short) - number of survivors that made it out

finale_win

map_name (string) -
difficulty (short) -

mission_lost

As in, the survivor team failed. Opposite of finale_win, but not necessarily during the finale.

None (None) -

finale_radio_start

health (short) -

finale_radio_damaged

health (short) -

final_reportscreen

Right before the final report screen comes up, let the awards possibly fire

None (None) -

map_transition

When campaign cinematics start

None (None) -

player_transitioned

Note:

Fires when a player has transitioned to a new chapter from the previous chapter in a campaign.
While in coop or realism and the map is not a first session (!Director.IsSessionStartMap()), fires after a map reset because of mission loss.
Fires alongside player_spawn, if the survivor has died from the previous chapter, this event fires first, and vice versa.
This event never fires on versus; the game treats every versus game as the first session.
Fires when switching campaigns via voting, even though Director.IsSessionStartMap() returns true, it is not the same as using the changelevel convar, players transition as they are dead from the previous.

userid (short) - the person that just finished transitioning

heal_begin

Called: Fires when a survivor starts using a medkit.

userid (short) - person doing the healing
subject (short) - person being healed

heal_success

Called: Fires when a survivor successfully uses a medkit.

userid (short) - person doing the healing
subject (short) - person being healed
health_restored (short) - amount of health restored

heal_end

Issues: subject is broken for this event, it always appears to be the player doing the healing

userid (short) - person doing the healing
subject (short) - person being healed

heal_interrupted

Called: Fires when a survivor's healing process from a medkit is interrupted.

userid (short) - person who was being healed, but moved.
subject (short) - person being healed

ammo_pack_used

userid (short) - person giving the ammo
subject (short) - person receiving ammo

give_weapon

userid (short) - The giver of the weapon
recipient (short) - The recipient of the weapon
weapon (short) - The ID of the weapon given

pills_used

Called: Fires when a survivor successfully uses pain pills.

userid (short) - person who had the pills
subject (short) - person swallowing the pills

pills_used_fail

userid (short) - person who tried to use the pills

ammo_pack_used_fail_no_weapon

userid (short) - person who tried to use the ammo pack
subject (short) - person it failed to help

ammo_pack_used_fail_full

userid (short) - person who tried to use the ammo pack
subject (short) - person it failed to help

ammo_pack_used_fail_doesnt_use_ammo

userid (short) - person who tried to use the ammo pack
subject (short) - person it failed to help

ammo_pile_weapon_cant_use_ammo

userid (short) - person who tried to use an ammo pile with a grenade launcher

defibrillator_begin

Called: Fires when a survivor starts using a defibrillator.

userid (short) - person who is defibrillating.
subject (short) - person being revived

defibrillator_used

Called: Fires when a survivor successfully uses a defibrillator.

userid (short) - person who used the defibrillator
subject (short) - person it helped

defibrillator_used_fail

userid (short) - person who tried to use the defibrillator
subject (short) - person it failed to help

defibrillator_interrupted

userid (short) - person who was defibrillating, but moved.
subject (short) - person being revived

upgrade_pack_begin

Called: Fires when a survivor starts deploying an upgrade pack.

userid (short) - person who is deploying the pack

upgrade_pack_used

Called: Fires when a survivor successfully deploys an upgrade pack.

upgradeid (short) - entity index of the deployed upgrade pack (either upgrade_ammo_explosive or upgrade_ammo_incendiary)
userid (short) - person who is deploying the pack

upgrade_item_already_used

Called: Fires when a survivor tries to use an already used upgrade pack.

userid (short) - person who tried to use an ammo upgrade twice
upgradeclass (string) - classname of the upgrade we tried to use

upgrade_failed_no_primary

Called: Fires when a survivor tries to use an unused upgrade pack with no primary weapon.

Note: If the upgrade pack has been used and the survivor has no primary weapon, upgrade_item_already_used fires instead of this event.

userid (short) - person who tried to use an upgrade without having a primary weapon
upgrade (string) - name of the upgrade we tried to use, eg "INCENDIARY_AMMO"

dead_survivor_visible

userid (short) - The player who sees the entity
subject (long) - Entindex of the entity they see
deadplayer (short) - user id of the dead player represented

adrenaline_used

Called: Fires when a survivor successfully uses an adrenaline.

userid (short) - person who had and used the adrenaline

revive_begin

Called: Fires when a survivor starts reviving an incapacitated survivor.

userid (short) - person doing the reviving
subject (short) - person being revived

revive_success

Called: Fires when a survivor successfully revives an incapacitated survivor.

userid (short) - person doing the reviving
subject (short) - person who was revived
lastlife (bool) - person revived dies if they fall again
ledge_hang (bool) - 1 if person revived was ledge hanging

revive_end

userid (short) - person doing the reviving
subject (short) - person being revived
ledge_hang (bool) - person is ledge hanging

drag_begin

userid (short) - person doing the dragging
subject (short) - person being dragged

drag_end

userid (short) - person doing the dragging
subject (short) - person being dragged

player_incapacitated

Called: Fires when a survivor becomes incapacitated, or a tank is killed.

userid (short) - person who became incapacitated
attacker (short) - user ID who made us incapacitated
attackerentid (long) - if attacker not player, entindex of who made us incapacitated
weapon (string) - weapon name attacker used
type (long) - damage type

player_incapacitated_start

Called: Fires when a survivor is about to become incapacitated.

Tip: Use this event to check a survivor's state before becoming incapacitated.

userid (short) - person who became incapacitated
attacker (short) - user ID who made us incapacitated
attackerentid (long) - if attacker not player, entindex of who made us incapacitated
weapon (string) - weapon name attacker used
type (long) - damage type

player_entered_start_area

When a player spawns into the player start area

userid (short) - person who entered

player_first_spawn

Called: Fires when a player entity is spawned for the first time.

Note: When a player idles, a survivor bot is spawned, firing this event.

userid (short) - person who spawned
map_name (string) -
isbot (bool) -

player_left_start_area

When a player leaves the player start area

userid (short) - person who left

player_left_safe_area

When a player leaves the safe area

userid (short) - person who left
playercount (byte) -

player_entered_checkpoint

Called: Fires when a player entity enters a checkpoint area.

userid (short) - player who entered
entityid (long) - If not a player, the entity index of the one entering
door (long) - Entity index of the checkpoint door the player entered to get here.
area (long) -
doorname (string) - name of the entity they see

player_left_checkpoint

Called: Fires when a player entity leavess a checkpoint area.

userid (short) - player who left
entityid (long) - If not a player, the entity index of the one exiting
area (long) -

player_shoved

Called: Fires when a survivor shoves another survivor.
Issues: Does not fire when shoving a survivor that is currently in combat.

userid (short) - player index who was shoved
attacker (short) - player index who attacked them

entity_shoved

Called: Fires when a survivor shoves a non-point entity, except survivors.

entityid (short) - the entity index of the one who was shoved
attacker (short) - player index who attacked them

player_jump_apex

Called: Fires when a player reaches the highest point of their jump. In other words, their upward velocity becomes 0, right before the player starts falling.

Note: Using noclip fires this event constantly.

userid (short) - player who jumped

player_blocked

userid (short) - player index who was trying to move
blocker (short) - player index who kept them from moving

player_now_it

Called: Fires when a player entity is covered in bile.

userid (short) - Player who is now it
attacker (short) - player that did the it-ing
exploded (bool) - whether it was vomit or explosion
infected (bool) - is the vomit infectious
by_boomer (bool) - came from a boomer

player_no_longer_it

Called: Fires when a player entity's bile effect wears off.

userid (short) - Player who is now no longer it

witch_harasser_set

Called: Fires when a witch is startled.

Note: Using CommandABot on the witch also fires this event.

userid (short) - Player who woke up the witch
witchid (long) - Entindex of witch woken up
first (bool) - First time the witch set a harasser

witch_spawn

Called: Fires when a witch is spawned.

witchid (long) - Entindex of witch spawning right now.

witch_killed

Called: Fires when a witch dies.

userid (short) - Player who killed the witch
witchid (long) - Entindex of witch that was killed.
oneshot (bool) - TRUE if the Witch was killed with one shot
melee_only (bool) - TRUE if the witch was only killed by melee attacks (no blast, burn, or bullet damage)
bride (bool) - bride variant?

tank_spawn

Called: Fires when a witch spawns.

userid (short) - User ID of the tank spawning now
tankid (long) - Entindex of tank spawning right now.

melee_kill

userid (short) - Player who bashed the infected
entityid (long) - Entindex of infected what got killed
ambush (bool) - Infected was unaware when killed

area_cleared

userid (short) - person who cleared the area
area (long) - id of the cleared area

award_earned

userid (short) - player who earned the award
entityid (long) - client likes ent id
subjectentid (long) - entity id of other party in the award, if any
award (short) - id of award earned

tongue_grab

Called: Fires when a smoker starts grabbing a survivor.

userid (short) - player who did the grabbing
victim (short) - player that got grabbed

tongue_broke_bent

Called: Fires when a smoker's tongue breaks due to world geometry bend.

userid (short) - Tongue owner

tongue_broke_victim_died

userid (short) - Tongue owner

tongue_release

Called: Fires when a smoker releases a survivor, whether choked or not, etc.

Note:

Fires twice in all release cases, except tongue_broke_bent where it only fires once.
Second iteration returns distance and victim arguments as 0.

userid (short) - The tongue owner
victim (short) - The (now released) victim
distance (long) - Distance the victim was dragged.

choke_start

Called: Fires when a smoker starts choking a survivor.

userid (short) - The choker
victim (short) - The person being choked

choke_end

Called: Fires when a smoker stops choking a survivor, regardless of the situation.

userid (short) - The choker
victim (short) - The person being choked

choke_stopped

Called: Fires when a smoker tongue is cleared on a choked player, fires alongside choke_end (choke_stopped fires first).

Note:Does not fire when (choke_end still fires):

The smoker is staggered with a propane/oxygen tank, pipe bomb, explosive ammo, grenade launcher, boomer explosion, and charger impact.
Another special takes over the pinned survivor or kills the smoker.
The smoker is killed by a gas can, a firework box, a Molotov, and incendiary ammo.
The smoker ledge-hanged the survivor.
Using Stagger() on either the smoker or the survivor.

Issues: While the event does not fire while staggering the smoker with the methods above, it fires when it is killed using only the grenade launcher and explosive ammo.

userid (short) - Who stopped it
victim (short) - And who was being choked
smoker (short) - The tongue owner
release_type (short) - How did it break?

tongue_pull_stopped

Called: Fires when a smoker tongue is cleared on a dragging player. Includes cuts.

Note:Does not fire when:

The smoker is staggered with a propane/oxygen tank, pipe bomb, explosive ammo, grenade launcher, boomer explosion, and charger impact.
Another special takes over the pinned survivor or kills the smoker.
The smoker is killed by a gas can, a firework box, a Molotov, and incendiary ammo.
The smoker ledge-hanged the survivor.
Using Stagger() on either the smoker or the survivor.

Issues: While the event does not fire while staggering the smoker with the methods above, it fires when it is killed using only the grenade launcher and explosive ammo.

userid (short) - Who stopped it
victim (short) - And who was being pulled
smoker (short) - The tongue owner
release_type (short) - How did it break?
damage_type (long) - bullet, slash, chainsaw

lunge_shove

userid (short) - player who did the lunging
victim (short) - player that got lunged

lunge_pounce

Called: Fires when a hunter successfully pounces a survivor.

userid (short) - player who did the lunging
victim (short) - player that got lunged
distance (long) - Distance from pounce start to contact
damage (short) -

pounce_end

userid (short) - Player who did the pouncing
victim (short) - And who was being pounced

pounce_stopped

Called: Fires whenever a player clears a hunter dominating a survivor, fires alongside pounce_end (pounce_stopped is fired first).

Note:

Does not fire if staggered by pipe bomb, propane/oxygen tank, explosive ammo, grenade launcher, boomer explosion, charger impact, and Stagger(). (pounce_end still fires)
Fires if the hunter is killed by any method above, except boomer explosion and charger impact.
A special that kills the hunter returns userid as the special's userid.
Killing the hunter by shoving fires this event before player_hurt. However, killing it by any other means fires the event after player_hurt.

Issues: Shoving a hunter right after it pounces a survivor does not release the survivor, but the event still fires.

userid (short) - Who stopped it
victim (short) - And who was being pounced

pounce_attempt_stopped

userid (short) - Who stopped it
weaponid (short) - used weapon ID

fatal_vomit

userid (short) - Who vomited
victim (short) - And who was killed or incapped

survivor_call_for_help

userid (short) - The actual player entity who is awaiting rescue.
subject (long) - SurvivorRescue entity representing the player who needs to be rescued from the closet (used for position)

survivor_rescued

Called: Fires when a survivor is successfully rescued from a rescue closet.

rescuer (short) - player that did the rescuing
victim (short) - the survivor being rescued
dooridx (long) - ent index of the rescue door

survivor_rescue_abandoned

None (None) -

relocated

userid (short) - player who was relocated

respawning

userid (short) - player who started respawning

tank_frustrated

userid (short) - player who was culled

weapon_given

userid (short) - player who got the weapon
giver (short) - player that did the giving
weapon (short) - weapon id given
weaponentid (short) - weapon entity id

weapon_drop

Called: Fires When an item is removed from a survivor's inventory.
Related Events: Called before heal_success, defibrillator_used, upgrade_pack_used, but called after pills_used and adrenaline_used.

userid (short) - player who dropped the weapon
item (string) - either a weapon such as 'tmp' or 'hegrenade', or an item such as 'nvgs'
propid (short) - entindex of the dropped weapon

weapon_drop_to_prop

Called: Fires when a player drops an item that turns into a prop, such as a gas can, a firework box, a propane tank, an oxygen tank, cola bottles, a gnome, etc.

userid (short) - player who dropped the weapon
item (string) - weapon string "weapon_*"
propid (short) - entindex of the dropped weapon

break_breakable

Override from gameevents.res

userid (short) - userid of breaker
entindex (long) - entindex of thing breaking
material (byte) - BREAK_GLASS, BREAK_WOOD, etc
hulkonly (bool) - SF_BREAK_HULK_ONLY
achievement (short) - tag to identify achievement on the client

achievement_earned

Called: Fires when a player earns an achievement.

player (byte) - entindex of the player
achievement (short) - achievement ID

spec_target_updated

None (None) -

spawner_give_item

Called: Fires when a player picks up an item from weapon_*_spawn entities.

userid (short) - Item recipient
item (string) - Name of item given
spawner (long) - entindex of the spawner entity

create_panic_event

A panic event has been created, though not necessarily started

userid (short) - player who was started the panic

explain_pills

subject (long) - The weapon_pain_pills spawner that is indicated

explain_weapons

subject (long) - The weapon_pain_pills spawner that is indicated

entity_visible

userid (short) - The player who sees the entity
subject (long) - Entindex of the entity they see
classname (string) - Classname of the entity they see
entityname (string) - name of the entity they see

weapon_spawn_visible

userid (short) - The player who sees the entity
subject (long) - Entindex of the entity they see
weaponname (string) - weapon name, or "melee"
subtype (string) - melee weapon name

boomer_near

userid (short) - The boomer
victim (short) - The survivor whom the boomer has gotten very close to

explain_pre_radio

explain the rescue radio reminds you to get ready for the finale

userid (short) -
subject (long) -

started_pre_radio

explain the rescue radio reminds you to get ready for the finale

userid (short) -
subject (long) -

explain_radio

explain the rescue radio to start the finale

userid (short) -
subject (long) -

explain_gas_truck

explain how pulling the lever on the gas truck starts the finale

userid (short) -
subject (long) - The lever

explain_panic_button

explain that pressing this button starts a panic event.

userid (short) -
subject (long) - The panic button

explain_elevator_button

explain how to operate the hospital elevator button.

userid (short) -
subject (long) - The button

explain_lift_button

explain how to operate the lift button.

userid (short) -
subject (long) - The lift button

explain_church_door

explain how to provoke the crazy church guy.

userid (short) -
subject (long) - The saferoom door

explain_emergency_door

explain how to open the emergency door.

userid (short) -
subject (long) - The door

explain_crane

explain how to lower the box on the crane.

userid (short) -
subject (long) - The lever/button

explain_bridge

explain how to close the gates to make a bridge.

userid (short) -
subject (long) - The button

explain_gas_can_panic

explain how to shoot the gas can.

userid (short) -
subject (long) - The gas can

explain_van_panic

explain how to start the van.

userid (short) -
subject (long) - The van

explain_mainstreet

explain how to lower the forklift

userid (short) -
subject (long) - The forklift

explain_train_lever

explain how to operate the train lever.

userid (short) -
subject (long) - The lever on box car

explain_disturbance

explain that disturbances (car alarm) attract the infected horde

userid (short) -
subject (long) - The source of disturbance

explain_scavenge_goal

explain where to put the scavenge mode items

userid (short) -
subject (long) - The collection device

explain_scavenge_leave_area

explain that leaving the area, starts round

userid (short) -
subject (long) - The entity

begin_scavenge_overtime

Enter overtime in a scavenge round

scavenge_round_start

a scavenge round has begun

round (byte) - round number, 1 based
firsthalf (bool) - start of the first half of the round

scavenge_round_halftime

a scavenge round is in halftime

scavenge_round_finished

a scavenge round has ended

scavenge_score_tied

a team just tied the score

versus_round_start

a versus round has begun

gascan_pour_blocked

can't pour the gas, someone else already is

userid (short) -

gascan_pour_completed

player finished pouring a can

userid (short) -

gascan_dropped

userid (short) -

gascan_pour_interrupted

we got interrupted pouring the gas can

userid (short) - person who interuppted us

scavenge_match_finished

winners (byte) - winner team

versus_match_finished

winners (byte) - winner team

use_target

A new use target has been found

targetid (long) - Entindex of the use target
classname (string) - classname of the use target
isprop (bool) - is this a prop that can be carried

player_use

Called: Fires when a Survivor presses +USE on a useable entity. i.e. Weapons, items, doors.
Related Events: If targetid is an item, item_pickup is called prior to player_use

Note:

It does not fire when using a mounted gun.
It does not fire when the Use input is fired on a survivor.

Bug:Doesn’t fire when player is pressing use while reloading a weapon

userid (short) - userid of user
targetid (long) - Entindex of the used entity

friendly_fire

attacker (short) - player who fired the weapon
victim (short) - player who got shot
guilty (short) - player who was at fault
type (long) - damage type

gameinstructor_draw

None (None) -

gameinstructor_nodraw

None (None) -

request_weapon_stats

userid (short) - userid of user requesting their stats

player_talking_state

player (byte) -
istalking (bool) -

weapon_pickup

client event for player has picked up a weapon. If that does not work, try using the "item_pickup" event.

context (byte) - split screen message context
weaponid (byte) -
weaponslot (byte) -
dropped_by_infected (byte) - gender of the Infected that dropped the weapon

hunter_punched

userid (short) - player who caused ignition
hunteruserid (long) - user ID of Hunter
islunging (bool) - TRUE if the Hunter was in the act of lunging

hunter_headshot

userid (short) - player who made the headshot
hunteruserid (long) - user ID of Hunter
islunging (bool) - TRUE if the Hunter was in the act of lunging

zombie_ignited

userid (short) - player who caused ignition
gender (short) - gender (type) of the infected
entityid (long) - entity ID of Tank
victimname (string) - "Witch", "Tank", "Hunter", "Smoker", or "Infected"
fire_ammo (bool) - true if incendiary ammo was used

boomer_exploded

Called: Fires when a boomer explodes.
Related Events: Fires after player_death

userid (short) - Boomer that exploded
attacker (short) - player who caused the explosion
splashedbile (bool) - Exploding boomer splashed bile on Survivors

non_pistol_fired

Called: Fires when a survivor attacks with a non-pistol weapon.

Note:

Only fires once for each survivor; subsequent non-pistol weapons being shot do not fire this event. Most likely used to detect if a survivor has used a melee weapon or not for melee-only achievements.
It continues firing again after a map transition, reset and team swap.

userid (short) - User that fired a non-pistol weapon

weapon_fire_at_40

This is networked, special event for game instructor

userid (short) -
weapon (string) - used weapon name
weaponid (short) - used weapon ID
count (short) - number of bullets

total_ammo_below_40

sent for any ammo type, except those with max ammo 1, or infinite ammo, like pistols

userid (short) -

player_hurt_concise

Abbreviated version of 'player_hurt' that is networked

userid (short) - user ID who was hurt
attackerentid (long) - entity id who attacked, if attacker not a player, and userid therefore invalid
type (long) - damage type
dmg_health (short) - damage done to health

tank_killed

Called: Fires when a tank dies.
Issues: It does not fire if the tank is not a bot.

userid (short) - user ID of dead tank
attacker (short) - user id of killer
solo (bool) - TRUE if a player single-handedly killed the Tank
melee_only (bool) - TRUE if the tank was only killed by melee attacks (no blast, burn, or bullet damage)
l4d1_only (bool) - TRUE if l4d1 survivors inflicted damage and the l4d2 survivors did not)

tank_rock_killed

Called: Fires when a survivor destroys a tank rock.

userid (short) - user id of killer

achievement_write_failed

Used for a notification message when an achievement fails to write

None (None) -

ghost_spawn_time

Used for clients to know how long until they become a ghost (and can spawn)

userid (short) - user ID of the player that is becoming a ghost
spawntime (short) - How long of a wait until player is a ghost

survival_at_30min

Called: Fires when the survivors survive 30 minutes on a survival map.
Used to know when we elapse 30 minutes on a survival map

survival_at_10min

Called: Fires when the survivors survive 10 minutes on a survival map.
Used to know when we elapse 10 minutes on a survival map

explain_pre_drawbridge

Point out the button that starts the gauntlet finale.

userid (short) -
subject (long) -

explain_drawbridge

userid (short) -
subject (long) -

explain_perimeter

userid (short) -
subject (long) -

explain_deactivate_alarm

userid (short) -
subject (long) -

explain_impound_lot

userid (short) -
subject (long) -

explain_decon

userid (short) -
subject (long) -

explain_mall_window

userid (short) -
subject (long) -

explain_mall_alarm

userid (short) -
subject (long) -

explain_coaster

userid (short) -
subject (long) -

explain_coaster_stop

userid (short) -
subject (long) -

explain_decon_wait

userid (short) -
subject (long) -

gauntlet_finale_start

explain_float

userid (short) -
subject (long) -

explain_ferry_button

userid (short) -
subject (long) -

explain_hatch_button

userid (short) -
subject (long) -

explain_shack_button

userid (short) -
subject (long) -

upgrade_incendiary_ammo

userid (short) -

upgrade_explosive_ammo

userid (short) -

receive_upgrade

Called: Fires when a survivor successfully receives an incendiary, explosive, or laser sight upgrades.

userid (short) -
upgrade (string) -

explain_vehicle_arrival

subject (long) -

mounted_gun_start

userid (short) -
subject (long) -

mounted_gun_overheated

userid (short) -

explain_burger_sign

userid (short) -
subject (long) -

explain_carousel_button

userid (short) -
subject (long) -

explain_carousel_destination

userid (short) -
subject (long) -

explain_stage_lighting

userid (short) -
subject (long) -

explain_stage_finale_start

userid (short) -
subject (long) -

explain_stage_survival_start

userid (short) -
subject (long) -

ability_out_of_range

userid (short) -
ability (string) - ability classname

explain_stage_pyrotechnics

userid (short) -
subject (long) -

explain_c3m4_radio1

userid (short) -
subject (long) -

explain_c3m4_radio2

userid (short) -
subject (long) -

explain_gates_are_open

userid (short) -
subject (long) -

explain_c2m4_ticketbooth

userid (short) -
subject (long) -

explain_c3m4_rescue

userid (short) -
subject (long) -

explain_hotel_elevator_doors

userid (short) -
subject (long) -

explain_gun_shop_tanker

userid (short) -
subject (long) -

explain_gun_shop

userid (short) -
subject (long) -

explain_store_alarm

userid (short) -
subject (long) -

explain_store_item

userid (short) -
subject (long) -

explain_store_item_stop

userid (short) -
subject (long) -

explain_survival_generic

userid (short) -
subject (long) -

explain_survival_alarm

userid (short) -
subject (long) -

explain_survival_radio

userid (short) -
subject (long) -

explain_survival_carousel

userid (short) -
subject (long) -

explain_return_item

userid (short) -
subject (long) -

explain_save_items

userid (short) -
subject (long) -

spit_burst

Called: Fires when a spitter's spit hits the ground.

Note: Spitter's spit on death also fires this event.

userid (short) -
subject (long) -

entered_spit

userid (short) -
subject (long) -

temp_c4m1_getgas

userid (short) -
subject (long) -

temp_c4m3_return_to_boat

userid (short) -
subject (long) -

explain_c1m4_finale

userid (short) -
subject (long) -

c1m4_scavenge_instructions

userid (short) -
subject (long) -

punched_clown

userid (short) - player who punched the clown

charger_killed

Called: Fires on a charger's death.

userid (short) - user ID of dead charger
attacker (short) - user id of killer
melee (bool) - TRUE if a player killed the charger with a melee weapon
charging (bool) - TRUE if the charger was charging when it died

spitter_killed

Called: Fires on a spitter's death.

userid (short) - user ID of dead spitter
attacker (short) - user id of killer
has_spit (bool) - TRUE if the spitter spit at some point

jockey_ride

Called: Fires when a jockey successfully rides a survivor.

userid (short) - player who did the lunging
victim (short) - player that got lunged

jockey_ride_end

Called: Fires when a jockey releases a survivor.

Note:rescuer return 0 when:

The jockey is being cleared by shoving.
Another special takes over the jockeyed survivor.
The commons kill the biled jockey.
The jockey incapacitates the survivor, including ledge-hangs.
The jockey is killed or stumbled by a charger's impact.

Note:

A jockey stumbled by a boomer explosion returns rescuer argument as the boomer's userid.
Using Stagger() on the jockey returns rescuer argument as the jockey's userid.
Using Stagger() on the survivor returns rescuer argument as the survivor's userid.

userid (short) - player who did the lunging
victim (short) - player that got lunged
rescuer (short) - Who stopped it
ride_length (float) - Duration of our ride

jockey_punched

userid (short) - user ID of player that shoved the jockey
jockeyuserid (long) - user ID of Jockey
islunging (bool) - TRUE if Jockey was in the act of lunging

jockey_headshot

userid (short) - user ID of player that landed a headshot on the Jockey
jockeyuserid (long) - user ID of Jockey
islunging (bool) - TRUE if Jockey was in the act of lunging

jockey_killed

Called: Fires on a jockey's death.

userid (short) - user ID of dead jockey
attacker (short) - user id of killer
weapon (string) - weapon name

non_melee_fired

Called: Fires when a survivor attacks with a non-melee weapon.

Note:

Only fires once for each survivor; subsequent non-melee weapons being fired do not fire this event. Most likely used to detect if a survivor has used a non-melee weapon or not for non-melee achievements.
It continues firing again after a map transition, reset and team swap.

userid (short) - User that fired a non-melee weapon

infected_decapitated

userid (short) - userid of the player who did the decapitation
weapon (string) - melee weapon name

upgrade_pack_added

upgradeid (short) -
userid (short) -

vomit_bomb_tank

Called: Fires when a survivor biled a tank using a vomit jar.

Note: Does not fire when biled using HitWithVomit() script function.

userid (short) - userid of the player who biled the tank

triggered_car_alarm

Called: Fires when a survivor triggers a car alarm.

userid (short) - user ID of player who activated car alarm

panic_event_finished

charger_charge_start

Called: Fires when a charger starts charging.
Issues: Called more than once per ability use. For consistency, check ability_use
Issues: Can be called after charger_charge_end. Use ability_use for an alternative start-to-end relationship.

userid (short) - user ID of the charger

charger_charge_end

Called: Fires when a charger stops charging.

userid (short) - user ID of the charger

charger_carry_start

Called: Fires when a charger starts carrying a survivor while charging.

Bug*:Does not fire when a charger stops charging right after it carries a survivor, usually happens when the survivor is near a wall. Subsequently, charger_carry_end does not fire.

userid (short) - user ID of the charger
victim (short) - user ID of the player who was charged

charger_carry_end

Called: Fires when a charger stops charging while carrying a survivor.

userid (short) - user ID of the charger
victim (short) - user ID of the player who was charged

charger_carry_kill

Called: Fires when a survivor dies while being carried by a charger.

Note: Only works on competitive gamemodes, like versus.

userid (short) - user ID of the charger
victim (short) - user ID of the victim

charger_impact

Called: Fires when a survivor is sent flying by a charger’s charge impact.

userid (short) - user ID of the charger
victim (short) - user ID of the player who was impacted

charger_pummel_start

Called: Fires when a charger starts pummeling a survivor.

userid (short) - user ID of the charger
victim (short) - user ID of the player who was charged

charger_pummel_end

Called: Fires when a charger stops pummeling a survivor.

Note:

Killing the charger or survivor being pummeled to death returns rescuer as 0.
It only returns rescuer as the survivor's userid when the charger is staggered by a pipe bomb, explosive ammo, propane/oxygen tank.
Using Stagger() on the survivor returns rescuer argument as 0.
Using Stagger() on the charger returns rescuer argument as the charger's userid.

userid (short) - user ID of the charger
victim (short) - user ID of the player who was charged
rescuer (short) - user ID of the player who rescued them

strongman_bell_knocked_off

The arcade bell on c2m4_barns

userid (short) -
subject (short) -

molotov_thrown

userid (short) -

gas_can_forced_drop

userid (short) - player that forced the drop
victim (short) - player that dropped it

explain_need_gnome_to_continue

none (none) -

explain_survivor_glows_disabled

userid (short) - The player we're explaining to

explain_item_glows_disabled

userid (short) - The player we're explaining to

explain_rescue_disabled

userid (short) - The player we're explaining to

explain_bodyshots_reduced

userid (short) - The player we're explaining to

explain_witch_instant_kill

userid (short) - The player we're explaining to

set_instructor_group_enabled

group (string) -
enabled (short) -

versus_marker_reached

userid (short) -
marker (short) -

start_score_animation

survival_round_start

Called: Fires when a survivor round starts.

scavenge_gas_can_destroyed

userid (short) - The player that destroyed it

explain_sewer_gate

userid (short) -
subject (long) -

explain_sewer_run

userid (short) -
subject (long) -

explain_c6m3_finale

userid (short) -
subject (long) -

finale_bridge_lowering

userid (short) -
subject (long) -

m60_streak_ended

I was holding down the m60 trigger, and now I'm not

none (none) -

chair_charged

userid (short) -

song_played

none (none) -

foot_locker_opened

userid (short) -

player_connect_full

userid (short) -

player_say

userid (short) -
text (string) -

stashwhacker_game_won

Called: Fires after winning a game of stashwhacker in chapter 4 of Dark Carnival (c2m4).

subject (long) - info_game_event_proxy entity for wam_achievement_event

entity_killed

entindex_inflictor (long) - entity index of the inflictor
entindex_killed (long) - entity index of the killed entity
damagebits (long) - damage type
entindex_attacker (long) - entity index of the attacker