This article relates to the game "Dota 2". Click here for more information.
This article relates to the SDK/Workshop Tools for "Dota 2 Workshop Tools". Click here for more information.
This article's documentation is for Source 2. Click here for more information.

Built-In Engine Events

From Valve Developer Community
Jump to: navigation, search
English (en)русский (ru)中文 (zh)
... Icon-Important.png

Check out https://github.com/SteamDatabase/GameTracking-Dota2/blob/master/game/dota/pak01_dir/resource/game.gameevents and https://github.com/SteamDatabase/GameTracking-Dota2/blob/master/game/core/pak01_dir/resource/core.gameevents for an up-to-date list.

Game event format

  • No spaces in event names, max length 32
  • All strings are case sensitive
  • total game event byte length must be < 1024
  • valid data key types are:
  • none : value is not networked
  • string : a zero terminated string
  • bool : unsigned int, 1 bit
  • byte : unsigned int, 8 bit
  • short : signed int, 16 bit
  • long : signed int, 32 bit
  • float : float, 32 bit
  • uint64 : unsigned int 64 bit
  • local : any data, but not networked to clients
  • The following key names are reserved:
  • local : if set to 1, event is not networked to clients
  • unreliable : networked, but unreliable
  • suppress : never fire this event
  • time : firing server time
  • eventid : holds the event ID


Core team events

  • team_info: info about team
  • teamid ( byte ): unique team id
  • teamname ( string ): team name (e.g. Team Blue)
  • team_score: team score changed
  • teamid ( byte ): team id
  • score ( short ): total team score
  • teamplay_broadcast_audio: emits a sound to everyone on a team
  • team ( byte ): unique team id
  • sound ( string ): name of the sound to emit

Player events

  • 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
  • autoteam( bool ): true if the player was auto assigned to the team
  • silent( bool ): if true wont print the team join messages
  • player_class: a player changed his class
  • userid ( short ): user ID on server
  • class ( string ): new player class / model
  • player_death [broken]: a game event, name may be 32 characters long
  • userid ( short ): user ID who died
  • attacker ( short ): user ID who killed
  • player_hurt [broken]
  • userid ( short ): player index who was hurt
  • attacker ( short ): player index who attacked
  • health ( byte ): remaining health points
  • player_chat: a public player chat
  • teamonly ( bool ): true if team only chat
  • userid( short ): chatting player
  • text( string ): chat text
  • player_score: players scores changed
  • userid ( short ): user ID on server
  • kills ( short ): # of kills
  • deaths ( short ): # of deaths
  • score ( short ): total game score
  • player_spawn: player spawned in game
  • userid ( short ): user ID on server
  • player_shoot: player shoot his weapon
  • userid ( short ): user ID on server
  • weapon ( byte ): weapon ID
  • mode ( byte ): weapon mode
  • player_use
  • userid ( short ): user ID on server
  • entity ( short ): entity used by player
  • player_changename
  • userid ( short ): user ID on server
  • oldname ( string ): players old (current) name
  • newname ( string ): players new name
  • player_hintmessage
  • hintmessage ( string ): localizable string of a hint
  • player_reconnected : the player reconnet to the game
  • event(local):the data include the realitive infomation

