AI Follow Waypoints

Overview

• Node Name: AI Follow Waypoints
• Category: once_f_duration
• File: extensions/flowgraph/nodes/vehicle/ai/followWaypoints.lua

Drives a vehicle along a list of navgraph waypoints using AI path following. Supports multiple laps and optional stopping at the finish. Duration state transitions from inactive → started → finished when all laps are complete.

Pin Schema

Input Pins

Output Pins

Internals

Key Methods

AI Command

ai.driveUsingPath({
  wpTargetList = aiPath,
  wpSpeeds = wpSpeeds,
  noOfLaps = lapCount,
  aggression = 1
})

• wpSpeeds: If stopAtFinish is false, sets a high speed (100) for the final waypoint.
• For multi-lap routes, the first waypoint is appended to the path to allow the AI to continue seamlessly.

Lap Tracking

1. Monitors vehicle proximity to the final waypoint.
2. When the vehicle enters the final waypoint's radius, increments lapsDone.
3. Uses lapFlag to prevent double-counting (resets when vehicle is closer to the first waypoint).
4. When lapsDone == lapCount, sets duration state to finished.

How It Works

1. On first execution, reads the navgraph path and sends ai.driveUsingPath().
2. Each frame during started state, checks vehicle position against waypoint positions.
3. Tracks lap completion by detecting entry into the final waypoint radius.
4. After all laps complete, transitions to finished duration state.
5. The finalWp output provides the name of the last waypoint for external monitoring.

Usage Example

-- Drive AI along a route:
-- navgraphPath = {"wp_001", "wp_002", "wp_003", "wp_004"}
-- vehId = aiVehicleId
-- lapCount = 1
-- stopAtFinish = true

-- Multi-lap race:
-- navgraphPath = route from Get Navgraph Route node
-- lapCount = 3
-- stopAtFinish = false (keep speed through finish)

-- Chain with route planning:
-- Get Navgraph Route → navgraphRoute → AI Follow Waypoints navgraphPath

Key Dependencies

• ai.driveUsingPath() - AI waypoint-based path following
• map.getMap().nodes - navgraph node data for position/radius checks

See Also

• AI Parameters (Flowgraph Node) - Related reference
• AI Arrive (Flowgraph Node) - Related reference
• AI Chase (Flowgraph Node) - Related reference
• FlowGraph Guide - Guide