Drift Goal

A scenario goal that calculates drift scores from vehicle angle and speed, supports combo chains, and triggers win/fail based on minimum drift score thresholds.

Internal State

Public API

Goal JSON Schema

{
  "goal": {
    "drift": {
      "minDrift": 500,
      "maxDrift": 10000,
      "timeAllowance": 60,
      "msg": "scenarios.drift.customWin",
      "failMsg": "scenarios.drift.customFail"
    }
  }
}

Scoring Algorithm

angleBonus = distance(directionVector, normalizedVelocity) × 10
speedBonus = velocity.length × 0.15
driftBonus = floor(angleBonus × speedBonus)

Filters

• angleBonus clamped to 2–10 (excludes spinouts > 10, shallow drifts < 2)
• speedBonus must be > 1 (excludes very low speed)
• Combo multiplier: Chaining drifts within a cooldown grace period increases (combo + 1)×

Drift Descriptions

How It Works

1. Each tick, computes angle between direction and velocity vectors
2. Multiplies by speed to get instantaneous drift points
3. Accumulates into total driftScore with combo multiplier
4. Grace period (1s cooldown) allows chaining drifts into combos
5. On race result or time expiry, calls sessionEnd to finish scenario
6. Score is compared against minDrift to determine pass/fail

Usage Examples

-- Scenario JSON: score at least 1000 drift points
{
  "vehicles": {
    "scenario_player0": {
      "goal": {
        "drift": {
          "minDrift": 1000,
          "maxDrift": 50000,
          "timeAllowance": 120
        }
      }
    }
  }
}

Key Notes

• Uses map.objects for vehicle velocity and direction data
• Cooldown between drifts is 1 second (decrements by 0.25/tick)
• Messages displayed via helper.realTimeUiDisplay
• Score clamped to maxDrift on session end
• Re-tracks vehicle if map object data is missing

See Also

• Scenario Bus Driver - Bus Route Scenario Logic - Related reference
• Scenario Damage Goal - Damage-Based Win/Fail Condition - Related reference
• Scenario Demolition Derby - Last Vehicle Moving Wins - Related reference
• Scenario System Guide - Guide