# getVehicleHandling (Compartilhado)

> Lê o handling de um veículo: massa, motor, tração, suspensão e o resto do que define como ele anda.

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

## Sintaxe

```lua
table|any getVehicleHandling(vehicle vehicle [, string property = nil])
```

## Parâmetros

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `vehicle` | `vehicle` | O veículo. |
| `property` | `string` | Uma propriedade só. Um nome desconhecido gera erro. *(padrão: `nil`)* |

## Retorno

Sem `property`, uma tabela com todas as propriedades. Com ela, o valor dessa propriedade. `false` se o veículo não tem handling.

### Propriedades de handling

| Tipo     | Propriedades                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Números  | `mass`, `turnMass`, `inertiaShape`, `dragCoeff`, `tractionMultiplier`, `engineAcceleration`, `engineInertia`, `maxVelocity`, `clutchUpShift`, `clutchDownShift`, `brakeDeceleration`, `brakeBias`, `steeringLock`, `tractionLoss`, `tractionBias`, `tractionLoadSensitivity`, `tractionSlipPeak`, `tractionSlipSlide`, `suspensionForceLevel`, `suspensionDamping`, `suspensionHighSpeedDamping`, `suspensionUpperLimit`, `suspensionLowerLimit`, `suspensionFrontRearBias`, `suspensionAntiDiveMultiplier`, `suspensionAntiRollFront`, `suspensionAntiRollRear`, `suspensionReboundRatio`, `collisionDamageMultiplier`, `seatOffsetDistance` |
| Inteiros | `percentSubmerged`, `numberOfGears`, `monetary`, `handlingFlags`, `modelFlags`, `animGroup`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Booleano | `ABS`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Textos   | `driveType` (`fwd`, `rwd`, `awd`), `engineType` (`petrol`, `diesel`, `electric`), `headLight` e `tailLight` (`long`, `small`, `big`, `tall`)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Tabela   | `centerOfMass` (`{x, y, z}`)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |

## Exemplo

```lua
addCommandHandler("handling", function(player)
    local vehicle = getPedOccupiedVehicle(player)
    if vehicle then
        local handling = getVehicleHandling(vehicle)
        outputDebugString(("massa %.0f, velocidade máxima %.0f"):format(handling.mass, handling.maxVelocity))
    end
end)
```

### Vindo do MTA

No MTA, `getVehicleHandling` só devolve a tabela inteira. Aqui dá para pedir uma propriedade.

### Atenção

Pedida sozinha, `ABS` vem como número (1 ou 0); na tabela, vem como booleano.

## Veja também

- [setVehicleHandling (Servidor)](https://wiki.mymp.gg/pt/setVehicleHandling-server.md): Muda o handling de um veículo para todos os jogadores.
- [setVehicleHandling (Cliente)](https://wiki.mymp.gg/pt/setVehicleHandling-client.md): Muda o handling de um veículo só neste cliente.
- [getOriginalHandling (Servidor)](https://wiki.mymp.gg/pt/getOriginalHandling-server.md): Lê o handling original de um modelo de veículo, como os pacotes de conteúdo o declaram, sem as mudanças dos scripts.
- [getModelHandling (Servidor)](https://wiki.mymp.gg/pt/getModelHandling.md): Lê o handling de um modelo de veículo, com que os veículos novos desse modelo começam.