attachTrailerToVehicle

Engata um reboque em um veículo.

Sintaxe

-- servidor
bool attachTrailerToVehicle ( vehicle oVeiculo, vehicle oReboque )

-- cliente
bool attachTrailerToVehicle ( vehicle oVeiculo, vehicle oReboque [, number rx, number ry, number rz ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
oVeiculo	vehicle	—	Veículo que puxa.
oReboque	vehicle	—	Veículo a ser puxado.
rx, ry, rz	number	0	Só no cliente. Deslocamento de rotação, em graus, somado à rotação do veículo que puxa para girar o reboque no engate. Dá para passar um vetor no lugar dos três números.

Este é um dos poucos casos em que a versão do cliente aceita mais argumentos que a do servidor.

Devolve false quando os dois argumentos são o mesmo veículo, quando o veículo já puxa alguma coisa ou quando o reboque já está engatado em outro. O cliente também recusa um trem como reboque de qualquer coisa que não seja outro trem, e segue as regras de reboque do jogo para o Towtruck (525) e o Tractor (531): nada de barcos, motos ou BMX, e nenhum reboque além da carreta agrícola do Tractor (610). Engatar um vagão num trem o junta à composição e o coloca no trilho da locomotiva.

No servidor, o engate é replicado para todos os jogadores e dispara onTrailerAttach no reboque; no cliente ele vale só naquela máquina, e nenhum evento é disparado.

Exemplo

-- servidor
local caminhao = createVehicle(403, x, y, z)
local carreta  = createVehicle(435, x, y - 6, z)
attachTrailerToVehicle(caminhao, carreta)

Veja também

• detachTrailerFromVehicle — Desengata o reboque.
• getVehicleTowedByVehicle — Devolve o reboque que este veículo está puxando.
• getVehicleTowingVehicle — Devolve o veículo que está puxando este.