Race Start Position

Object class representing a spawn/recovery position in a race path. Stores position and rotation, and provides methods to calculate vehicle placement transforms and teleport vehicles.

Constructor

local StartPosition = require('/lua/ge/extensions/gameplay/race/startPosition')
local sp = StartPosition(race, name)

Public API

Internals

How It Works

1. calculateVehiclePosRot() uses the vehicle's OOBB (oriented bounding box) to compute a precise spawn transform:
   • Extracts the front-left, front-right, back-left corner positions from the OOBB
   • Computes a local offset from the vehicle's position to the front-left corner
   • Maps this offset into the start position's coordinate frame
   • lowPrecision mode places the vehicle 2m behind and 0.5m above (for first-frame spawn when OOBB isn't ready)
2. moveResetVehicleTo() calls calculateVehiclePosRot() and either directly sets position/rotation (with repair) or uses spawn.safeTeleport (without repair)
3. setToVehicle() captures a vehicle's current position/rotation, using terrain height for the center point

Usage Examples

-- Create a start position at a specific location
local sp = StartPosition(path, "Default Start")
sp:set(vec3(100, 200, 50), quatFromDir(vec3(0, 1, 0), vec3(0, 0, 1)))

-- Teleport player vehicle to this start
sp:moveResetVehicleTo(playerId)

-- Capture current vehicle position as a start position
sp:setToVehicle(playerId)

Notes

• Used for: default starts, reverse starts, rolling starts, and recovery points at pathnodes
• The path references start positions by ID fields: defaultStartPosition, reverseStartPosition, rollingStartPosition, rollingReverseStartPosition
• Debug drawing renders a colored arrow-like shape showing position and orientation
• repair parameter defaults to true; when false, uses safe teleport without resetting vehicle damage

See Also

• Race Pacenote - Related reference
• Race Path - Related reference
• Race Pathnode - Related reference
• Gameplay Systems Guide - Guide