Race CP Reached (Flowgraph Node)

Overview

• Node Name: Race CP Reached
• Category: repeat_instant
• File: extensions/flowgraph/nodes/timetrials/onRaceCheckpoint.lua

Fires an impulse when the player drives through a race checkpoint. Tracks checkpoint index and lap count.

Pin Schema

Output Pins

Legacy Pin Mapping

Behavior

• init() - Initializes enterFlag and lap counter. Disables clearOutPinsOnStart.
• _executionStarted() - Resets lap to 1 and clears enter flag.
• onRaceWaypointReached(data) - Event handler: sets vehicle ID, checkpoint index, updates lap count via data.lapDiff, and sets the enter flag.
• work() - Outputs the checked impulse if the flag was set, then clears it.
• onScenarioRestarted() - Resets state via _executionStarted().

How It Works

1. Place this node in a race/time-trial flowgraph.
2. When the player hits a checkpoint, onRaceWaypointReached fires.
3. The checked impulse goes high for one frame.
4. Use index to identify which checkpoint, lap for the current lap.

-- Event data structure:
-- data.vehId  = vehicle ID
-- data.cur    = checkpoint index
-- data.lapDiff = lap increment (0 or 1)

-- Connect: checked → [Display Checkpoint UI]
-- Use index and lap for scoreboard updates

Key Dependencies

• onRaceWaypointReached - Flowgraph event from the race system
• onScenarioRestarted - Flowgraph event for race restart

See Also

• Race Complete (Flowgraph Node) - Related reference
• Race Config (Flowgraph Node) - Related reference
• Race Restarted (Flowgraph Node) - Related reference
• FlowGraph Guide - Guide