Reference#
Snapshot properties, game events, and metric definitions.
Player properties#
Demo.snapshots() returns the properties below.
The mapping is also available as awpy.SNAPSHOT_PROPERTIES.
Use Demo.ticks() for supported aliases or raw network fields.
Identity & position#
Property |
Engine field |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
Three-dimensional speed from the velocity components |
Health & equipment#
Property |
Engine field |
|---|---|
|
|
|
|
|
|
|
|
|
holds a |
Weapons & utility held#
Property |
Engine field |
|---|---|
|
|
|
|
|
|
|
counts from |
|
full loadout (slot order) from |
Economy#
Property |
Engine field |
|---|---|
|
|
|
|
|
|
Status#
Property |
Engine field |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
Active weapon: |
|
Active weapon: |
|
|
|
|
|
|
Reload properties come from the active weapon. Both are false without an active weapon and null if a required schema field is missing. Omitted Boolean values default to false when the field exists. Quiet reloads have synthetic tests but no demo-backed validation.
Game events#
Use demo.events.names and demo.events.counts to inspect a demo.
Use demo.events[name] to read an event DataFrame.
This catalog is also available as awpy.GAME_EVENTS.
Event |
Description |
|---|---|
|
A round begins. |
|
Freeze time ends; players can move. |
|
A round is decided (carries winner + reason). |
|
The post-round period ends. |
|
A new match starts. |
|
A phase (e.g. the first half) ends. |
|
A player is killed (attacker, victim, assister, weapon). |
|
A player takes damage (health / armor before & after). |
|
A player is blinded by a flashbang. |
|
A player joins or switches team (fires for everyone at halftime). |
|
Spawn / connect / disconnect. |
|
Footstep / jump / map ping. |
|
A weapon is fired (or a grenade thrown). |
|
Reload / scope zoom. |
|
Pick up / buy / equip an item. |
|
Start planting / bomb planted. |
|
Start defusing / bomb defused. |
|
Explode / drop / pick up. |
|
Flash / HE detonation. |
|
Smoke starts / dissipates. |
|
Decoy start / finish. |
|
Molotov / incendiary fire starts / burns out. |
Definitions#
How the reconstructed and aggregated numbers are computed.
Sides & teams#
side is "terrorist" / "counter-terrorist", from the player’s m_iTeamNum
(2 / 3). Players swap sides at halftime, so a player’s side changes across the
match; the persistent identity is steamid.
A player’s team — the organization they play for — is separate and does not
swap: demo.players reports it as team_clan_name (e.g. "Imperial"), from the
CCSTeam entities’ m_szClanTeamname. Tournament and league servers set it;
casual matchmaking leaves it null.
Ticks & time#
Demo timings are in ticks. demo.tick_rate gives ticks per second, computed
from the demo’s own playback timing (playback_ticks / playback_time) and falling
back to 64.0 when the demo does not report it. Competitive CS2 demos are 64 tick;
some are recorded at 128.
round_seconds = (row["end_tick"] - row["freeze_end_tick"]) / demo.tick_rate
Buy types (round_economy)#
Each team’s buy per round, from its total equipment value at freeze end (the
finished buy — not equipment_value_round_start, which is the pre-buy carry-over):
pistol— round 1, and the first round after the halftime side switch. Detected from the switch itself (a majority of players change side between consecutive rounds), so it holds for any match format; overtime’s later switches are classified by value, not as pistols.eco— team equipment value < $5,000 (saving).force— $5,000 – $20,000 (a partial / force buy).full— ≥ $20,000.
Knife rounds are excluded.
Player stats (stats)#
One row per player, over the match. Knife rounds are excluded by default (pass
include_knife_rounds=True to Demo.player_stats() to keep them). Every
player is treated as having played every round, so KAST / ADR denominators are the
match’s round count and players who join or leave mid-match are approximate.
Kills / deaths — enemy kills (suicides and team kills excluded) and deaths.
Assists — the game’s recorded assister, plus teammates whose enemy blind is still active at the kill. Each player receives at most one assist per kill. The killer cannot also receive an assist.
Flash assists (
flash_assists) — recorded flash assists and active blind matches. These are a subset of assists. Several players can assist one kill. Blind matches must use the same round and victim pawn (when its ID and serial are available). Timing uses the demo’s tick rate.Headshot % (
headshot_pct) —headshot_kills / kills × 100(0 with no kills).Opening kill / death — the attacker / victim of the first kill of a round.
Traded death — each revenge kill trades only the earliest qualifying teammate death within 5.25 seconds. Each death can be traded once. The matched death has
victim_tradedinkills; the revenge kill hasis_trade.KAST — the percentage of rounds in which the player got a Kill, an Assist, Survived (was not killed), or was Traded.
ADR — enemy health removed per round. Each hit is capped at the victim’s remaining health. Team, self, and world damage are excluded.
Multi-kill rounds (
multikill_2k…multikill_5k) — rounds with exactly 2 / 3 / 4 / 5-or-more kills.
Clutches#
A clutch starts when a player becomes the last survivor on their side with at least one living opponent.
clutches_played— how many such situations the player was in.clutches_won— how many of those rounds their side went on to win.clutch_1v1…clutch_1v5— clutches won, bucketed by how many opponents were alive at the moment the player was left alone. Losses are counted inclutches_playedonly, soclutch_1v1 + … + clutch_1v5 == clutches_won.
The opponent count is fixed when the clutch starts. Later deaths do not change a 1v3 to a 1v1. A side with one player for the complete round does not register a clutch: the player must become the last survivor.
Alive / dead state is reconstructed from the event datasets rather than from per-tick entity state, so each side’s roster for a round is inferred from who appears in that round’s events — carried across rounds a player was quiet in, and re-derived after each side swap. Players who join or leave mid-match are covered only for the rounds they actually appear in.
Utility#
utility_damage— grenade damage dealt to enemies (HE + molotov / incendiary), as actual HP removed (chained like ADR).flashes_thrown— flashbangs the player threw.enemies_flashed— times an enemy was blinded by one of the player’s flashes (team-flashes and self-flashes are not counted).flash_duration_dealt— total seconds of blindness inflicted on enemies.
Positions#
Positions use Hammer units, with Z as the vertical axis. The Navigation meshes and Visibility & map data APIs use the same coordinates.