VehicleClient

getVehicleHealthPercentage

GET_VEHICLE_HEALTH_PERCENTAGE0xB8EF61207C2393A9

The GTA V native GET_VEHICLE_HEALTH_PERCENTAGE of the VEHICLE namespace, as LS:MP client scripts call it: the global function getVehicleHealthPercentage, in JavaScript and in Lua.

SignatureJavaScript
getVehicleHealthPercentage(
  vehicle: Vehicle,
  maxEngineHealth: number,
  maxPetrolTankHealth: number,
  maxBodyHealth: number,
  maxMainRotorHealth: number,
  maxTailRotorHealth: number,
  maxUnkHealth: number
): number
SignatureLua
getVehicleHealthPercentage(
  vehicle: Vehicle,
  maxEngineHealth: number,
  maxPetrolTankHealth: number,
  maxBodyHealth: number,
  maxMainRotorHealth: number,
  maxTailRotorHealth: number,
  maxUnkHealth: number
): number

Usage

JavaScript
const value = getVehicleHealthPercentage(
  vehicle, maxEngineHealth, maxPetrolTankHealth, maxBodyHealth, maxMainRotorHealth,
  maxTailRotorHealth, maxUnkHealth
);
Lua
local value = getVehicleHealthPercentage(
    vehicle, maxEngineHealth, maxPetrolTankHealth, maxBodyHealth, maxMainRotorHealth,
    maxTailRotorHealth, maxUnkHealth
)

Parameters

ParameterTypeJavaScriptLua
vehicleVehiclenumberinteger
maxEngineHealthfloatnumbernumber
maxPetrolTankHealthfloatnumbernumber
maxBodyHealthfloatnumbernumber
maxMainRotorHealthfloatnumbernumber
maxTailRotorHealthfloatnumbernumber
maxUnkHealthfloatnumbernumber

Returns

float JavaScript number, Lua number

Notes

From the community native database. Names are LS:MP’s; samples may be written for C++ or another framework.

0 min 100 max
starts at 100
Seams to have health zones
Front of vehicle when damaged goes from 100-50 and stops at 50.
Rear can be damaged from 100-0
Only tested with two cars.

--
May return the vehicle health on a scale of 0.0 - 100.0 (needs to be confirmed)

example:

v_F = getEntityModel(v_3);
if (((v_F == ${tanker}) || (v_F == ${armytanker})) || (v_F == ${tanker2})) {
    if (getVehicleHealthPercentage(v_3) <= 1.0) {
        networkExplodeVehicle(v_3, 1, 1, -1);
    }
}

Reference

Namespace
Vehicle VEHICLE
In the game
float GET_VEHICLE_HEALTH_PERCENTAGE(Vehicle vehicle, float maxEngineHealth, float maxPetrolTankHealth, float maxBodyHealth, float maxMainRotorHealth, float maxTailRotorHealth, float maxUnkHealth)
Hash
0xB8EF61207C2393A9
Formerly
_GET_VEHICLE_BODY_HEALTH_2

Open in the interactive natives reference