Staged Countdown Test

Class-based test mode implementation for the staged countdown system. Simulates rally epoch timing and scheduled event scheduling without requiring a full rally loop manager. Used for testing countdown behavior in isolation.

Constructor

local StagedCountdownTest = require('gameplay/rally/loop/stagedCountdownTest')
local test = StagedCountdownTest()

Public API

Internals

State

Environment Time Conversion

Same formula as rallyLoopManager:

local timeIn24 = tod.time * 24
local adjustedHours = (timeIn24 + 12) % 24  -- noon = 0 in tod system
self.environmentStartTimeSecs = adjustedHours * 3600

Scheduling Logic

1. Computes current wall clock: environmentStartTimeSecs + epoch
2. Finds next minute boundary: math.ceil(currentWallClock / 60) * 60
3. If less than 15 seconds until that boundary, skips to the minute after
4. Converts back to epoch: targetWallClock - environmentStartTimeSecs

Rescheduling

When called by the countdown node after a reschedule request:

1. Converts old scheduled time to wall clock
2. Finds next minute boundary after old time
3. Adds slotSizeMinutes * 60 seconds
4. Converts back to epoch
5. Marks any warning times that are already in the past as triggered

How It Works

1. On init, reads core_environment.getTimeOfDay() to establish environment start time
2. Calculates first scheduled event at the next comfortable minute boundary
3. External code advances test.epoch each frame
4. Countdown node reads test.scheduledEventTime and test.epoch to determine countdown state
5. If reschedule is needed (vehicle not staged), calls reschedule() to push to next slot

Usage Example

local StagedCountdownTest = require('gameplay/rally/loop/stagedCountdownTest')
local test = StagedCountdownTest()

-- Simulate time advancement
test.epoch = test.epoch + dtSim

-- Check if event is approaching
local timeUntil = test.scheduledEventTime - test.epoch

-- Reschedule if needed
local ok, newTime = test:reschedule(1, 0, 3, {10, 5, 3}, {})

See Also

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