# addVehicleUpgrade (Compartilhado)

> Instala um upgrade de tuning em um veículo, trocando o que estiver no mesmo slot.

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

## Sintaxe

```lua
bool addVehicleUpgrade(element vehicle, string upgrade)
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `vehicle` | `element` | O veículo, ou um elemento pai cujos veículos recebem todos o upgrade. |
| `upgrade` | `string` | O nome do modelo do upgrade (sem diferenciar maiúsculas), ou `"all"` para instalar um upgrade compatível em cada slot. |

## Retorno

`true` se foi instalado. `false` se o upgrade não serve para o modelo do veículo 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("tunar", function(player)
    local vehicle = getPedOccupiedVehicle(player)
    if vehicle then
        addVehicleUpgrade(vehicle, "all")
    end
end)
```

### Vindo do MTA

O MTA usa os ids numéricos dos upgrades (1000 a 1193). Aqui um upgrade é o nome do seu modelo, e os slots são os que os pacotes montados declaram.

## Veja também

- [removeVehicleUpgrade (Compartilhado)](https://wiki.mymp.gg/pt/removeVehicleUpgrade.md): Tira um upgrade de tuning de um veículo.
- [getVehicleCompatibleUpgrades (Compartilhado)](https://wiki.mymp.gg/pt/getVehicleCompatibleUpgrades.md): Devolve os upgrades de tuning que servem no modelo de um veículo.
- [getVehicleUpgrades (Compartilhado)](https://wiki.mymp.gg/pt/getVehicleUpgrades.md): Devolve todos os upgrades de tuning instalados em um veículo.
- [getVehicleUpgradeOnSlot (Compartilhado)](https://wiki.mymp.gg/pt/getVehicleUpgradeOnSlot.md): Devolve o upgrade instalado em um slot de um veículo.