Lua SDKAPI reference
entity
Entity table#
Returned by game.local_player(), the game.enemies() / game.teammates() /
game.all_entities() lists, and enemy / teammate inside ult-threat entries.
Tables are rebuilt every tick - never hold a table across ticks for identity;
hold e.id and look the entity up again (or use util.sticky_enemy, which does this).
| Field | Type | Description |
|---|---|---|
id | number | Stable per-body uid - use for cross-tick tracking (entity tables are rebuilt every tick). |
hero | string | Hero name ('Unknown' when unidentified). |
hero_id | number | Hero id (hex in the offsets DB). |
health | number | Current base HP. |
max_health | number | Max base HP. |
armor | number | Armor (damage-reducing pool). |
shields | number | Shields (regenerating pool). |
overhealth | number | Temporary overhealth. |
distance | number | Distance from the camera in meters (0 = unknown). |
is_visible | boolean | Line-of-sight flag (with hide hysteresis; Moira fade / Venture burrow report hidden). |
is_alive | boolean | Alive flag. |
is_enemy | boolean | Hostility per GameContext (everyone is an enemy in FFA/custom). |
team | number | Team id. |
ult_charge | number | Ultimate charge 0-100. |
is_ulting | boolean | True while firing the ult (AbilityTracker fire event). |
skill1_cd | number | Shift cooldown remaining (0 = ready). |
skill2_cd | number | E cooldown remaining (0 = ready). |
is_scoped | boolean | Scoped state (local player only). |
position | {x,y,z} | Feet world position. |
head_position | {x,y,z} | Head world position. |
{x,y,z} fields are plain tables with numeric x, y, z keys.
Last updated 2026-10-03