# setVehicleFullBeam (Compartilhado)

> Liga ou desliga o farol alto de um veículo.

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

## Sintaxe

```lua
bool setVehicleFullBeam(element vehicle, bool fullBeam)
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `vehicle` | `element` | O veículo, ou um elemento pai cujos veículos mudam todos. |
| `fullBeam` | `bool` | `true` para farol alto, `false` para baixo. |

## Retorno

`true` se mudou, `false` se já estava assim ou o elemento não é um veículo.

Dado um elemento pai, como `root`, vale para todos os veículos abaixo dele, mas o valor devolvido é o do próprio elemento: `false` quando ele não é um veículo.

## Exemplo

```lua
addCommandHandler("farolalto", function(player)
    local vehicle = getPedOccupiedVehicle(player)
    if vehicle then
        setVehicleFullBeam(vehicle, not isVehicleFullBeam(vehicle))
    end
end)
```

### Vindo do MTA

O MTA não tem esta função.

## Veja também

- [isVehicleFullBeam (Compartilhado)](https://wiki.mymp.gg/pt/isVehicleFullBeam.md): Devolve se o farol alto de um veículo está ligado.
- [setVehicleOverrideLights (Compartilhado)](https://wiki.mymp.gg/pt/setVehicleOverrideLights.md): Força os faróis de um veículo a ficarem ligados ou desligados, ou devolve a decisão ao jogo.