Side Marker

A three-object checkpoint marker with a curved base and two faded column pillars positioned on each side of the waypoint. Columns scale with distance for far-range visibility.

Class API (OOP via metatable)

Spawned Objects (3 total)

Mode Colors

How It Works

1. Side positioning: Columns placed at pos ± side * radius, where side = normal:cross(zVec)
2. Distance-based alpha: Fades from fadeNear (1m) to fadeFar (50m) with minAlpha of 0.25
3. Column scaling: Radius grows with distance * 0.03, height grows via inverseLerp(60, 180, distance)
4. Base scaling: Height clamps between radius and radius * 3 based on distance (10–40m range)
5. Camera rotation: Base and side normal rotate to face camera when beyond radius * 1.5
6. Column offset: Left/right columns offset by vec3(0, 0, -10) (below ground anchor point)
7. Color lerp: 0.3s transition for both pillar color and base color

Usage Example

local createMarker = require("scenario/raceMarkers/sideMarker")
local marker = createMarker(1)
marker:createMarkers()
marker:setToCheckpoint({
  pos = vec3(100, 200, 50),
  radius = 8,
  normal = vec3(0, 1, 0),
  fadeNear = 5,
  fadeFar = 60,
  minAlpha = 0.3
})
marker:setMode('default')

Key Notes

• Includes recovery mode (yellow) for recovery points
• Base alpha is half of column alpha (currentColor.w * 0.5)
• Uses pre-allocated vec3 locals for performance (playerPosition, scale, markerOffset)
• Column position has a -10 Z offset for the marker offset below the waypoint

See Also

• Race Marker: Attention - Floating Arrow Checkpoint Marker - Related reference
• Race Marker: Crawl Marker - Arrow + Flag + Column Checkpoint - Related reference
• Race Marker: Cylinder - Base + Cylinder Checkpoint Marker - Related reference
• Scenario System Guide - Guide