> Agent-readable docs index: /llms.txt. Download /docs.zip to grep all markdown files locally.

---
title: Generic Source Events
description: Generic Source engine events shared across Source games (gameevents.res)
icon: layers
---

These events **should** apply to all Source engine games. Taken from the Orange Box `resource/gameevents.res` list. Hook them the same way as any other event — `events.<name>:set(callback)` — and read the listed fields from the callback table.

<Card title="events namespace" icon="zap" href="/csgo/api-reference/namespaces/events" horizontal>
  In order to reference an event, index the `events` namespace with an event name.
</Card>

## team\_info

Info about team

<Schema title="Callback fields">
  <SchemaField name="teamid" type="number">
    unique team id
  </SchemaField>

  <SchemaField name="teamname" type="string">
    team name eg "Team Blue"
  </SchemaField>
</Schema>

## team\_score

Team score changed

<Schema title="Callback fields">
  <SchemaField name="teamid" type="number">
    team id
  </SchemaField>

  <SchemaField name="score" type="number">
    total team score
  </SchemaField>
</Schema>

## teamplay\_broadcast\_audio

emits a sound to everyone on a team. (OB Only)

<Schema title="Callback fields">
  <SchemaField name="team" type="number">
    unique team id
  </SchemaField>

  <SchemaField name="sound" type="string">
    name of the sound to emit
  </SchemaField>
</Schema>

## player\_team

A player changed their team

<Schema title="Callback fields">
  <SchemaField name="userid" type="number">
    user ID on the server
  </SchemaField>

  <SchemaField name="team" type="number">
    team id
  </SchemaField>

  <SchemaField name="oldteam" type="number">
    old team id
  </SchemaField>

  <SchemaField name="disconnect" type="boolean">
    team change because player disconnects
  </SchemaField>

  <SchemaField name="autoteam" type="boolean">
    true if the player was auto assigned to the team (OB only)
  </SchemaField>

  <SchemaField name="silent" type="boolean">
    if true wont print the team join messages (OB only)
  </SchemaField>

  <SchemaField name="name" type="string">
    player's name (OB only)
  </SchemaField>
</Schema>

## player\_class

A player changed their class

<Schema title="Callback fields">
  <SchemaField name="userid" type="number">
    user ID on server
  </SchemaField>

  <SchemaField name="class" type="string">
    new player class / model
  </SchemaField>
</Schema>

## player\_death

A player has died

<Schema title="Callback fields">
  <SchemaField name="userid" type="number">
    user ID who died
  </SchemaField>

  <SchemaField name="attacker" type="number">
    user ID who killed
  </SchemaField>
</Schema>

## player\_hurt

A player was hurt

<Schema title="Callback fields">
  <SchemaField name="userid" type="number">
    player index who was hurt
  </SchemaField>

  <SchemaField name="attacker" type="number">
    player index who attacked
  </SchemaField>

  <SchemaField name="health" type="number">
    remaining health points
  </SchemaField>
</Schema>

## player\_chat

A public player chat

<Schema title="Callback fields">
  <SchemaField name="teamonly" type="boolean">
    true if team only chat
  </SchemaField>

  <SchemaField name="userid" type="number">
    chatting player
  </SchemaField>

  <SchemaField name="text" type="string">
    chat text
  </SchemaField>
</Schema>

## player\_score

Player's scores changed

<Schema title="Callback fields">
  <SchemaField name="userid" type="number">
    user ID on server
  </SchemaField>

  <SchemaField name="kills" type="number">
    Number of kills
  </SchemaField>

  <SchemaField name="deaths" type="number">
    Number of deaths
  </SchemaField>

  <SchemaField name="score" type="number">
    total game score
  </SchemaField>
</Schema>

## player\_spawn

Player spawned in game

<Schema title="Callback fields">
  <SchemaField name="userid" type="number">
    user ID on server
  </SchemaField>
</Schema>

## player\_shoot

Player shot their weapon

<Schema title="Callback fields">
  <SchemaField name="userid" type="number">
    user ID on server
  </SchemaField>

  <SchemaField name="weapon" type="number">
    weapon ID
  </SchemaField>

  <SchemaField name="mode" type="number">
    weapon mode
  </SchemaField>
</Schema>

## player\_use

When a player uses an option

<Schema title="Callback fields">
  <SchemaField name="userid" type="number">
    user ID on server
  </SchemaField>

  <SchemaField name="entity" type="number">
    entity used by player
  </SchemaField>
</Schema>

