Day Night Cycles

Use this when modifying game time behavior, timezone math, or twilight behavior in proofofcombat-server/constants/helpers.ts.

Key Constants

• DAY_NIGHT_CYCLE: Real-time duration for one in-game day/night cycle (4h in ms).
• TIMEZONE_COUNT: Number of radial timezones (24); do not hard-code 24 elsewhere.
• DAY_NIGHT_LENGTH: In-game day length (24h in ms).
• TIMEZONE_OFFSET: In-game hour offset per timezone (1h in ms).
• TWILIGHT_RADIUS: Fraction of radius designated as twilight around the map center.

Orientation

• Zone 0 aligns with the right (east) edge; indices increase counter-clockwise.
• Top (north) edge corresponds to timezone 18; bottom to 6; left to 12.
• Twilight covers the inner TWILIGHT_RADIUS fraction; twilight has offset 0.

Implementation Rules

• timestampLocationToGameTime:
  • Compute base in-cycle time: time = ((timestamp % DAY_NIGHT_CYCLE) / DAY_NIGHT_CYCLE) * DAY_NIGHT_LENGTH.
  • Add timezone offset: gameTime = time + offset * TIMEZONE_OFFSET.
  • Wrap to in-day time: adjustedTime = gameTime % DAY_NIGHT_LENGTH.
  • Return normalized fraction: (must be 0..1).