Quickrace Setup

Reference for extensions/util/trackBuilder/quickraceSetup.lua. Loads a saved track and sets up checkpoints/vehicle positioning when a quick race scenario starts.

Exports

Internals

• Uses extensions['util_trackBuilder_splineTrack'] to access the spline track system.
• On scenario load:
  1. Calls splineTrack.unloadAll() to clear previous track data
  2. Calls splineTrack.load(name, true, true, true) to load the track by name
  3. Calls splineTrack.addCheckPointPositions(reverse) to create waypoint checkpoints
  4. Calls splineTrack.positionVehicle(reverse) to place the player car at the start
• The done flag prevents re-loading on subsequent calls within the same mission.
• Track name comes from sc.track.customData.name; reverse flag from sc.track.reverse.

How It Works

This is a thin glue module that bridges the scenario system with the track builder. When a quick race scenario loads, it triggers the full track builder pipeline (load → checkpoints → vehicle placement).

-- Triggered automatically by the scenario system
-- sc.track.customData.name = "myTrack"
-- sc.track.reverse = false
quickraceSetup.onScenarioLoaded(scenarioData)

Additional Exports

• M.onClientStartMission - (undocumented)
• M.onScenarioLoaded - (undocumented)

See Also

• Track Builder - Basic Borders - Related reference
• Track Builder - Basic Centers - Related reference
• Track Builder - Border Wall Mesh - Related reference
• Game Engine Overview - Guide