Left 4 Dead 2/Scripting/Game Events

← Left 4 Dead 2 Level Creation

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.

This template (and its redirect) is  Deprecated. Its use is not recommended and its functionality may be compromised.
You can help our editors by replacing or deleting this template on the Pages that use this template. Once no more pages use this template, it should be Marked for deletion.

Additional notes:
Use #switch parser function instead. Example

{{#switch: {{language}}
| #default = English
| ja = 日本語
| zh-tw = 中文（台灣）
‎}} 

player_death

a game event, name may be 32 charaters long; this extents the original player_death by a new fields

• 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 killer not a player, the entindex of who killed. Again, use 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_y (float) -
• victim_z (float) -

player_hurt

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_team

player change his 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

Bot replaced a player

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

bot_player_replace

Player replaced a bot

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

player_afk

• player (short) - user ID of the player

weapon_fire

• local (1) - don't network this, its way too spammy
• userid (short) -
• 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) -
• weapon (string) - weapon name used
• count (short) - number of bullets

weapon_reload

• userid (short) -
• manual (bool) - player manually started the reload

weapon_zoom

• userid (short) -

ability_use

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

• userid (short) -
• 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

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

item_pickup

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

golden_crowbar_pickup

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

grenade_bounce

• userid (short) -

hegrenade_detonate

• userid (short) -
• x (float) -
• y (float) -
• z (float) -

bullet_impact

• userid (short) -
• x (float) -
• y (float) -
• z (float) -

player_footstep

• userid (short) -

player_jump

• userid (short) -

player_blind

• userid (short) -

player_falldamage

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

player_ledge_grab

• 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_pre_entity

• None (None) -

round_start_post_nav

• 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

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

vote_cast_no

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

infected_hurt

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

• 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

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 awards possibly fire

• None (None) -

map_transition

When campaign cinematics start

• None (None) -

player_transitioned

When campaign cinematics end and player is transitioned to first person view

• userid (short) - the person that just finished transitioning

heal_begin

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

heal_success

• 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

• 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

• 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

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

defibrillator_used

• 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

• userid (short) - person who is deploying the pack

upgrade_pack_used

• upgradeid (short) -
• userid (short) - person who is deploying the pack

upgrade_item_already_used

• 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

• 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

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

revive_begin

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

revive_success

• userid (short) - person doing the reviving
• subject (short) - person who was revived
• lastlife (bool) - person revived will die 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

when a player becomes incapacitated. This is also called when 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

when a player is about to become incapacitated, so you can see his last living state

• 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

when a player spawns for the first time in a given mission

• 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

when a basecombatcharacter enters a checkpoint area

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

player_left_checkpoint

when a player leaves 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

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

entity_shoved

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

player_jump_apex

• 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

• 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

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

witch_harasser_set

• 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

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

witch_killed

• 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

• 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

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

tongue_broke_bent

• userid (short) - Tongue owner

tongue_broke_victim_died

• userid (short) - Tongue owner

tongue_release

Fired in all cases where the tongue releases a victim, whether choked or not, etc.

Note:

• Fires twice in all release cases, except tongue_broke_bent where it only fires once.
• Second firation will return distance and victim parameters as 0.

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

choke_start

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

choke_end

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

choke_stopped

Called 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 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 gascan, firework box, 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 will fire 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 when a smoker tongue is cleared on a dragging player. Includes cuts.

Note:Does not fire when:

• The smoker is staggered with 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 gascan, firework box, 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 will fire 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

• 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

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

Note:

• Will not fire if staggered by pipe bomb, propane/oxygen tank, explosive ammo, grenade_launcher, boomer explosion, charger impact, and Stagger(). (pounce_end will still fire)
• Fires if the hunter killed by any methods above, except boomer explosion and charger impact.
• A special that kills the hunter will return userid as the special's userid.

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

• 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

• 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: 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

• 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

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

spec_target_updated

• None (None) -

spawner_give_item

A spawner has given a player an item (weapon, pills, ammo, health kit, etc)

• 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 will be indicated

explain_weapons

• subject (long) - The weapon_pain_pills spawner that will be 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 will remind you to ready for the finale

• userid (short) -
• subject (long) -

started_pre_radio

explain the rescue radio will remind you to ready for the finale

• userid (short) -
• subject (long) -

explain_radio

explain the rescue radio will start the finale

• userid (short) -
• subject (long) -

explain_gas_truck

explain how pulling the lever on the gas truck will start the finale

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

explain_panic_button

explain that pressing this button will start 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 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 interuppted 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

a new use target has been foundCalled: When a Survivor presses +USE on a useable entity. i.e. Weapons, items, doors
Related Events: If targetid is an item, item_pickup will be called prior to player_use

• 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

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

non_pistol_fired

• 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

• 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

• 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

Used to know when we elapse 30 minutes on a survival map

survival_at_10min

Used to know when we elapse 10 minutes on a survival map

explain_pre_drawbridge

Point out the button that will start 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) -

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

• 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

Triggers even after Spitter's death.Called: Triggers when Spitter's spit hits the ground.

• 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

• 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: Triggers in 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

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

jockey_ride_end

Fires in all cases where a jockey releases the survivor.

Note:rescuer will 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 incaps the survivor, including ledge-hangs.
• The jockey is killed or stumbled by a charger impact.

Note:

• A jockey stumbled by a boomer explosion will return rescuer parameter as the boomer's userid.
• Using Stagger() on the jockey will return rescuer parameter as the jockey's userid.
• Using Stagger() on the survivor will return rescuer parameter 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

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

non_melee_fired

• 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

• userid (short) - userid of the player who used the bomb

triggered_car_alarm

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

charger_charge_start

The moment when the charger starts chargingIssues: 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

• userid (short) - user ID of the charger

charger_carry_start

The moment when the charger grabs a survivor

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

charger_carry_end

The moment when the charger stops charging a survivor (and will soon start pummeling)

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

charger_carry_kill

When a charger kills a survivor with a carry.

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

charger_impact

When a charger impacts a survivor they aren't carrying

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

charger_pummel_start

The moment when the 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

When the charger is cleared from the survivor or the survivor dies.

• userid (short) - user ID of the charger
• victim (short) -
• 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) -

stashwhacker_game_won

• userid (short) -
• subject (short) -

versus_marker_reached

• userid (short) -
• marker (short) -

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) -