Veículos

Estas funções falam com o veículo que o jogador tem de fato na frente dele: o carro físico que este cliente carregou, com suas peças, rodas, rotor e estado de motor. É por isso que elas alcançam coisas que o servidor nunca vê — mexer numa peça isolada da lataria, mudar o tamanho das rodas, ler a marcha atual ou dar a um único carro a sua própria gravidade.

Tudo nesta página é local para o jogador que está rodando o script. Nada é enviado ao servidor nem aos outros jogadores: o carro fica diferente só nesta máquina.

Quando você passa algo que não é um veículo, a maioria das funções devolve false e escreve o motivo no console de debug. Algumas — cada página diz quais — geram um erro de Lua, que interrompe o código que as chamou.

Um veículo fora de stream (longe demais para este cliente tê-lo carregado) não tem carro físico, mas este cliente continua lembrando o que sabia dele por último e o que os scripts definiram nele. A maioria dos getters responde com essa memória, e a maioria dos setters guarda o novo valor e o aplica quando o carro volta para perto. Onde o comportamento é diferente, está dito na própria função.

Estas 61 funções existem somente no cliente. Chamá-las de um script de servidor resulta em erro de valor nulo.

Veja também as funções compartilhadas de Veículos, que funcionam nos dois lados.

Veículos criados no cliente

Um veículo criado por um script de cliente existe só na máquina daquele jogador — ninguém mais o vê.

Para removê-lo, use destroyElement, que é a função de destruição de qualquer elemento:

local carro = createVehicle(411, 1959.55, -1714.46, 15.5)

-- some com ele dez segundos depois
setTimer(function()
    destroyElement(carro)
end, 10000, 1)

Um veículo que veio do servidor pertence ao servidor: destruí-lo no cliente é recusado.

Faróis e câmbio

areVehicleLightsOn Diz se os faróis estão realmente acesos neste momento.

getVehicleCurrentGear Devolve a marcha em que o câmbio está.

Janelas

Os índices de janela vão de 0 a 6. Fora disso, false, sem mensagem.

isVehicleWindowOpen Devolve se uma janela está aberta.

setVehicleWindowOpen Abre ou fecha uma janela.

Rodas

As rodas são numeradas na ordem dianteira esquerda, traseira esquerda, dianteira direita, traseira direita:

Índice	Nome	Roda
0	"front_left"	Dianteira esquerda
1	"rear_left"	Traseira esquerda
2	"front_right"	Dianteira direita
3	"rear_right"	Traseira direita

Motos têm só duas rodas, então nelas apenas os índices 0 e 1 significam alguma coisa.

getVehicleWheelScale Devolve o multiplicador de tamanho aplicado às rodas do veículo.

setVehicleWheelScale Deixa as rodas maiores ou menores.

isVehicleWheelOnGround Devolve se uma roda está encostando no chão.

getVehicleWheelFrictionState Devolve o estado de atrito que a física está usando para uma roda.

setVehicleWheelsRotation Gira todas as rodas até um ângulo.

Rotores e hélices

getVehicleRotorSpeed Devolve a velocidade do rotor ou da hélice.

setVehicleRotorSpeed Define a velocidade do rotor ou da hélice.

getHelicopterRotorSpeed Devolve a velocidade do rotor de um helicóptero.

setHelicopterRotorSpeed Define a velocidade do rotor de um helicóptero.

getVehicleRotorState Devolve se o rotor deveria estar girando.

setVehicleRotorState Liga ou para o rotor.

getHeliBladeCollisionsEnabled Devolve se as hélices do helicóptero estão marcadas para colidir.

setHeliBladeCollisionsEnabled Liga ou desliga a colisão das hélices de um helicóptero.

Peça ajustável

Alguns modelos têm uma peça móvel: uma caçamba que bascula, um garfo que levanta, uma asa que dobra. As funções abaixo leem e escrevem o quanto essa peça andou, como um número inteiro.

Modelo	Veículo	Modelo	Veículo
406	Dumper	525	Towtruck
443	Packer	530	Forklift
486	Dozer	531	Tractor
520	Hydra	592	Andromada
524	Cement Truck

getVehicleAdjustableProperty Devolve o quanto a peça móvel andou.

setVehicleAdjustableProperty Move a peça.

Nitro

O nitro só existe num veículo depois que um dos upgrades de nitro (1008, 1009 ou 1010) é instalado com addVehicleUpgrade. Sem ele, todas as funções abaixo devolvem false.

Ligar e desligar o impulso é com setVehicleNitroActivated, na página compartilhada.

getVehicleNitroCount Devolve quantas cargas de nitro sobraram.

setVehicleNitroCount Define quantas cargas sobraram.

getVehicleNitroLevel Devolve o quanto a carga atual está cheia.

setVehicleNitroLevel Define a carga atual.

isVehicleNitroActivated Devolve se o impulso está sendo usado agora.

isVehicleNitroRecharging Devolve se a carga está se recompondo.

Gravidade

Cada veículo pode ter a sua própria direção de gravidade, na forma de um vetor. O padrão é 0, 0, -1 — para baixo.

getVehicleGravity Devolve o vetor de gravidade do veículo.

setVehicleGravity Define o vetor de gravidade do veículo.

Giro e congelamento

getVehicleTurnVelocity Devolve a velocidade com que o veículo gira em cada eixo.

setVehicleTurnVelocity Define a velocidade com que o veículo gira em cada eixo.

