Move Vehicle To

Overview

• Node Name: Move Vehicle To
• Category: repeat_instant
• File: extensions/flowgraph/nodes/vehicle/moveTo.lua

Moves a vehicle to a predefined position and rotation. Supports both direct teleport (with repair) and safe teleport (finds a good spot automatically). Can optionally move without repairing the vehicle.

Pin Schema

Input Pins

Legacy Pins

Internals

Key Methods

Teleport Modes

Rotation Correction

When using safeTeleport, the rotation is corrected: quat(rot) * quat(0,0,-1,0) to align the vehicle's forward direction properly.

How It Works

1. Resolves the vehicle from vehId or defaults to getPlayerVehicle(0).
2. Validates that pos is a 3-element array. Falls back to {0,0,0,0} for rotation if not provided.
3. Depending on repairVehicle and safeTeleport flags:
   • Default (repair, no safe teleport): Uses vehicleSetPositionRotation(id, x, y, z, rx, ry, rz, rw) - vehicle is repaired.
   • Repair + safe teleport: Uses spawn.safeTeleport(veh, vec3(pos), quat(correctedRot)).
   • No repair: Uses spawn.safeTeleport with the last parameter false to skip repair.
4. Fires appropriate hooks: trackVehReset when repaired, onVehicleFlippedUpright when moved without repair.

Usage Example

-- In a flowgraph:
-- [Position Provider] → pos → [Move Vehicle To] ← vehId ← [Vehicle ID]
-- [Rotation Provider] → rot →

-- Programmatic equivalent (with repair):
vehicleSetPositionRotation(vehId, x, y, z, rx, ry, rz, rw)
extensions.hook('trackVehReset')

-- Without repair:
local correctedRot = quat(rot) * quat(0,0,-1,0)
spawn.safeTeleport(veh, vec3(pos), quat(correctedRot), nil, nil, nil, nil, false)
extensions.hook('onVehicleFlippedUpright', veh:getID())

Key Dependencies

• vehicleSetPositionRotation() - engine function for direct teleport with repair
• spawn.safeTeleport() - finds a safe position and teleports the vehicle
• trackVehReset hook - fired when a vehicle is reset/repaired (used for DNF penalties)
• onVehicleFlippedUpright hook - fired when a vehicle is moved without repair

See Also

• Align for Coupling (Flowgraph Node) - Related reference
• Apply Velocity to Vehicle (Flowgraph Node) - Related reference
• Boost Vehicle (Flowgraph Node) - Related reference
• FlowGraph Guide - Guide