Script AI Manager
Editor window for managing scriptAI recordings across all vehicles - supports recording, playback, looping, save/load of track files, and real-time progress visualization.
Editor window for managing scriptAI recordings across all vehicles - supports recording, playback, looping, save/load of track files, and real-time progress visualization.
Public API
| Function | Signature | Description |
|---|---|---|
M.onEditorGui | () | Main GUI - vehicle list with record/play/stop controls and progress bars |
M.onEditorInitialized | () | Registers "Script AI Manager" window under Gameplay menu |
M.onWindowMenuItem | () | Shows the manager window |
M.onVehicleSwitched | (oldVehicle, newVehicle, player) | Updates active vehicle tracking |
M.onDrawDebug | (lastDebugFocusPos, dtReal, dtSim, dtRaw) | Renders recorded paths as 3D debug lines |
M.onVehicleSubmitRecording | (vehId, data) | Callback receiving recorded data from vehicle Lua |
M.onVehicleSubmitInfo | (vehId, data) | Callback receiving playback status from vehicle Lua |
M.onSerialize / M.onDeserialized | () / (data) | Session persistence for recordings and vehicle states |
M.getCurrentRecordings | () | Returns the current recordings table |
Per-Vehicle Controls
| Control | Description |
|---|---|
| Record | Starts recording vehicle movement via ai.startRecording() |
| Stop | Stops recording or playback |
| Play | Plays back a recording via ai.startFollowing() |
| Restart | Restarts playback from the beginning |
| Save | Saves recording to .track.json file |
| Load | Loads recording from disk |
| More | Loop toggle, debug toggle, start offset, start delay, reset |
Track File Format
{
levelName = "west_coast_usa",
vehicle = "pickup",
recording = { path = { ... }, ... },
version = 2,
startDelay = 0.0,
timeOffset = 0.0,
}Progress Visualization
- Real-time progress bar with two layers:
- Green: wall-clock time progress
- White: script time progress
- Sleeping state shown in red (during start delay)
- Per-vehicle debug path rendering with rainbow colors
Notes
- Track files stored in
/replays/scriptai/tracks/ - Supports
Play AllandStop Allfor synchronized multi-vehicle playback - Fast-forward mode uses
be:setPhysicsSpeedFactor(2) - Debug path rendering uses squared distance culling (100-200m based on camera distance)
See Also
- Editor AI Tests - Related reference
- Editor AI Visualization - Related reference
- Editor – Assembly Spline Tool - Related reference
- World Editor Guide - Guide
Script AI Editor
Full-featured editor for creating, editing, and executing scriptAI vehicle trajectories and camera paths - supports time-based and speed-based scripts, spline interpolation, drawing mode, recording, u
Sensor Configuration Editor
Editor for configuring vehicle sensor setups - supports Camera, LiDAR, Ultrasonic, RADAR, IMU, GPS, Ideal RADAR, Roads, Powertrain, and Mesh sensors with interactive placement, gizmo-based positioning