# VEHICLE::SET_VEHICLE_ENGINE_HEALTH

- **Hash:** `0x8BDC5B998B4654EF`
- **Namespace:** VEHICLE
- **Runtime name (Lua/JS):** `SetVehicleEngineHealth`
- **Side:** client (game native)
- **Name status:** official
- **Documentation:** described
- **Since game build:** 1207
- **URL:** https://natives.borderlinerp.com/natives/VEHICLE/SET_VEHICLE_ENGINE_HEALTH

## Signature

```c
void SET_VEHICLE_ENGINE_HEALTH(Vehicle vehicle, float health);
```

## Parameters

- `vehicle` (`Vehicle`)
- `health` (`float`)

## Returns

`void`

## Description

1000 is max health
Begins leaking gas at around 650 health
-999.90002441406 appears to be minimum health, although nothing special occurs <- false statement

-------------------------
Minimum: -4000
Maximum: 1000

-4000: Engine is destroyed
0 and below: Engine catches fire and health rapidly declines
300: Engine is smoking and losing functionality
1000: Engine is perfect

## Usage

### Lua

```lua
SetVehicleEngineHealth(vehicle, health)

-- always available, by hash
Citizen.InvokeNative(0x8BDC5B998B4654EF, vehicle, health)
```

### JavaScript

```js
SetVehicleEngineHealth(vehicle, health);

// by hash
Citizen.invokeNative('0x8BDC5B998B4654EF', vehicle, health + 0.0000001);
```

### C#

```csharp
Function.Call((Hash)0x8BDC5B998B4654EF, vehicle, health);
```

- Float parameters: Lua integers (`10`, or whole numbers decoded from NUI/JSON) are sent as ints and read as garbage. Write `10.0` or `value + 0.0`. The generated JS wrappers add `0.0000001` to non-zero floats for the same reason.

## See also

- [VEHICLE::GET_VEHICLE_ENGINE_HEALTH](https://natives.borderlinerp.com/natives/VEHICLE/GET_VEHICLE_ENGINE_HEALTH.md) — Returns 1000.0 if the function is unable to get the address of the specified vehicle or if it's not a vehicle.

*Sources: alloc8or RDR3 NativeDB.*