Route Position

Overview

• Node Name: Route Position
• Category: once_instant
• File: extensions/flowgraph/nodes/util/routePosition.lua

Gets a position and direction along a navgraph route at a specified distance ahead. Useful for placing objects, triggers, or checkpoints along a pre-computed route.

Pin Schema

Input Pins

Output Pins

Internals

Key Methods

Route Object

Uses gameplay/route/route module internally. A new route instance is created on reset. The route is set up via setupPathMultiWaypoints() and then stepAhead() returns the road segment and interpolated position.

How It Works

1. On reset, instantiates a fresh route object from gameplay/route/route.
2. When executed, calls route:setupPathMultiWaypoints() with the input waypoint array.
3. Calls route:stepAhead(distance) to find the position at the given distance.
4. Outputs the interpolated position, direction vector (normalized), and the two navgraph node names of the containing segment.

Usage Example

-- Get position 50 meters ahead on a route:
-- navgraphRoute = {"wp_001", "wp_002", "wp_003", ...}
-- distance = 50
-- Output: pos = {x, y, z}, dirVec = {dx, dy, dz}, n1 = "wp_002", n2 = "wp_003"

-- Chain with Get Navgraph Route:
-- 1. routePointToPoint → navgraphRoute
-- 2. routePosition(navgraphRoute, distance) → pos, dirVec

-- Place a checkpoint 100m ahead:
-- distance = 100 → use pos output for checkpoint placement

Key Dependencies

• gameplay/route/route - route calculation module
• map.getMap().nodes - navgraph node positions for direction calculation

See Also

• Route Distance (Flowgraph Node) - Related reference
• Closest Road (Flowgraph Node) - Related reference
• Custom Lua (Flowgraph Node) - Related reference
• FlowGraph Guide - Guide