## player\_changename

Player changed name

<Schema title="Callback fields">
  <SchemaField name="userid" type="number">
    user ID on server
  </SchemaField>

  <SchemaField name="oldname" type="string">
    players old (current) name
  </SchemaField>

  <SchemaField name="newname" type="string">
    players new name
  </SchemaField>
</Schema>

## player\_hintmessage

??? (OB only)

<Schema title="Callback fields">
  <SchemaField name="hintmessage" type="string">
    localizable string of a hint
  </SchemaField>
</Schema>

## base\_player\_teleported

??? (OB only)

<Schema title="Callback fields">
  <SchemaField name="entindex" type="number" />
</Schema>

## game\_init

Sent when a new game is started (OB only)

## game\_newmap

Sent when new map is completely loaded

<Schema title="Callback fields">
  <SchemaField name="mapname" type="string">
    map name
  </SchemaField>
</Schema>

## game\_start

A new game starts

<Schema title="Callback fields">
  <SchemaField name="roundslimit" type="number">
    max round
  </SchemaField>

  <SchemaField name="timelimit" type="number">
    time limit
  </SchemaField>

  <SchemaField name="fraglimit" type="number">
    frag limit
  </SchemaField>

  <SchemaField name="objective" type="string">
    round objective
  </SchemaField>
</Schema>

## game\_end

A game ended

<Schema title="Callback fields">
  <SchemaField name="winner" type="number">
    winner team/user id
  </SchemaField>
</Schema>

## round\_start

The round started

<Schema title="Callback fields">
  <SchemaField name="timelimit" type="number">
    round time limit in seconds
  </SchemaField>

  <SchemaField name="fraglimit" type="number">
    frag limit
  </SchemaField>

  <SchemaField name="objective" type="string">
    round objective
  </SchemaField>
</Schema>

## round\_end

The round ended

<Schema title="Callback fields">
  <SchemaField name="winner" type="number">
    winner team/user id
  </SchemaField>

  <SchemaField name="reason" type="number">
    reason why the team won
  </SchemaField>

  <SchemaField name="message" type="string">
    end round message
  </SchemaField>
</Schema>

## game\_message

A message sent by game logic to everyone

<Schema title="Callback fields">
  <SchemaField name="target" type="number">
    0 console, 1 HUD
  </SchemaField>

  <SchemaField name="text" type="string">
    the message text
  </SchemaField>
</Schema>

## break\_breakable

A breakable (func\_break) is broken.

<Schema title="Callback fields">
  <SchemaField name="entindex" type="number">
    index of the entity
  </SchemaField>

  <SchemaField name="userid" type="number">
    userid who broke the entity
  </SchemaField>

  <SchemaField name="material" type="number">
    BREAK\_GLASS, BREAK\_WOOD, etc
  </SchemaField>
</Schema>

## break\_prop

A breakable prop is broken.

<Schema title="Callback fields">
  <SchemaField name="entindex" type="number">
    index of the entity
  </SchemaField>

  <SchemaField name="userid" type="number">
    userid who broke the entity
  </SchemaField>
</Schema>

## entity\_killed

An entity has been killed (OB only)

<Schema title="Callback fields">
  <SchemaField name="entindex_killed" type="number">
    index of the killed entity
  </SchemaField>

  <SchemaField name="entindex_attacker" type="number">
    index of the attacker
  </SchemaField>

  <SchemaField name="entindex_inflictor" type="number">
    index of the inflictor (weapon id, etc)
  </SchemaField>

  <SchemaField name="damagebits" type="number">
    the damagebits of the attack
  </SchemaField>
</Schema>

## bonus\_updated

??? (OB only)

<Schema title="Callback fields">
  <SchemaField name="numadvanced" type="number" />

  <SchemaField name="numbronze" type="number" />

  <SchemaField name="numsilver" type="number" />

  <SchemaField name="numgold" type="number" />
</Schema>

## achievement\_event

A player has received an achievement (OB only)

<Schema title="Callback fields">
  <SchemaField name="achievement_name" type="string">
    non-localized name of achievement
  </SchemaField>

  <SchemaField name="cur_val" type="number">
    Number of steps toward achievement
  </SchemaField>

  <SchemaField name="max_val" type="number">
    total # of steps in achievement
  </SchemaField>
</Schema>

## achievement\_increment

Sent whenever an achievement that's tracked on the HUD increases (OB only)

