Flip Upright

Overview

• Node Name: Flip Upright
• Category: repeat_instant
• File: extensions/flowgraph/nodes/vehicle/flipUpright.lua

Flips a vehicle upright without repairing it. Uses spawn.safeTeleport with the vehicle's current position and a corrected rotation derived from its direction vector.

Pin Schema

Input Pins

Internals

Key Methods

How It Works

1. The node resolves the vehicle from vehId or defaults to getPlayerVehicle(0).
2. It calls spawn.safeTeleport(veh, veh:getPosition(), quatFromDir(veh:getDirectionVector()), nil, nil, nil, nil, false).
   • The position stays the same (current location).
   • The rotation is rebuilt from the vehicle's forward direction vector, forcing it upright.
   • The last false parameter means the vehicle is not repaired.
3. Fires extensions.hook('onVehicleFlippedUpright', veh:getID()) so other systems can react.

Usage Example

-- In a flowgraph:
-- [Flip Condition] → [Flip Upright] ← vehId ← [Vehicle ID]

-- Programmatic equivalent:
local veh = getPlayerVehicle(0)
if veh then
  spawn.safeTeleport(veh, veh:getPosition(), quatFromDir(veh:getDirectionVector()), nil, nil, nil, nil, false)
  extensions.hook('onVehicleFlippedUpright', veh:getID())
end

Key Dependencies

• spawn.safeTeleport() - teleports a vehicle safely to a position/rotation
• quatFromDir() - creates an upright quaternion from a direction vector
• onVehicleFlippedUpright hook - notifies other systems of the flip

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