AI Go To The End Line

Overview

Node Name: AI Go To The End Line
Category: once_f_duration (behaviour: duration)
File: extensions/flowgraph/nodes/vehicle/ai/goToEndLine.lua

Drives a vehicle to a target end-line position using the AI in manual mode. Outputs flow once the vehicle reaches the position and slows below a threshold velocity.

Pin Schema

Input Pins

Pin	Type	Default	Description
`flow`	flow	-	Inflow for this node.
`reset`	flow (impulse)	-	Resets the node so the destination can be driven to again.
`aiVehId`	number	-	The AI vehicle. Uses player vehicle if empty.
`endLinePosition`	vec3	-	Position of the end line to drive to.
`checkDistance`	number	1	Distance threshold to consider arrived (hidden).
`checkVelocity`	number	0.1	Vehicle must be slower than this to be considered arrived (hidden, hardcoded).

Output Pins

Pin	Type	Description
`flow`	flow	Fires once the destination is reached and the vehicle is slow enough.
`distance`	number	Current distance to the target waypoint center (hidden).

Internals

Key Methods

Method	Description
`work()`	Main loop - checks distance from vehicle front to target, sets AI manual mode once, marks complete when close + slow.
`onNodeReset()`	Clears `complete` and `sentCommand` flags.
`_executionStopped()`	Calls `onNodeReset()`.
`getVeh()`	Resolves vehicle from `aiVehId` pin or falls back to player vehicle.

Data Properties

Property	Default	Description
`autoDisableOnArrive`	`true`	Automatically disables AI when the vehicle arrives.

How It Works

On first work() with flow, sends ai.setState({mode = "manual"}) to the vehicle (once).
Each frame, calculates distance from the vehicle's front center point to the target endLinePosition.
When distance drops below checkDistance, checks if velocity is below checkVelocity.
Once both conditions are met, sets complete = true and optionally disables AI.
Outputs flow on the next frame after completion.

-- The front position is calculated as the midpoint of the two front corners:
local frontPos = linePointFromXnorm(
  vec3(veh:getCornerPosition(0)),
  vec3(veh:getCornerPosition(1)),
  0.5
)
local dist = (frontPos - endLinePosition):length()

Usage Example

-- In a flowgraph:
-- [Set Position] → endLinePosition → [AI Go To End Line] → flow → [Next Step]
--                                      ↑ aiVehId from vehicle spawn

-- Useful for race finish lines, parking challenges, delivery endpoints.

Key Dependencies

ai.setState({mode = "manual"}) - sets AI to manual driving mode
ai.setState({mode = "disabled"}) - disables AI on arrival
map.objects[id].vel - velocity lookup from the map module
linePointFromXnorm() - linear interpolation between two points

Previously Undocumented (Added by Audit)

Input Pin: inRadius (any)

Overview

Node Name: AI Go To The End Line
Category: once_f_duration (behaviour: duration)
File: extensions/flowgraph/nodes/vehicle/ai/goToEndLine.lua

Drives a vehicle to a target end-line position using the AI in manual mode. Outputs flow once the vehicle reaches the position and slows below a threshold velocity.

Pin Schema

Input Pins

Pin	Type	Default	Description
`flow`	flow	-	Inflow for this node.
`reset`	flow (impulse)	-	Resets the node so the destination can be driven to again.
`aiVehId`	number	-	The AI vehicle. Uses player vehicle if empty.
`endLinePosition`	vec3	-	Position of the end line to drive to.
`checkDistance`	number	1	Distance threshold to consider arrived (hidden).
`checkVelocity`	number	0.1	Vehicle must be slower than this to be considered arrived (hidden, hardcoded).

Output Pins

Pin	Type	Description
`flow`	flow	Fires once the destination is reached and the vehicle is slow enough.
`distance`	number	Current distance to the target waypoint center (hidden).

Internals

Key Methods

Method	Description
`work()`	Main loop - checks distance from vehicle front to target, sets AI manual mode once, marks complete when close + slow.
`onNodeReset()`	Clears `complete` and `sentCommand` flags.
`_executionStopped()`	Calls `onNodeReset()`.
`getVeh()`	Resolves vehicle from `aiVehId` pin or falls back to player vehicle.

Data Properties

Property	Default	Description
`autoDisableOnArrive`	`true`	Automatically disables AI when the vehicle arrives.

How It Works

On first work() with flow, sends ai.setState({mode = "manual"}) to the vehicle (once).
Each frame, calculates distance from the vehicle's front center point to the target endLinePosition.
When distance drops below checkDistance, checks if velocity is below checkVelocity.
Once both conditions are met, sets complete = true and optionally disables AI.
Outputs flow on the next frame after completion.

-- The front position is calculated as the midpoint of the two front corners:
local frontPos = linePointFromXnorm(
  vec3(veh:getCornerPosition(0)),
  vec3(veh:getCornerPosition(1)),
  0.5
)
local dist = (frontPos - endLinePosition):length()

Usage Example

-- In a flowgraph:
-- [Set Position] → endLinePosition → [AI Go To End Line] → flow → [Next Step]
--                                      ↑ aiVehId from vehicle spawn

-- Useful for race finish lines, parking challenges, delivery endpoints.

Key Dependencies

ai.setState({mode = "manual"}) - sets AI to manual driving mode
ai.setState({mode = "disabled"}) - disables AI on arrival
map.objects[id].vel - velocity lookup from the map module
linePointFromXnorm() - linear interpolation between two points

Previously Undocumented (Added by Audit)

Input Pin: inRadius (any)

AI Go To The End Line

Overview

Pin Schema

Input Pins

Output Pins

Internals

Key Methods

Data Properties

How It Works

Usage Example

Key Dependencies

Previously Undocumented (Added by Audit)

See Also

On this page

AI Go To The End Line

Overview

Pin Schema

Input Pins

Output Pins

Internals

Key Methods

Data Properties

How It Works

Usage Example

Key Dependencies

Previously Undocumented (Added by Audit)

See Also

On this page