We now have a discord channel: Discord
Demoparser is a tool for analysing CS2 replay files "demos". All the heavy lifting is done in Rust, but you use it from the comfort of Python/JavaScript. The parser takes a slightly different approach to exposing the information in the demo. Rather than letting you hook onto events in a streaming fashion, it lets you "query" the demo similarly to how you would interact with a database.
Python: pip install demoparser2
NodeJS: npm i @laihoe/demoparser2
WASM: npm i demoparser2
from demoparser2 import DemoParser
parser = DemoParser("path_to_demo.dem")
event_df = parser.parse_event("player_death", player=["X", "Y"], other=["total_rounds_played"])
ticks_df = parser.parse_ticks(["X", "Y"])
var {parseEvent, parseTicks} = require('@laihoe/demoparser2');
let event_json = parseEvent("path_to_demo.dem", "player_death", ["X", "Y"], ["total_rounds_played"])
let ticks_json = parseTicks("path_to_demo.dem", ["X", "Y"])
The benchmark finds the coordinates of all player deaths. Code: Benchmark
Benchmarked 50 demos containing a mix of (MM, Faceit, HLTV) demos. Total size: 4.6GB
device | CPU cores | total time | MB/s |
---|---|---|---|
gaming PC | 12 | 6.14s | 749 |
ThinkPad T14 gen 2 | 4 | 14.00s | 328 |
Gaming pc specs: CPU: Ryzen 5900x, SSD: Samsung 980 pro NVME
Thinkpad specs: CPU: i5-1335g7, SSD: Toshiba XG6 NVME
Both devices run Ubuntu 20.04
Python/JS are rougly as fast.
Name | "Real" name |
---|---|
X | m_vec + m_cell |
Y | m_vec + m_cell |
Z | m_vec + m_cell |
health | m_iHealth |
score | m_iScore |
mvps | m_iMVPs |
is_alive | m_bPawnIsAlive |
balance | m_iAccount |
inventory | _ |
life_state | m_lifeState |
pitch | m_angEyeAngles[0] |
yaw | m_angEyeAngles[1] |
is_auto_muted | m_bHasCommunicationAbuseMute |
crosshair_code | m_szCrosshairCodes |
pending_team_num | m_iPendingTeamNum |
player_color | m_iCompTeammateColor |
ever_played_on_team | m_bEverPlayedOnTeam |
is_coach_team | m_iCoachingTeam |
rank | m_iCompetitiveRanking |
rank_if_win | m_iCompetitiveRankingPredicted_Win |
rank_if_loss | m_iCompetitiveRankingPredicted_Loss |
rank_if_tie | m_iCompetitiveRankingPredicted_Tie |
comp_wins | m_iCompetitiveWins |
comp_rank_type | m_iCompetitiveRankType |
is_controlling_bot | m_bControllingBot |
has_controlled_bot_this_round | m_bHasControlledBotThisRound |
can_control_bot | m_bCanControlObservedBot |
armor | m_iPawnArmor |
has_defuser | m_bPawnHasDefuser |
has_helmet | m_bPawnHasHelmet |
spawn_time | m_iPawnLifetimeStart |
death_time | m_iPawnLifetimeEnd |
game_time | net_tick |
is_connected | m_iConnected |
player_name | m_iszPlayerName |
player_steamid | m_steamID |
fov | m_iDesiredFOV |
start_balance | m_iStartAccount |
total_cash_spent | m_iTotalCashSpent |
cash_spent_this_round | m_iCashSpentThisRound |
music_kit_id | m_unMusicID |
leader_honors | m_nPersonaDataPublicCommendsLeader |
teacher_honors | m_nPersonaDataPublicCommendsTeacher |
friendly_honors | m_nPersonaDataPublicCommendsFriendly |
ping | m_iPing |
move_collide | m_MoveCollide |
move_type | m_MoveType |
team_num | m_iTeamNum |
active_weapon | m_hActiveWeapon |
looking_at_weapon | m_bIsLookingAtWeapon |
holding_look_at_weapon | m_bIsHoldingLookAtWeapon |
next_attack_time | m_flNextAttack |
duck_time_ms | m_nDuckTimeMsecs |
max_speed | m_flMaxspeed |
max_fall_velo | m_flMaxFallVelocity |
duck_amount | m_flDuckAmount |
duck_speed | m_flDuckSpeed |
duck_overrdie | m_bDuckOverride |
old_jump_pressed | m_bOldJumpPressed |
jump_until | m_flJumpUntil |
jump_velo | m_flJumpVel |
fall_velo | m_flFallVelocity |
in_crouch | m_bInCrouch |
crouch_state | m_nCrouchState |
ducked | m_bDucked |
ducking | m_bDucking |
in_duck_jump | m_bInDuckJump |
allow_auto_movement | m_bAllowAutoMovement |
jump_time_ms | m_nJumpTimeMsecs |
last_duck_time | m_flLastDuckTime |
is_rescuing | m_bIsRescuing |
weapon_purchases_this_match | m_iWeaponPurchasesThisMatch |
weapon_purchases_this_round | m_iWeaponPurchasesThisRound |
spotted | m_bSpotted |
approximate_spotted_by | m_bSpottedByMask |
time_last_injury | m_flTimeOfLastInjury |
direction_last_injury | m_nRelativeDirectionOfLastInjury |
player_state | m_iPlayerState |
passive_items | m_passiveItems |
is_scoped | m_bIsScoped |
is_walking | m_bIsWalking |
resume_zoom | m_bResumeZoom |
is_defusing | m_bIsDefusing |
is_grabbing_hostage | m_bIsGrabbingHostage |
blocking_use_in_progess | m_iBlockingUseActionInProgress |
molotov_damage_time | m_fMolotovDamageTime |
moved_since_spawn | m_bHasMovedSinceSpawn |
in_bomb_zone | m_bInBombZone |
in_buy_zone | m_bInBuyZone |
in_no_defuse_area | m_bInNoDefuseArea |
killed_by_taser | m_bKilledByTaser |
move_state | m_iMoveState |
which_bomb_zone | m_nWhichBombZone |
in_hostage_rescue_zone | m_bInHostageRescueZone |
stamina | m_flStamina |
direction | m_iDirection |
shots_fired | m_iShotsFired |
armor_value | m_ArmorValue |
velo_modifier | m_flVelocityModifier |
ground_accel_linear_frac_last_time | m_flGroundAccelLinearFracLastTime |
flash_duration | m_flFlashDuration |
flash_max_alpha | m_flFlashMaxAlpha |
wait_for_no_attack | m_bWaitForNoAttack |
last_place_name | m_szLastPlaceName |
is_strafing | m_bStrafing |
round_start_equip_value | m_unRoundStartEquipmentValue |
current_equip_value | m_unCurrentEquipmentValue |
velocity | - |
velocity_X | - |
velocity_Y | - |
velocity_Z | - |
agent_skin | - |
user_id | - |
entity_id | - |
True/Flase if player is pressing button.
Name | Real name |
---|---|
FORWARD | m_nButtonDownMaskPrev |
LEFT | m_nButtonDownMaskPrev |
RIGHT | m_nButtonDownMaskPrev |
BACK | m_nButtonDownMaskPrev |
FIRE | m_nButtonDownMaskPrev |
RIGHTCLICK | m_nButtonDownMaskPrev |
RELOAD | m_nButtonDownMaskPrev |
INSPECT | m_nButtonDownMaskPrev |
USE | m_nButtonDownMaskPrev |
ZOOM | m_nButtonDownMaskPrev |
SCOREBOARD | m_nButtonDownMaskPrev |
WALK | m_nButtonDownMaskPrev |
button | m_nButtonDownMaskPrev |
(buttons is the real value of m_nButtonDownMaskPrev and the others are derived from it)
Name | Real name |
---|---|
team_rounds_total | m_iScore |
team_surrendered | m_bSurrendered |
team_name | m_szTeamname |
team_score_overtime | m_scoreOvertime |
team_match_stat | m_szTeamMatchStat |
team_num_map_victories | m_numMapVictories |
team_score_first_half | m_scoreFirstHalf |
team_score_second_half | m_scoreSecondHalf |
team_clan_name | m_szClanTeamname |
is_freeze_period | m_bFreezePeriod |
is_warmup_period | m_bWarmupPeriod |
warmup_period_end | m_fWarmupPeriodEnd |
warmup_period_start | m_fWarmupPeriodStart |
is_terrorist_timeout | m_bTerroristTimeOutActive |
is_ct_timeout | m_bCTTimeOutActive |
terrorist_timeout_remaining | m_flTerroristTimeOutRemaining |
ct_timeout_remaining | m_flCTTimeOutRemaining |
num_terrorist_timeouts | m_nTerroristTimeOuts |
num_ct_timeouts | m_nCTTimeOuts |
is_technical_timeout | m_bTechnicalTimeOut |
is_waiting_for_resume | m_bMatchWaitingForResume |
match_start_time | m_fMatchStartTime |
round_start_time | m_fRoundStartTime |
restart_round_time | m_flRestartRoundTime |
is_game_restart | m_bGameRestart |
game_start_time | m_flGameStartTime |
time_until_next_phase_start | m_timeUntilNextPhaseStarts |
game_phase | m_gamePhase |
total_rounds_played | m_totalRoundsPlayed |
rounds_played_this_phase | m_nRoundsPlayedThisPhase |
hostages_remaining | m_iHostagesRemaining |
any_hostages_reached | m_bAnyHostageReached |
has_bombites | m_bMapHasBombTarget |
has_rescue_zone | m_bMapHasRescueZone |
has_buy_zone | m_bMapHasBuyZone |
is_matchmaking | m_bIsQueuedMatchmaking |
match_making_mode | m_nQueuedMatchmakingMode |
is_valve_dedicated_server | m_bIsValveDS |
gungame_prog_weap_ct | m_iNumGunGameProgressiveWeaponsCT |
gungame_prog_weap_t | m_iNumGunGameProgressiveWeaponsT |
spectator_slot_count | m_iSpectatorSlotCount |
is_match_started | m_bHasMatchStarted |
n_best_of_maps | m_numBestOfMaps |
is_bomb_dropped | m_bBombDropped |
is_bomb_planed | m_bBombPlanted |
round_win_status | m_iRoundWinStatus |
round_win_reason | m_eRoundWinReason |
terrorist_cant_buy | m_bTCantBuy |
ct_cant_buy | m_bCTCantBuy |
num_player_alive_ct | m_iMatchStats_PlayersAlive_CT |
num_player_alive_t | m_iMatchStats_PlayersAlive_T |
ct_losing_streak | m_iNumConsecutiveCTLoses |
t_losing_streak | m_iNumConsecutiveTerroristLoses |
survival_start_time | m_flSurvivalStartTime |
round_in_progress | m_bRoundInProgress |
Name | Real name |
---|---|
active_weapon_name | m_iItemDefinitionIndex + lookup |
active_weapon_skin | m_iRawValue32 + lookup |
active_weapon_ammo | m_iClip1 |
active_weapon_original_owner | m_OriginalOwnerXuidLow + m_OriginalOwnerXuidHigh |
total_ammo_left | m_pReserveAmmo |
item_def_idx | m_iItemDefinitionIndex |
weapon_quality | m_iEntityQuality |
entity_lvl | m_iEntityLevel |
item_id_high | m_iItemIDHigh |
item_id_low | m_iItemIDLow |
item_account_id | m_iAccountID |
inventory_position | m_iInventoryPosition |
is_initialized | m_bInitialized |
econ_item_attribute_def_idx | m_iAttributeDefinitionIndex |
initial_value | m_flInitialValue |
refundable_currency | m_nRefundableCurrency |
set_bonus | m_bSetBonus |
custom_name | m_szCustomName |
orig_owner_xuid_low | m_OriginalOwnerXuidLow |
orig_owner_xuid_high | m_OriginalOwnerXuidHigh |
fall_back_paint_kit | m_nFallbackPaintKit |
fall_back_seed | m_nFallbackSeed |
fall_back_wear | m_flFallbackWear |
fall_back_stat_track | m_nFallbackStatTrak |
m_iState | m_iState |
fire_seq_start_time | m_flFireSequenceStartTime |
fire_seq_start_time_change | m_nFireSequenceStartTimeChange |
is_player_fire_event_primary | m_bPlayerFireEventIsPrimary |
weapon_mode | m_weaponMode |
accuracy_penalty | m_fAccuracyPenalty |
i_recoil_idx | m_iRecoilIndex |
fl_recoil_idx | m_flRecoilIndex |
is_burst_mode | m_bBurstMode |
post_pone_fire_ready_time | m_flPostponeFireReadyTime |
is_in_reload | m_bInReload |
reload_visually_complete | m_bReloadVisuallyComplete |
dropped_at_time | m_flDroppedAtTime |
is_hauled_back | m_bIsHauledBack |
is_silencer_on | m_bSilencerOn |
time_silencer_switch_complete | m_flTimeSilencerSwitchComplete |
orig_team_number | m_iOriginalTeamNumber |
prev_owner | m_hPrevOwner |
last_shot_time | m_fLastShotTime |
iron_sight_mode | m_iIronSightMode |
num_empty_attacks | m_iNumEmptyAttacks |
zoom_lvl | m_zoomLevel |
burst_shots_remaining | m_iBurstShotsRemaining |
needs_bolt_action | m_bNeedsBoltAction |
next_primary_attack_tick | m_nNextPrimaryAttackTick |
next_primary_attack_tick_ratio | m_flNextPrimaryAttackTickRatio |
next_secondary_attack_tick | m_nNextSecondaryAttackTick |
next_secondary_attack_tick_ratio | m_flNextSecondaryAttackTickRatio |
Name | Real name |
---|---|
kills_total | m_iKills |
deaths_total | m_iDeaths |
assists_total | m_iAssists |
alive_time_total | m_iLiveTime |
headshot_kills_total | m_iHeadShotKills |
ace_rounds_total | m_iEnemy5Ks |
4k_rounds_total | m_iEnemy4Ks |
3k_rounds_total | m_iEnemy3Ks |
damage_total | m_iDamage |
objective_total | m_iObjective |
utility_damage_total | m_iUtilityDamage |
enemies_flashed_total | m_iEnemiesFlashed |
equipment_value_total | m_iEquipmentValue |
money_saved_total | m_iMoneySaved |
kill_reward_total | m_iKillReward |
cash_earned_total | m_iCashEarned |
Go: https://github.com/markus-wa/demoinfocs-golang
C#: https://github.com/saul/demofile-net
Python: https://github.com/pnxenopoulos/awpy
Java: https://github.com/skadistats/clarity
Without Dotabuff's dota 2 parser "manta" this would not have been possible. Check it out: https://github.com/dotabuff/manta
The dota 2 demo format is very similar to CS2 demo format with only a few minor changes.
Thank you to Clarity for an elegant implementation of sendtables
Thank you to Dandrews for figuring out voice data extraction