Game events

  • game_init: sent when a new game is started
  • game_newmap: send when new map is completely loaded
  • mapname ( string ): map name
  • game_start: a new game starts
  • roundslimit ( long ): max round
  • timelimit ( long ): time limit
  • fraglimit ( long ): frag limit
  • objective ( string ): round objective
  • game_end: a game ended
  • winner ( byte ): winner team/user id
  • round_start
  • timelimit ( long ): round time limit in seconds
  • fraglimit ( long ): frag limit in seconds
  • objective ( string ): round objective
  • round_end
  • winner ( byte ): winner team/user i
  • reason ( byte ): reason team won
  • message ( string ): end round message
  • round_start_pre_entity
  • teamplay_round_start: round restart
  • full_reset ( bool ): is this a full reset of the map
  • hostname_changed
  • hostname ( string )
  • difficulty_changed
  • newDifficulty ( short )
  • oldDifficulty ( short )
  • strDifficulty( string ): new difficulty as string
  • finale_start
  • rushes ( short )
  • game_message: a message send by game logic to everyone
  • target ( byte ): 0 = console, 1 = HUD
  • text ( string ): the message text
  • break_breakable
  • entindex ( long )
  • userid ( short )
  • material ( byte ): BREAK_GLASS, BREAK_WOOD, etc
  • break_prop
  • entindex ( long )
  • userid ( short )
  • npc_spawned
  • entindex ( long )
  • npc_replaced
  • old_entindex ( long )
  • new_entindex ( long )
  • entity_killed
  • entindex_killed( long )
  • entindex_attacker ( long )
  • entindex_inflictor ( long )
  • damagebits ( long )
  • entity_hurt
  • entindex_killed( long )
  • entindex_attacker ( long )
  • entindex_inflictor ( long )
  • damagebits ( long )
  • bonus_updated
  • numadvanced ( short )
  • numbronze ( short )
  • numsilver ( short )
  • numgold ( short )
  • player_stats_updated
  • forceupload ( bool )
  • achievement_event
  • achievement_name ( string ): non-localized name of achievement
  • cur_val ( short ): # of steps toward achievement
  • max_val ( short ): total # of steps in achievement
  • achievement_earned
  • player ( byte ): entindex of the player
  • achievement ( short ): achievement ID

): Used for a notification message when an achievement fails to write

  • achievement_write_failed
  • physgun_pickup
  • entindex ( long ): entity picked up
  • flare_ignite_npc
  • entindex ( long ): entity ignited
  • helicopter_grenade_punt_miss
  • user_data_downloaded: fired when achievements/stats are downloaded from Steam or XBox Live
  • ragdoll_dissolved
  • entindex ( long )
  • gameinstructor_draw
  • gameinstructor_nodraw
  • map_transition
  • instructor_server_hint_create :create a hint using data supplied entirely by the server/map.
  • hint_name ( string ): what to name the hint. For referencing it again later (e.g. a kill command for the hint instead of a timeout)
  • hint_replace_key ( string ): type name so that messages of the same type will replace each other
  • hint_target ( long ): entity id that the hint should display at
  • hint_activator_userid ( short ): userid id of the activator
  • hint_timeout ( short ): how long in seconds until the hint automatically times out, 0 = never
  • hint_icon_onscreen ( string ): the hint icon to use when the hint is onscreen. (e.g. icon_alert_red)
  • hint_icon_offscreen ( string ): the hint icon to use when the hint is offscreen. (e.g. icon_alert)
  • hint_caption ( string ): the hint caption. (e.g. #ThisIsDangerous)
  • hint_activator_caption ( string ): the hint caption that only the activator sees (e.g. #YouPushedItGood)
  • hint_color ( string ): the hint color in (r,g,b( format where each component is 0-255))
  • hint_icon_offset ( float ): how far on the z axis to offset the hint from entity origin
  • hint_range ( float ): range before the hint is culled
  • hint_flags ( long ): hint flags
  • hint_binding ( string ): bindings to use when use_binding is the onscreen icon
  • hint_allow_nodraw_target ( bool ): if false, the hint will disappear if the target entity is invisible
  • hint_nooffscreen ( bool ): if true, the hint will not show when outside the player view
  • hint_forcecaption ( bool ): if true, the hint caption will show even if the hint is occluded
  • hint_local_player_only ( bool ): if true, only the local player will see the hint
  • instructor_server_hint_stop :destroys a server/map created hint
  • hint_name ( string ): The hint to stop. Will stop ALL hints with this name
  • chat_new_message: the specified channel contains new messages
  • channel ( byte )
  • chat_members_changed: the specified channel has had players leave or join
  • channel ( byte )
  • game_rules_state_change: the state of game changes

Economy events

  • inventory_updated
  • itemdef ( short )
  • cart_updated
  • store_pricesheet_updated
  • gc_connected
  • item_schema_initialized
  • drop_rate_modified
  • event_ticket_modified

ModEvents

  • modifier_event
  • eventname ( string )
  • caster ( short )
  • ability ( short )
  • dota_player_kill
  • victim_userid ( short )
  • killer1_userid ( short )
  • killer2_userid ( short )
  • killer3_userid ( short )
  • killer4_userid ( short )
  • killer5_userid ( short )
  • bounty ( short )
  • neutral ( short )
  • greevil ( short )
  • dota_player_deny
  • killer_userid ( short )
  • victim_userid ( short )
  • dota_barracks_kill
  • barracks_id ( short )
  • dota_tower_kill
  • killer_userid ( short )
  • teamnumber ( short )
  • gold ( short )
  • dota_roshan_kill
  • teamnumber ( short )
  • gold ( short )
  • dota_courier_lost
  • teamnumber ( short )
  • dota_courier_respawned
  • teamnumber ( short )
  • dota_glyph_used
  • teamnumber ( short )
  • dota_super_creeps
  • teamnumber ( short )
  • dota_item_purchased( edit: not dota_item_purchase )
  • userid ( short )
  • itemid ( short )
  • dota_item_gifted
  • userid ( short )
  • itemid ( short )
  • sourceid ( short )
  • dota_rune_pickup
  • userid ( short )
  • type ( short )
  • rune ( short )
  • dota_rune_spotted
  • userid ( short )
  • rune ( short )
  • dota_item_spotted
  • userid ( short )
  • itemid ( short )
  • dota_no_battle_points
  • userid ( short )
  • reason ( short )
  • dota_chat_informational
  • userid ( short )
  • type ( short )
  • dota_action_item
  • reason ( short )
  • itemdef ( short )
  • message ( short )
  • dota_chat_ban_notification
  • userid( short )
  • dota_chat_event
  • userid ( short )
  • gold ( short )
  • message ( short )
  • dota_chat_timed_reward
  • userid ( short )
  • itmedef ( short )
  • message ( short )
  • dota_pause_event
  • userid ( short )
  • value ( short )
  • message ( short )
  • dota_chat_kill_streak
  • gold ( short )
  • killer_id ( short )
  • killer_streak ( short )
  • killer_multikill ( short )
  • victim_id ( short )
  • victim_streak ( short )
  • dota_chat_first_blood
  • gold ( short )
  • killer_id ( short )
  • victim_id ( short )
  • dota_player_update_hero_selection
  • tabcycle ( bool )
  • dota_player_update_selected_unit
  • dota_player_update_query_unit
  • dota_player_update_killcam_unit
  • dota_player_take_tower_damage
  • PlayerID ( short )
  • damage ( short )
  • dota_hud_error_message
  • reason ( byte )
  • message ( string )
  • dota_action_success
  • dota_starting_position_changed
  • dota_money_changed
  • dota_enemy_money_changed
  • dota_portrait_unit_stats_changed
  • dota_portrait_unit_modifiers_changed
  • dota_force_portrait_update
  • dota_inventory_changed
  • dota_item_picked_up
  • itemname ( string )
  • PlayerID ( short )
  • ItemEntityIndex( short )
  • HeroEntityIndex( short )
  • dota_inventory_item_changed
  • entityIndex ( short )
  • dota_ability_changed
  • dota_portrait_ability_layout_changed
  • dota_inventory_item_added
  • itemname ( string )
  • dota_inventory_changed_query_unit
  • dota_link_clicked
  • link ( string )
  • nav ( bool ): internal to item panel - preserve the nav stack
  • nav_back ( bool ): internal to item panel - preserve the nav stack
  • recipe ( short )
  • shop ( short ): show the item in a particular shop
  • dota_set_quick_buy
  • item ( string )
  • recipe ( byte )
  • toggle ( bool )
  • dota_quick_buy_changed
  • item ( string )
  • recipe ( byte )
  • dota_player_shop_changed
  • prevshopmask ( byte )
  • shopmask ( byte )
  • dota_player_show_killcam
  • nodes ( byte )
  • player ( short )
  • dota_player_show_minikillcam
  • nodes ( byte )
  • player ( short )
  • gc_user_session_created
  • team_data_updated
  • guild_data_updated
  • guild_open_parties_updated
  • fantasy_updated
  • fantasy_league_changed
  • fantasy_score_info_changed
  • player_info_updated
  • game_rules_state_change
  • match_history_updated
  • SteamID ( uint64 )
  • match_details_updated
  • matchID ( uint64 )
  • result ( byte )
  • live_games_updated
  • recent_matches_updated
  • Page ( short )
  • news_updated
  • persona_updated
  • SteamID ( uint64 )
  • tournament_state_updated
  • party_updated
  • lobby_updated
  • dashboard_caches_cleared
  • last_hit
  • PlayerID ( short )
  • EntKilled ( short )
  • FirstBlood ( bool )
  • HeroKill ( bool )
  • TowerKill ( bool )
  • player_completed_game
  • PlayerID ( short )
  • Winner ( byte )
  • player_reconnected
  • PlayerID ( short )
  • nommed_tree
  • PlayerID ( short )
  • dota_rune_activated_server
  • PlayerID ( short )
  • rune ( short )
  • dota_player_gained_level
  • player ( short )
  • level ( short )
  • dota_player_pick_hero
  • player ( short )
  • heroindex ( short )
  • hero ( string )
  • dota_player_learned_ability
  • player ( short )
  • abilityname ( string )
  • dota_player_used_ability
  • PlayerID ( short )
  • abilityname ( string )
  • dota_non_player_used_ability
  • abilityname ( string )
  • dota_ability_channel_finished
  • abilityname ( string )
  • interrupted ( bool )
  • dota_holdout_revive_complete
  • caster( short )
  • target( short )
  • dota_player_killed
  • PlayerID ( short )
  • HeroKill ( bool )
  • TowerKill ( bool )
  • bindpanel_open
  • bindpanel_close
  • keybind_changed
  • dota_item_drag_begin
  • dota_item_drag_end
  • dota_shop_item_drag_begin
  • dota_shop_item_drag_end
  • dota_item_purchased
  • PlayerID ( short )
  • itemname ( string )
  • itemcost ( short )
  • dota_item_used
  • PlayerID ( short )
  • itemname ( string )
  • dota_item_auto_purchase
  • item_id ( short )
  • dota_unit_event
  • victim ( short )
  • attacker ( short )
  • basepriority ( short )
  • priority ( short )
  • eventtype ( short ): EDOTAHeroChaseEventType
  • dota_quest_started
  • questIndex ( long ): entity index
  • dota_quest_completed
  • questIndex ( long ): entity index
  • gameui_activated
  • gameui_hidden
  • player_fullyjoined
  • userid ( short ): user ID on server
  • name ( string ): player name
  • dota_spectate_hero
  • entindex ( byte )
  • dota_match_done
  • winningteam ( byte ): The ID of the winning team
  • dota_match_done_client
  • set_instructor_group_enabled
  • group ( string )
  • enabled ( short )
  • joined_chat_channel
  • channelName ( string )
  • left_chat_channel
  • channelName ( string )
  • gc_chat_channel_list_updated
  • today_messages_updated
  • num_messages ( short )
  • file_downloaded
  • success ( bool )
  • local_filename ( string )
  • remote_url ( string )
  • player_report_counts_updated
  • positive_remaining ( byte )
  • negative_remaining ( byte )
  • positive_total ( short )
  • negative_total ( short )
  • scaleform_file_download_complete
  • success ( bool )
  • local_filename ( string )
  • remote_url ( string )
  • item_purchased
  • itemid ( short )
  • gc_mismatched_version
  • demo_skip
  • local (1)
  • playback_tick ( long ): current playback tick
  • skipto_tick ( long ): tick we're going to
  • user_message_list ( local ): CSVCMsgList_UserMessages
  • dota_hero_chase_list ( local ): CSVCMsgList_GameEvents
  • demo_start
  • local (1)
  • dota_combatlog_list ( local ): CSVCMsgList_GameEvents that are combat log events
  • dota_hero_chase_list ( local ): CSVCMsgList_GameEvents
  • dota_pick_hero_list ( local ): CSVCMsgList_GameEvents
  • demo_stop


  • map_shutdown
  • dota_workshop_fileselected
  • filename ( string )
  • dota_workshop_filecanceled
  • rich_presence_updated
  • dota_hero_random
  • userid ( short )
  • heroid ( short )
  • dota_rd_chat_turn
  • userid ( short )
  • dota_favorite_heroes_updated
  • profile_closed
  • item_preview_closed
  • dashboard_switched_section
  • section ( short )
  • dota_tournament_item_event
  • winner_count ( short )
  • event_type ( short )
  • dota_hero_swap
  • playerid1 ( byte )
  • playerid2 ( byte )
  • dota_reset_suggested_items : reset the purchased / checked off state of suggested items in the store
  • halloween_high_score_received
  • round ( short )
  • halloween_phase_end
  • phase ( byte )
  • team ( byte )
  • halloween_high_score_request_failed
  • round ( short )
  • dota_hud_skin_changed
  • skin ( string )
  • style ( byte )
  • dota_inventory_player_got_item
  • itemname ( string )
  • player_is_experienced
  • player_is_notexperienced
  • dota_tutorial_lesson_start
  • map_location_updated
  • richpresence_custom_updated
  • game_end_visible
  • antiaddiction_update
  • highlight_hud_element
  • elementname ( string )
  • duration ( float )
  • hide_highlight_hud_element
  • intro_video_finished
  • matchmaking_status_visibility_changed
  • practice_lobby_visibility_changed
  • dota_courier_transfer_item
  • full_ui_unlocked
  • client_connectionless_packet
  • local (1
  • buffer( (local
  • buffersize( long )
  • address( string )
  • hero_selector_preview_set
  • setindex( short )
  • antiaddiction_toast
  • message ( string )
  • duration ( float )
  • hero_picker_shown
  • hero_picker_hidden
  • dota_local_quickbuy_changed
  • show_center_message
  • message ( string )
  • duration ( float )
  • clear_message_queue ( bool )
  • hud_flip_changed
  • flipped ( bool )
  • frosty_points_updated
  • defeated
  • entindex ( short )
  • reset_defeated
  • booster_state_updated
  • event_points_updated
  • event_id ( short )
  • points ( short )
  • premium_points ( short )
  • local_player_event_points
  • points ( short )
  • conversion_rate ( short )
  • custom_game_difficulty
  • difficulty ( byte )
  • tree_cut
  • tree_x ( float )
  • tree_y ( float )
  • ugc_details_arrived
  • published_file_id ( uint64 )
  • ugc_subscribed
  • published_file_id ( uint64 )
  • ugc_unsubscribed
  • published_file_id ( uint64 )
  • prizepool_received
  • success ( bool )
  • prizepool ( uint64 )
  • leagueid ( uint64 )
  • microtransaction_success
  • txnid ( uint64 )
  • dota_rubick_ability_steal
  • abilityIndex ( short )
  • abilityLevel ( byte )
  • compendium_event_actions_loaded
  • account_id ( uint64 )
  • league_id ( uint64 )
  • local_test( bool )
  • original_points ( uint64 )
  • compendium_selections_loaded
  • account_id ( uint64 )
  • league_id ( uint64 )
  • local_test( bool )
  • compendium_set_selection_failed
  • account_id ( uint64 )
  • league_id ( uint64 )
  • local_test( bool )
  • community_cached_names_updated