Veículos

Estas funções trabalham sobre elementos do tipo vehicle. O veículo em si é criado com createVehicle, que fica na página de Elementos.

Quando um argumento inválido é passado — um elemento que não é veículo, um handle já destruído — a função devolve false e escreve o motivo no console de debug.

Setters aceitam elementos-pai

A maior parte dos setters de veículo não exige um veículo diretamente: você pode passar qualquer elemento e a mudança é aplicada a ele (se for um veículo) e a todos os veículos abaixo dele na árvore de elementos. Ou seja, setVehicleEngineState(root, false) desliga o motor de todos os veículos do servidor. O retorno é true quando pelo menos um veículo foi alterado.

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

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

Nomes e modelos

IDs de modelo de veículo vão de 400 a 611.

getVehiclesOfType Lista todos os veículos do servidor com um determinado modelo.

Respawn

Cada veículo guarda um ponto de respawn (posição e rotação), um atraso para renascer depois de explodir e outro para renascer quando fica parado sem ninguém dentro.

respawnVehicle Devolve o veículo ao ponto de respawn agora.

spawnVehicle Faz o veículo reaparecer num ponto, reparado, sem mexer no ponto de respawn dele.

toggleVehicleRespawn Liga ou desliga o respawn automático.

isVehicleRespawnable Diz se o respawn automático está ligado.

setVehicleRespawnPosition Define para onde o veículo volta ao renascer.

getVehicleRespawnPosition Devolve o ponto de respawn.

setVehicleRespawnRotation Define só a rotação de respawn.

getVehicleRespawnRotation Devolve a rotação de respawn.

setVehicleRespawnDelay Define quanto tempo o veículo fica destruído antes de renascer.

getVehicleRespawnDelay Devolve o atraso de respawn após explosão.

setVehicleIdleRespawnDelay Define quanto tempo o veículo pode ficar parado e vazio antes de renascer.

getVehicleIdleRespawnDelay Devolve o atraso de respawn por inatividade.

resetVehicleExplosionTime Zera o cronômetro que conta desde a explosão, adiando o respawn automático.

resetVehicleIdleTime Zera o cronômetro de inatividade, adiando o respawn por abandono.

Handling

Handling é o conjunto de propriedades físicas de um veículo: massa, aceleração, freio, suspensão e por aí vai.

Existem dois níveis de configuração:

• Por veículo — getVehicleHandling / setVehicleHandling, afeta só aquele elemento.
• Por modelo — getModelHandling / setModelHandling, o handling com que um veículo daquele modelo começa.

Um veículo recebe o handling do modelo quando é criado, quando passa a ser daquele modelo e quando o handling próprio dele é restaurado com setVehicleHandling(veiculo); os veículos que já existem mantêm o deles quando o modelo muda. Um modelo sem ajuste usa os valores de fábrica, sempre disponíveis em getOriginalHandling.

getModelHandling Lê o handling em vigor para um modelo.

setModelHandling Altera o handling com que os novos veículos de um modelo começam.