shared
GetEntityHealth
FiveM shared native documentation with a Lua example.
Summary
Returns the current health of an entity (ped, vehicle). For peds, 0 is dead and ~200 is full by default.
Returns
number — current health.
Parameters
entitynumberThe entity handle.Example
local ped = PlayerPedId()
local hp = GetEntityHealth(ped)
if hp <= 0 then
-- entity is dead
endCommon pitfalls
- Ped health baseline is often 100-200, not 0-100 — don't assume a 0-100 scale.
- For players, prefer framework health/status systems where available for consistency.
Related natives
Related guides
FiveM scripts done right
Optimized, dual-framework scripts for QBCore and ESX from Viper Development — escrow protected, delivered instantly to your Cfx portal.
Browse Scripts →