# setVehicleDirtLevel (Shared)

> Changes how much dirt shows on a vehicle's paint.

- **Platform**: MY Multiplayer (MYMP)
- **Kind**: Lua Function
- **Side**: Shared
- **Category**: Vehicle looks
- **URL**: https://wiki.mymp.gg/en/setVehicleDirtLevel

## Syntax

```lua
bool setVehicleDirtLevel(element element, float level)
```

## Parameters

| Name | Type | Description |
| --- | --- | --- |
| `element` | `element` | A vehicle, or a parent element: every vehicle below it changes too. |
| `level` | `float` | From 0 (clean) to 1 (the dirtiest). |

## Returns

`true` if it changed, `false` if it is not a vehicle. Raises an error if `level` is outside 0 to 1.

On the server, the change is sent to every client. On the client, it applies to this client only.

## Example

```lua
addCommandHandler("lavar", function(player)
    local vehicle = getPedOccupiedVehicle(player)
    if vehicle then
        setVehicleDirtLevel(vehicle, 0)
    end
end)
```

### Note

With a parent element (such as `root`), every vehicle below changes, but the return value is the element's own, which is not a vehicle: `false`.

## See also

- [getVehicleDirtLevel (Shared)](https://wiki.mymp.gg/en/getVehicleDirtLevel.md): Tells how much dirt shows on a vehicle's paint.
- [setVehicleDirtColor (Shared)](https://wiki.mymp.gg/en/setVehicleDirtColor.md): Changes the colour of the dirt on a vehicle's paint, such as mud or sand.
- [setVehicleWetnessLevel (Shared)](https://wiki.mymp.gg/en/setVehicleWetnessLevel.md): Fixes how wet a vehicle looks, instead of following the rain.