ScriptsAboutBlogToolsKnowledge BaseReviewsFAQBasketDocsSupport
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
end

Common 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 →