Drift Zone Bounds

Reference for gameplay_drift_bounds, which detects whether the drift vehicle is inside defined zone boundaries and optionally draws them.

Overview

Loads site zone data from a file, checks the player vehicle's position against zones each frame, and flags out-of-bounds state. The drift display system uses this to show "Out of bounds" warnings and the scoring system uses it to freeze point accumulation.

Exports

Internals

How It Works

-- Set up bounds from a sites file (typically called by driftSpots or mission setup)
gameplay_drift_bounds.setBounds("/levels/west_coast_usa/driftSpots/spot1/bounds.sites.json", false)

-- Each frame, detectOutOfBounds() checks:
local zones = sites:getZonesForPosition(gameplay_drift_drift.getVehPos())
if #zones == 0 then
  isOutOfBounds = true  -- not inside any zone
end

-- Visual feedback: zones pulse red when out of bounds
-- Normal zones draw in white with filled interiors

Key Behaviors

• Uses gameplay_sites_sitesManager.loadSites() to parse zone geometry
• Zone drawing flashes red using sin(runtime*2) for visibility
• Out-of-bounds state is consumed by gameplay_drift_general.checkFrozen() to freeze scoring
• drawBounds defaults to true if not explicitly set to false in setBounds
• Only checks if gameplay_drift_drift.getVehId() ~= -1

See Also

• drift/destination - Race Path & Wrong-Way Detection - Related reference
• drift/display - Drift UI & HUD Management - Related reference
• drift/drift - Core Drift Detection Engine - Related reference
• Gameplay Systems Guide - Guide