Road Section Penalty Keeper

Class-based tracker for rally liaison route deviation penalties. Monitors route recalculation frequency and applies escalating time penalties when the driver deviates from the prescribed road section route too often.

Constructor

local RoadSectionPenaltyKeeper = require('gameplay/rally/loop/roadSectionPenaltyKeeper')
local keeper = RoadSectionPenaltyKeeper(manager)

Public API

Internals

Configuration Constants

Penalty Escalation

Penalty Data Structure

{
  type = "liaison_deviation",
  amount = number,       -- escalating penalty amount
  data = {
    violationNumber = number,
    recalcCount = number
  }
}

How It Works

1. External code calls registerRecalc() each time the route is recalculated (player went off-route)
2. onUpdate() runs on a 10-second interval (using manager.clock)
3. If recalc count exceeds threshold (5) and violations are under max (1), calls manager:recordRouteRecalcPenalty() with escalating penalty
4. After creating a penalty, resets recalc counter to begin a new monitoring window

Usage Example

local RoadSectionPenaltyKeeper = require('gameplay/rally/loop/roadSectionPenaltyKeeper')
local keeper = RoadSectionPenaltyKeeper(loopManager)

-- When route recalculates (player deviated)
keeper:registerRecalc()

-- Called each frame by the loop manager
keeper:onUpdate()

-- Reset when entering a new road section
keeper:reset()

See Also

• Rally Loop Penalties - Related reference
• Rally Attempts - Related reference
• Rally Event Log - Related reference
• Gameplay Systems Guide - Guide