isVehicleFrozen Devolve se o veículo está congelado no lugar.

setVehicleFrozen Congela o veículo no lugar ou o solta.

Componentes

Um componente é uma peça com nome dentro do modelo do veículo — uma porta, o capô, uma roda, o chassi. Dá para mover, girar, redimensionar e esconder cada uma separadamente. O getVehicleComponents mostra os nomes que aquele modelo realmente tem.

Posições, rotações e escalas são lidas e escritas em relação a uma base:

Base	Significado
"world"	Coordenadas do mundo.
"root"	Em relação ao próprio veículo.
"parent"	Em relação à peça da qual o componente depende.

O argumento de base é sempre opcional, e cada função tem o seu padrão — "root" para posições, "parent" para rotações e escalas. Qualquer outro texto devolve false com um aviso no console de debug.

Um nome de componente que o modelo não tem devolve false.

getVehicleComponents Lista os componentes de um veículo.

getVehicleComponentPosition Devolve onde um componente está.

setVehicleComponentPosition Move um componente.

getVehicleComponentRotation Devolve como um componente está girado.

setVehicleComponentRotation Gira um componente.

getVehicleComponentScale Devolve a escala de um componente.

setVehicleComponentScale Redimensiona um componente.

getVehicleComponentVisible Devolve se um componente está sendo desenhado.

setVehicleComponentVisible Mostra ou esconde um componente.

resetVehicleComponentPosition Devolve um componente para a posição do modelo.

resetVehicleComponentRotation Devolve a rotação de um componente para a do modelo.

resetVehicleComponentScale Devolve a escala de um componente para a do modelo.

Dummies

Dummies são os pontos de referência que o modelo carrega: onde ficam os faróis, de onde sai a fumaça do escapamento, onde um reboque engata. Eles têm nome, não número:

Nome	Ponto
"light_front_main"	Faróis dianteiros principais
"light_rear_main"	Lanternas traseiras principais
"light_front_second"	Faróis dianteiros secundários
"light_rear_second"	Lanternas traseiras secundárias
"seat_front"	Banco da frente
"seat_rear"	Banco de trás
"exhaust"	Escapamento
"engine"	Motor
"gas_cap"	Tampa do tanque
"trailer_attach"	Engate do reboque
"hand_rest"	Guidão / apoio de mão
"exhaust_second"	Segundo escapamento
"wing_airtrail"	Ponta da asa de onde sai o rastro
"veh_gun"	Arma do veículo

O nome é comparado primeiro exatamente e depois em minúsculas. Qualquer outro nome é recusado: getVehicleDummyPosition, setVehicleDummyPosition e getVehicleModelDummyDefaultPosition geram um erro de Lua, as outras funções de modelo devolvem false com um aviso no console de debug.

São dois conjuntos de funções: as que recebem um veículo mexem naquele carro só, e as que recebem um ID de modelo mexem no modelo em si, e com ele em todos os veículos daquele modelo neste cliente.

getVehicleDummyPosition Devolve onde está um dos dummies de um veículo.

setVehicleDummyPosition Move um dos dummies de um veículo.

resetVehicleDummyPositions Descarta todos os dummies próprios daquele veículo.

getVehicleModelDummyPosition Devolve onde um dummy está num modelo.

setVehicleModelDummyPosition Move um dummy num modelo.

getVehicleModelDummyDefaultPosition Devolve onde o dummy estava antes de alguém mexer nele.

getVehicleModelExhaustFumesPosition Devolve de onde sai a fumaça do escapamento de um modelo.

setVehicleModelExhaustFumesPosition Muda de onde sai a fumaça do escapamento de um modelo.

Tamanho das rodas do modelo

O tamanho da roda é uma propriedade do modelo, então mudá-lo afeta todos os veículos daquele modelo neste cliente. Os dois eixos podem ter tamanhos diferentes:

Grupo	Rodas
"front_axle"	Rodas dianteiras
"rear_axle"	Rodas traseiras
"all_wheels"	Os dois eixos de uma vez

Qualquer outro texto gera um erro de Lua.

getVehicleModelWheelSize Devolve o tamanho de roda de um modelo.

setVehicleModelWheelSize Define o tamanho de roda de um modelo.

Pontos de entrada

getVehicleEntryPoints Devolve os pontos até onde um ped anda para entrar no veículo.

Trens

isTrainChainEngine Devolve se um vagão é a locomotiva que puxa a composição.

Áudio

Todo modelo de veículo tem um conjunto de configurações de som: qual banco de som de motor usa, a buzina, o rádio, o som das portas e assim por diante. Dá para mudá-las para um modelo inteiro ou para um só veículo; um veículo com configurações próprias ignora mudanças posteriores no modelo dele. Os nomes das configurações e os valores que cada uma aceita estão listados em setVehicleAudioSetting.

As seis funções geram um erro de Lua diante de um argumento inválido, e nenhuma delas chega ao servidor ou aos outros jogadores.

getVehicleAudioSettings Devolve as configurações de som que um veículo está usando.

setVehicleAudioSetting Muda uma configuração de som de um único veículo.

resetVehicleAudioSettings Descarta as configurações de som próprias de um veículo.

getVehicleModelAudioSettings Devolve as configurações de som de um modelo.

setVehicleModelAudioSetting Muda uma configuração de som de um modelo inteiro.

resetVehicleModelAudioSettings Devolve as configurações de som de um modelo às do jogo.