# getVehicleHandling (Compartido)

> Lee el handling de un vehículo: su masa, motor, tracción, suspensión y el resto de lo que define cómo se conduce.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Función Lua
- **Lado**: Compartido
- **Categoría**: Handling
- **URL**: https://wiki.mymp.gg/es/getVehicleHandling

## Sintaxis

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

## Parámetros

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `vehicle` | `vehicle` | El vehículo. |
| `property` | `string` | Una sola propiedad. Un nombre desconocido genera un error. *(por defecto: `nil`)* |

## Retorno

Sin `property`, una tabla con todas las propiedades. Con ella, el valor de esa propiedad. `false` si el vehículo no tiene handling.

### Propiedades de handling

| Tipo     | Propiedades                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 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` |
| Enteros  | `percentSubmerged`, `numberOfGears`, `monetary`, `handlingFlags`, `modelFlags`, `animGroup`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Booleano | `ABS`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Textos   | `driveType` (`fwd`, `rwd`, `awd`), `engineType` (`petrol`, `diesel`, `electric`), `headLight` y `tailLight` (`long`, `small`, `big`, `tall`)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Tabla    | `centerOfMass` (`{x, y, z}`)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |

## Ejemplo

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

### Si vienes de MTA

En MTA, `getVehicleHandling` solo devuelve la tabla entera. Aquí se puede pedir una propiedad.

### Atención

Pedida sola, `ABS` viene como número (1 o 0); en la tabla, viene como booleano.

## Ver también

- [setVehicleHandling (Servidor)](https://wiki.mymp.gg/es/setVehicleHandling-server.md): Cambia el handling de un vehículo para todos los jugadores.
- [setVehicleHandling (Cliente)](https://wiki.mymp.gg/es/setVehicleHandling-client.md): Cambia el handling de un vehículo solo en este cliente.
- [getOriginalHandling (Servidor)](https://wiki.mymp.gg/es/getOriginalHandling-server.md): Lee el handling original de un modelo de vehículo, tal como lo declaran los paquetes de contenido, sin los cambios de los scripts.
- [getModelHandling (Servidor)](https://wiki.mymp.gg/es/getModelHandling.md): Lee el handling de un modelo de vehículo, con el que empiezan los vehículos nuevos de ese modelo.