createVehicle

Cria um veículo no mundo.

Sintaxe

-- servidor
vehicle createVehicle ( number modelo, number x, number y, number z
                        [, number rx = 0, number ry = 0, number rz = 0,
                           string placa, bool direcao,
                           number variante1, number variante2, bool sincronizado = true ] )

-- cliente
vehicle createVehicle ( number modelo
                        [, number x, number y, number z,
                           number rx = 0, number ry = 0, number rz,
                           string placa, number variante1 = 255, number variante2 = 255 ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
modelo	number	—	ID do modelo, entre 400 e 611.
x, y, z	number	—	Posição de spawn. Obrigatória no servidor; opcional no cliente.
rx, ry	number	0	Rotação de spawn, em graus.
rz	number	veja abaixo	Rotação de spawn em torno do eixo vertical, em graus.
placa	string	—	Texto da placa, cortado em 8 caracteres. Se omitido, o servidor inventa uma placa aleatória; o cliente a deixa vazia.
direcao	bool	—	Só no servidor. Aceito por compatibilidade com o spawn de trens do MTA e hoje ignorado. Só é lido quando é booleano, então você pode omiti-lo e passar direto às variantes.
variante1, variante2	number	veja abaixo	Variantes de carroceria, de 0 a 5, ou 255 para nenhuma.
sincronizado	bool	true	Só no servidor. false deixa o veículo fora da sincronização de veículos vazios: nenhum jogador fica responsável pela física dele enquanto está desocupado.

Quando as duas variantes são omitidas, é sorteado um par válido para o modelo (no cliente, passar 255, 255 faz o mesmo). Qualquer outro valor acima de 5 faz a chamada falhar.

Retorno

O veículo criado, ou false se o modelo estiver fora da faixa 400–611 ou uma variante for inválida. Uma posição ou modelo que não seja número é reportado como argumento inválido e também dá false.

O servidor escolhe a pintura na tabela de cores do modelo, a mesma para todos os jogadores — use setVehicleColor depois para escolher a sua.

No cliente, omitir a posição faz o veículo nascer alguns metros à frente do jogador local, virado para o mesmo lado que ele; nesse caso rz também assume a direção do jogador. Com a posição informada, rz vale 0 por padrão.

Veículos criados no cliente são só daquele cliente

Um veículo criado por um script de cliente existe apenas na máquina dele: ninguém mais o enxerga e ele não é sincronizado. Para um veículo que todo mundo vê, crie-o no servidor.

Bug conhecido no servidor: ry é ignorado

Na versão atual, o createVehicle do servidor não aplica ry na rotação de spawn — o valor de rz acaba sendo usado no lugar dele. Na prática, o veículo nasce sem a inclinação lateral que você pediu. A versão do cliente aplica os três eixos normalmente.

Isso será corrigido. Quando a correção sair, rx, ry e rz vão se comportar como esta tabela descreve nos dois lados. Se você precisa da rotação completa agora, aplique-a depois de criar o veículo:

local veiculo = createVehicle(411, x, y, z)
setElementRotation(veiculo, rx, ry, rz)

Exemplo

-- servidor
local carro = createVehicle(411, 1959.55, -1714.46, 15.5)
setElementData(carro, "dono", "ninguem")

-- cliente: um carro de vitrine, só nesta tela
local vitrine = createVehicle(411)

Veja também

• createElement — Cria um elemento genérico, sem representação visual, com o tipo que você quiser.
• getVehicleController — Devolve quem está ao volante de um veículo.
• destroyElement — Destrói um elemento e tudo que estiver abaixo dele na árvore.