<Schema title="Callback fields">
  <SchemaField name="achievement_id" type="number">
    ID of achievement that went up
  </SchemaField>

  <SchemaField name="cur_val" type="number">
    Number of steps toward achievement
  </SchemaField>

  <SchemaField name="max_val" type="number">
    total # of steps in achievement
  </SchemaField>
</Schema>

## physgun\_pickup

Player picked up a physgun (OB only)

<Schema title="Callback fields">
  <SchemaField name="entindex" type="number">
    entity picked up
  </SchemaField>
</Schema>

## flare\_ignite\_npc

A flare has ignited a NPC (OB only)

<Schema title="Callback fields">
  <SchemaField name="entindex" type="number">
    entity ignited
  </SchemaField>
</Schema>

## helicopter\_grenade\_punt\_miss

??? (OB only)

## user\_data\_downloaded

Fired when achievements/stats are downloaded from Steam or XBOX Live (OB only)

## ragdoll\_dissolved

A ragdoll has dissolved (OB only)

<Schema title="Callback fields">
  <SchemaField name="entindex" type="number">
    index of the dissolved entity
  </SchemaField>
</Schema>

## hltv\_changed\_mode

??? (OB only)

<Schema title="Callback fields">
  <SchemaField name="oldmode" type="number" />

  <SchemaField name="newmode" type="number" />

  <SchemaField name="obs_target" type="number" />
</Schema>

## hltv\_changed\_target

??? (OB only)

<Schema title="Callback fields">
  <SchemaField name="mode" type="number" />

  <SchemaField name="old_target" type="number" />

  <SchemaField name="obs_target" type="number" />
</Schema>

## vote\_ended

Not currently implemented. See VotePass and VoteFailed UserMessages instead. (OB only)

## vote\_started

Currently unused. See the VoteStart UserMessage instead. (OB only)

<Schema title="Callback fields">
  <SchemaField name="issue" type="string" />

  <SchemaField name="param1" type="string" />

  <SchemaField name="team" type="number" />

  <SchemaField name="initiator" type="number">
    entity id of the player who initiated the vote
  </SchemaField>
</Schema>

## vote\_changed

Currently unused. See vote\_manager entity netprops instead.(OB only)

<Schema title="Callback fields">
  <SchemaField name="vote_option1" type="number" />

  <SchemaField name="vote_option2" type="number" />

  <SchemaField name="vote_option3" type="number" />

  <SchemaField name="vote_option4" type="number" />

  <SchemaField name="vote_option5" type="number" />

  <SchemaField name="potentialVotes" type="number" />
</Schema>

## vote\_passed

Currently unused. See the VotePass UserMessage instead. (OB only)

<Schema title="Callback fields">
  <SchemaField name="details" type="string" />

  <SchemaField name="param1" type="string" />

  <SchemaField name="team" type="number" />
</Schema>

## vote\_failed

Currently unused. See the VoteFailed UserMessage instead. (OB only)

<Schema title="Callback fields">
  <SchemaField name="team" type="number" />
</Schema>

## vote\_cast

Sent to all players when a player chooses a vote option (or more specifically, the server receives a vote command) (OB only)

<Schema title="Callback fields">
  <SchemaField name="vote_option" type="number">
    which option the player voted on
  </SchemaField>

  <SchemaField name="team" type="number" />

  <SchemaField name="entityid" type="number">
    entity id of the voter
  </SchemaField>
</Schema>

## vote\_options

Sent to players before VoteStart UserMessage to populate choices for a multiple choice vote (OB only)

<Schema title="Callback fields">
  <SchemaField name="count" type="number">
    Number of options - up to MAX\_VOTE\_OPTIONS \[ed: 5 for OB]
  </SchemaField>

  <SchemaField name="option1" type="string" />

  <SchemaField name="option2" type="string" />

  <SchemaField name="option3" type="string" />

  <SchemaField name="option4" type="string" />

  <SchemaField name="option5" type="string" />
</Schema>

## replay\_saved

??? (OB only)

## entered\_performance\_mode

??? (OB only)

## browse\_replays

??? (OB only)

## replay\_youtube\_stats

??? (OB only)

<Schema title="Callback fields">
  <SchemaField name="views" type="number" />

  <SchemaField name="likes" type="number" />

  <SchemaField name="favorited" type="number" />
</Schema>

## inventory\_updated

??? (OB only)

## cart\_updated

??? (OB only)

## store\_pricesheet\_updated

??? (OB only)

## gc\_connected

??? (OB only)

## item\_schema\_initialized

??? (OB only)
