# setVehicleDirtLevel (Compartilhado)

> Muda quanta sujeira aparece na pintura de um veículo.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Função Lua
- **Lado**: Compartilhado
- **Categoria**: Visual dos veículos
- **URL**: https://wiki.mymp.gg/pt/setVehicleDirtLevel

## Sintaxe

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

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `element` | `element` | Um veículo, ou um elemento pai: todos os veículos abaixo dele também mudam. |
| `level` | `float` | De 0 (limpo) a 1 (o mais sujo). |

## Retorno

`true` se mudou, `false` se não é um veículo. Dá erro se `level` sai de 0 a 1.

No servidor, a mudança é enviada a todos os clientes. No cliente, vale só para este cliente.

## Exemplo

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

### Atenção

Com um elemento pai (como `root`), todos os veículos abaixo mudam, mas o retorno é o do próprio elemento, que não é um veículo: `false`.

## Veja também

- [getVehicleDirtLevel (Compartilhado)](https://wiki.mymp.gg/pt/getVehicleDirtLevel.md): Diz quanta sujeira aparece na pintura de um veículo.
- [setVehicleDirtColor (Compartilhado)](https://wiki.mymp.gg/pt/setVehicleDirtColor.md): Muda a cor da sujeira na pintura de um veículo, como lama ou areia.
- [setVehicleWetnessLevel (Compartilhado)](https://wiki.mymp.gg/pt/setVehicleWetnessLevel.md): Fixa quão molhado um veículo aparece, em vez de seguir a chuva.