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

SetEntityHealthPlayerPedId

Related guides

Managing jobs on your server?

Viper Multi-Job lets players hold several jobs and switch between them with grade, salary and duty handled — QBCore, QBox and ESX, validated server-side.

See Viper Multi-Job →