AI Path from File

Overview

• Node Name: AI Path from File
• Category: provider
• File: extensions/flowgraph/nodes/vehicle/ai/scriptAI/pathFromFile.lua

Loads a ScriptAI path from a .track.json file and provides it as output data. Feed the output into "AI Follow Path from Data" to drive a vehicle along the path.

Pin Schema

Output Pins

Internals

Key Methods

Constants

How It Works

1. On init(), scans the tracks directory using FS:findFiles().
2. The editor displays a dropdown of available files (short names without path/extension).
3. On first work() call, lazily loads the JSON file via jsonReadFile().
4. Outputs self.loadedFile.recording as the path pin - an aiPath table with position/time data.

File Format

ScriptAI track files (.track.json) contain:

{
  "vehicle": "etk800",
  "levelName": "west_coast_usa",
  "recording": {
    "path": [
      {"x": 100.0, "y": 200.0, "z": 50.0, "t": 0.0},
      {"x": 101.5, "y": 201.2, "z": 50.1, "t": 0.5}
    ]
  }
}

Usage Example

-- Flowgraph chain:
-- [AI Path from File] → path → [AI Follow Path from Data] → flow → [Done]

-- Programmatic equivalent:
local data = jsonReadFile("/replays/scriptai/tracks/myTrack.track.json")
local path = data.recording
veh:queueLuaCommand('ai.startFollowing(' .. serialize(path) .. ')')

Key Dependencies

• FS:findFiles() - filesystem scan for track files
• jsonReadFile() - JSON file loader
• ScriptAI recording format ({path = [{x,y,z,t}, ...]})

See Also

• AI Follow Path from Data (Flowgraph Node) - Related reference
• Stored AI Path (Flowgraph Node) - Related reference
• Play ScriptAI Recording (Flowgraph Node) - Related reference
• FlowGraph Guide - Guide