Changelog#
3.0.0#
Rust parser for CS2 demos with Python bindings and Polars DataFrames.
Publish wheels for Python 3.11–3.15 on Linux, macOS, and Windows. Python 3.15 uses a stable-ABI wheel built with Python 3.14.
Split tests by behavior and share replay fixtures.
Correct player IDs in combat events. Convert legacy event handles before serial validation.
Keep dead players’ event IDs through validated original-controller handles.
Count recorded assisters and active flash throwers once each per kill.
Match each trade kill to the earliest qualifying death within 5.25 seconds. Use the same rule for kill flags, traded deaths, and KAST.
Require Python Polars 2.x. The lockfile now selects
2.0.0. Awpy dataset schemas are unchanged. See the Polars migration guide for changes to downstream queries, including lazy-query ordering.Shortened documentation and corrected cache, chat, and snapshot descriptions.
Shared developer CLI helpers for file opening, JSON output, row limits, and player labels. Removed redundant output buffers and an unused dependency.
Simplified Python dataset dispatch and shared map-control dataset selection.
Combat datasets:
rounds,kills,damages,bomb,shots,stats.Grenade datasets:
grenades(trajectories),fires,smokes, andblinds(flash events — who was blinded, by whom, and for how long).item_events— weapon-item transactions (purchases, pickups, and drops), reconstructed from inventory state so they work on demos without theitem_purchaseevent.Player datasets:
players(roster, including each player’s team / organization name);snapshots(...)for per-player state — position, velocity (components and 3D speed), health, armor, economy, and loadout — at a tick, a list of ticks, a contiguous range (start_tick/end_tick), or sampled across the match by a stride and/or event ticks.Snapshots now include nullable Boolean
is_reloadingandis_silent_reloadingcolumns from the active weapon. Both are false when there is no active weapon. Missing schema fields on an active weapon remain null. The silent-reload mapping has synthetic tests; real-demo validation is pending.statsalso reports clutches (clutches_played,clutches_won, andclutch_1v1…clutch_1v5) and utility (grenade damage, flashes thrown, enemies flashed, blind duration dealt);round_economyclassifies each team’s buy per round (pistol/eco/force/full).killsflags trades:is_trade(this kill avenged a teammate) andvictim_traded(this kill’s victim was avenged) — the same classification behindstats.traded_deaths.Metadata:
header,tick_rate,chat,convars.Fixed
Demo.chat. Awpy now reads user messages that packets store directly and messages insidesvc_UserMessage. It also readsSayTextChannel.Updated CS2 protobuf definitions to game build
2000924(source revision11076591). The generator uses a bundled compiler and removes unsupported C++ annotations from temporary inputs. Upstream files stay unchanged.Added the required Valve extension definitions. Hit group names now cover the engine’s
unused(9) andspecial(11) values.Added an advisory protobuf freshness check to CI. Run
./scripts/sync-protos.sh --checkto compare local files with upstream without changing them. This check does not block CI Check or releases.awpy.SNAPSHOT_PROPERTIESandawpy.GAME_EVENTS— discoverable catalogs of the per-player snapshot features (mapped to engine properties) and common events.Generic access:
header, theeventsmapping, andticks()— one natively typed row per player per tick, with default props and friendly aliases (X/Y/Z, velocity components and 3D speed,health,armor,team_num,name,money).Updated pbdems2 to
0.4.0for field-path fixes and faster decoding.Snapshot queries with two to four explicit ticks now use direct keyframe seeks when no other selector is set. These queries return only exact ticks, in tick order, without duplicates. Single-tick behavior is unchanged.
Reduced snapshot memory use. Segment columns stay separate, and plain numeric columns use their existing buffers when passed to Polars.
Added isolated Python API benchmarks with output checks, peak memory, runtime samples, and environment metadata.
Enabled level-one optimization for Awpy and pbdems2 in debug builds to reduce local and CI test time. Release settings are unchanged.
Kept the public names of legacy CS user messages after upstream enum renames.
Fixed weapon variant names in snapshots and item events. Shared entity classes now use the item-definition index, with a subclass-token fallback when that index is absent or unknown. This distinguishes Deagle/Revolver, M4A4/M4A1-S, and P2000/USP-S. Combat event weapon names are unchanged.
Player, flash, projectile, and inventory tracking keys entities by slot plus serial, preventing state from leaking when Source 2 reuses a slot. Raw
ticks(players_only=False)rows exposeentity_serialalongsideentity_id.Combat datasets collect selected game events during entity decoding. This removes a separate event scan and unused payload copies.
ticksandsnapshotsdecode keyframe segments in parallel.Reduced parser overhead in entity-heavy datasets. Field-key caches now use numeric class IDs and do not allocate a class-name string for each lookup.
Fixed truncated command streams. Message, event, and console-variable scans now return a parse error instead of incomplete data.
Faster cold
stats: combat events, rounds, and the player roster are now collected in one filtered pass. Stats-mode shots retain the identity and side needed for clutch reconstruction without decoding active-weapon entities. Player and blind tracking process only entities changed on the current tick.New
Demo.load(*datasets)plans, batches, and caches compatible datasets. Compatible event and projectile tables share passes. Stats reuse combat, round, and roster inputs and can collect requested bomb and shot rows.Demo.available_datasets()lists valid names.Enriched event and projectile datasets now expose each resolved entity’s create serial with its slot. This identity stays stable when Source 2 reuses a slot.
Snapshots now expose
is_blindedfromm_bFlashing. The existingflash_durationis documented as the replicated onset duration, not a remaining-time counter. Map control uses both values and no longer treats a stale duration as an active blind.Event-based snapshot selection decodes only the requested legacy event names instead of materializing the complete event stream. Projectile tracking also caches invariant thrower data.
Demo.player_stats()reuses decoded inputs and caches both knife-round variants. Calling the default form afterdemo.statsno longer parses the demo again.Steam ID columns now have an explicit
UInt64type, including empty and all-null columns. This prevents accidental floating-point conversion inside Awpy datasets.Added
tick_to_seconds()andseconds_to_tick()conversion helpers.awpy.plotfor radars, frames, heatmaps, nav meshes, and GIFs (awpy[plot]extra).plot.navdraws a map’s walkable areas and can highlight a set of them — e.g. a route fromNavMesh.find_path.awpy.VisibilityCheckerfor line-of-sight queries against map meshes, andawpy.NavMeshfor navigation-mesh area lookups and pathfinding.awpy.map_controlestimates control withraycast,vision, orreachability;awpy.plot.map_controlshades the radar by controlling side.awpy.data— map-data cache (mesh / nav / radar assets, versioned releases).awpycommand-line tool;awpy-devdeveloper CLI for parser internals.