Models

Output dataclasses produced by gem.parse().

See also: Full Match Data, Quickstart

Notable recent fields

• ParsedMatch.radiant_team_id / dire_team_id: int — tournament team ID (matches OpenDota /teams/{id} URL). 0 for pub games.
• ParsedMatch.radiant_team_name / dire_team_name: str — team name (e.g. "Xtreme Gaming"). Empty string for pub games.
• ParsedMatch.radiant_team_tag / dire_team_tag: str — team tag (e.g. "XG"). Empty string for pub games.
• ParsedPlayer.steam_id: int — 64-bit Steam ID. 0 if unavailable.
• ParsedPlayer.account_id: int — 32-bit account ID (the ID in OpenDota/Dotabuff player URLs). 0 if unavailable.
• ParsedMatch.vision_modifiers: list[VisionModifierEvent] (experimental) — every application of a vision-granting modifier (Slardar Corrosive Haze, BH Track, Dust of Appearance, Gem of True Sight). See estimate_vision for how these integrate with the vision API.
• ParsedMatch.tormentors: list[TormentorKill] — chronological Tormentor kill events.
• ParsedMatch.shrines: list[ShrineKill] — chronological Shrine of Wisdom destruction events.
• ParsedPlayer.damage_by_type: dict[str, int] — total damage dealt by damage type (physical, magical, pure).
• ParsedPlayer.damage_taken_by_type: dict[str, int] — total damage taken by damage type.
• ParsedPlayer.buyback_log: list[CombatLogEntry] — buyback events attributed to the player.
• ParsedPlayer.lane_efficiency_pct: int — lane efficiency percentage derived from lane gold.

TormentorKill

• tick: game tick of the kill.
• killer: NPC name of the killing unit.
• killer_player_id: player slot (0-9) of the killer when resolved, else -1.
• kill_number: sequential Tormentor kill number in the match.

---

Generated API

Module gem.models

Output data models for gem replay parsing.

Source: src/gem/models.py

Top-level classes

VisionModifierEvent

class VisionModifierEvent

A vision-granting modifier applied to a hero (Slardar ulti, BH Track, Dust, Gem, etc.).

Source: src/gem/models.py:30

Dataclass fields

Name	Type	Default
tick	int	-
end_tick	`int	None`
modifier_name	str	-
target_name	str	-
caster_name	str	-
caster_team	int	-

SmokeEvent

class SmokeEvent

One Smoke of Deceit activation.

Source: src/gem/models.py:56

Dataclass fields

Name	Type	Default
tick	int	-
activator	str	-
team	int	-
smoked	list[str]	field(...)
x	`float	None`
y	`float	None`

ChatEntry

class ChatEntry

A single chat message from the match.

Source: src/gem/models.py:79

Dataclass fields

Name	Type	Default
tick	int	-
player_slot	int	-
channel	str	-
text	str	-

ParsedPlayer

class ParsedPlayer

Aggregated statistics for one player over a full match.

Source: src/gem/models.py:101

Dataclass fields

Name	Type	Default
player_id	int	-
hero_name	str	''
player_name	str	''
steam_id	int	0
account_id	int	0
team	int	0
times	list[int]	field(...)
gold_t	list[int]	field(...)
total_earned_gold_t	list[int]	field(...)
net_worth_t	list[int]	field(...)
lh_t	list[int]	field(...)
dn_t	list[int]	field(...)
xp_t	list[int]	field(...)
times_min	list[int]	field(...)
gold_t_min	list[int]	field(...)
total_earned_gold_t_min	list[int]	field(...)
total_earned_xp_t_min	list[int]	field(...)
net_worth_t_min	list[int]	field(...)
lh_t_min	list[int]	field(...)
dn_t_min	list[int]	field(...)
xp_t_min	list[int]	field(...)
total_hero_damage_t_min	list[int]	field(...)
total_hero_healing_t_min	list[int]	field(...)
total_deaths_t_min	list[int]	field(...)
total_stuns_t_min	list[float]	field(...)
obs_log	list[WardEvent]	field(...)
sen_log	list[WardEvent]	field(...)
damage	dict[str, int]	field(...)
damage_taken	dict[str, int]	field(...)
damage_by_type	dict[str, int]	field(...)
damage_taken_by_type	dict[str, int]	field(...)
healing	dict[str, int]	field(...)
ability_uses	dict[str, int]	field(...)
item_uses	dict[str, int]	field(...)
gold_reasons	dict[str, int]	field(...)
xp_reasons	dict[str, int]	field(...)
kills_log	list[CombatLogEntry]	field(...)
purchase_log	list[CombatLogEntry]	field(...)
runes_log	list[CombatLogEntry]	field(...)
buyback_log	list[CombatLogEntry]	field(...)
lane_pos	defaultdict[str, int]	field(...)
position_log	list[tuple[int, float, float]]	field(...)
stuns_dealt	float	0.0
kills	int	0
deaths	int	0
assists	int	0
lane_role	int	0
lane_last_hits	int	0
lane_denies	int	0
lane_total_gold	int	0
lane_total_xp	int	0
lane_efficiency_pct	int	0
lane_gold_adv	`int	None`
lane_xp_adv	`int	None`

ParsedMatch

class ParsedMatch

Top-level parsed output for a single Dota 2 replay.

Source: src/gem/models.py:253

Dataclass fields

Name	Type	Default
match_id	int	0
game_mode	int	0
leagueid	int	0
radiant_win	`bool	None`
radiant_team_id	int	0
radiant_team_name	str	''
radiant_team_tag	str	''
dire_team_id	int	0
dire_team_name	str	''
dire_team_tag	str	''
game_start_tick	`int	None`
game_end_tick	int	0
players	list[ParsedPlayer]	field(...)
towers	list[TowerKill]	field(...)
barracks	list[BarracksKill]	field(...)
roshans	list[RoshanKill]	field(...)
aegis_events	list[AegisEvent]	field(...)
tormentors	list[TormentorKill]	field(...)
shrines	list[ShrineKill]	field(...)
wards	list[WardEvent]	field(...)
radiant_gold_adv	list[int]	field(...)
radiant_xp_adv	list[int]	field(...)
combat_log	list[CombatLogEntry]	field(...)
chat	list[ChatEntry]	field(...)
courier_snapshots	list[CourierSnapshot]	field(...)
smoke_events	list[SmokeEvent]	field(...)
draft	list[DraftEvent]	field(...)
teamfights	list[Teamfight]	field(...)
vision_modifiers	list[VisionModifierEvent]	field(...)

Properties

duration_seconds

Signature: def ParsedMatch.duration_seconds(self) -> float

Game duration in seconds, derived from game_start_tick and game_end_tick.

Source: src/gem/models.py:326

duration_minutes

Signature: def ParsedMatch.duration_minutes(self) -> float

Game duration in minutes, derived from game_start_tick and game_end_tick.

Source: src/gem/models.py:332