GetPlayerHealth
getPlayerHealth
Returns a player's authoritative current health value.
Syntax
number|false getPlayerHealth(int playerId)
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
playerId |
int |
yes | The connected player identifier. |
Returns
Returns the current numeric value, or false if the player is invalid or the value has not been initialized.
Examples
Read a player's current health:
local value = getPlayerHealth(playerId)
if value ~= false then
outputDebugString("health: " .. tostring(value))
end
Notes
- Available only in server-side resource scripts.
- This is a convenience wrapper around
getPlayerStat(playerId, "health").