AI Directly To

Overview

Node Name: AI Directly To
Category: custom (duration + once behavior)
File: extensions/flowgraph/nodes/vehicle/ai/directlyTo.lua

Drives a vehicle directly toward a target position using scripted AI path following. Unlike waypoint-based navigation, this generates a straight-line path divided into steps. Outputs flow once the vehicle arrives within minDistance.

Pin Schema

Input Pins

Pin	Type	Default	Description
`flow`	flow	-	Inflow for the node
`reset`	flow (impulse)	-	Resets the node state
`vehId`	number	-	Vehicle ID (uses player vehicle if empty)
`target`	vec3	-	World position to drive to
`targetVelocity`	number	-	Target speed while driving (m/s)

Output Pins

Pin	Type	Description
`flow`	flow	Outflow - active once the vehicle has arrived

Internals

Key Methods

Method	Description
`init()`	Sets up state flags and data defaults
`reset()`	Clears started/complete flags and stops the AI
`getVeh()`	Resolves vehicle by ID or player vehicle
`setupAI()`	Generates a straight-line path and starts `ai.startFollowing()`
`endAI()`	Calls `ai:scriptStop()` with optional handbrake/wheel straightening
`work()`	Monitors distance to target, transitions to complete

Data Fields (auto-serialized)

Field	Default	Description
`minDistance`	`1.5`	Arrival distance threshold (meters)
`handBrakeWhenFinished`	`false`	Apply handbrake on arrival
`straightenWheelsWhenFinished`	`false`	Straighten wheels on arrival
`maxStepDistance`	`5`	Maximum distance between path waypoints

Path Generation

Computes the direction vector from vehicle position to target.
Divides the path into steps of at most maxStepDistance.
Creates steps + 3 extra path points beyond the target (overshoot buffer).
Each point includes {x, y, z, t} where t = distance / speed.
Sends path via ai.startFollowing(path, nil, 0, "neverReset").

How It Works

On first flow, calls setupAI() to generate and send the path.
Each subsequent frame, checks squared distance from vehicle to target.
When distance < minDistance², calls endAI() and sets complete = true.
Once complete, outputs flow on the flow output pin.
The reset impulse pin restarts the entire process.

Usage Example

-- Drive vehicle to a specific world position:
-- vehId = vehicleId
-- target = {100, 200, 30}
-- targetVelocity = 10  (10 m/s ≈ 36 km/h)

-- Wait for arrival then trigger next action:
-- Connect flow output → next node in sequence

-- Reset to drive to a new position:
-- Send impulse to 'reset', then update 'target'

Key Dependencies

ai.startFollowing() - scripted path following
ai:scriptStop() - stops scripted AI driving

Overview

Node Name: AI Directly To
Category: custom (duration + once behavior)
File: extensions/flowgraph/nodes/vehicle/ai/directlyTo.lua

Pin Schema

Input Pins

Pin	Type	Default	Description
`flow`	flow	-	Inflow for the node
`reset`	flow (impulse)	-	Resets the node state
`vehId`	number	-	Vehicle ID (uses player vehicle if empty)
`target`	vec3	-	World position to drive to
`targetVelocity`	number	-	Target speed while driving (m/s)

Output Pins

Pin	Type	Description
`flow`	flow	Outflow - active once the vehicle has arrived

Internals

Key Methods

Method	Description
`init()`	Sets up state flags and data defaults
`reset()`	Clears started/complete flags and stops the AI
`getVeh()`	Resolves vehicle by ID or player vehicle
`setupAI()`	Generates a straight-line path and starts `ai.startFollowing()`
`endAI()`	Calls `ai:scriptStop()` with optional handbrake/wheel straightening
`work()`	Monitors distance to target, transitions to complete

Data Fields (auto-serialized)

Field	Default	Description
`minDistance`	`1.5`	Arrival distance threshold (meters)
`handBrakeWhenFinished`	`false`	Apply handbrake on arrival
`straightenWheelsWhenFinished`	`false`	Straighten wheels on arrival
`maxStepDistance`	`5`	Maximum distance between path waypoints

Path Generation

Computes the direction vector from vehicle position to target.
Divides the path into steps of at most maxStepDistance.
Creates steps + 3 extra path points beyond the target (overshoot buffer).
Each point includes {x, y, z, t} where t = distance / speed.
Sends path via ai.startFollowing(path, nil, 0, "neverReset").

How It Works

On first flow, calls setupAI() to generate and send the path.
Each subsequent frame, checks squared distance from vehicle to target.
When distance < minDistance², calls endAI() and sets complete = true.
Once complete, outputs flow on the flow output pin.
The reset impulse pin restarts the entire process.

Usage Example

-- Drive vehicle to a specific world position:
-- vehId = vehicleId
-- target = {100, 200, 30}
-- targetVelocity = 10  (10 m/s ≈ 36 km/h)

-- Wait for arrival then trigger next action:
-- Connect flow output → next node in sequence

-- Reset to drive to a new position:
-- Send impulse to 'reset', then update 'target'

Key Dependencies

ai.startFollowing() - scripted path following
ai:scriptStop() - stops scripted AI driving

AI Directly To

Overview

Pin Schema

Input Pins

Output Pins

Internals

Key Methods

Data Fields (auto-serialized)

Path Generation

How It Works

Usage Example

Key Dependencies

See Also

On this page

AI Directly To

Overview

Pin Schema

Input Pins

Output Pins

Internals

Key Methods

Data Fields (auto-serialized)

Path Generation

How It Works

Usage Example

Key Dependencies

See Also

On this page