Skip to main content

iRacing Options

Overview

The iRacing Options section enables features that read live data directly from iRacing. Enable the iRacing Options checkbox to expand the section.

Message Text Limits

When enabled, message text boxes are limited to the iRacing in-game chat character limit (approximately 60 characters). A character counter is shown beside each message field. This prevents messages from being truncated when typed into the iRacing chat box.

Crash Capture

Monitors all cars on track for sudden increases in incident points. When a car receives incident points at or above the Crash Threshold, iReporter captures that car's details and makes them available as message variables.

  • Crash Threshold (points) — the minimum incident point delta in a single update that counts as a crash. Default is 4. Lower values will trigger more frequently.
  • Crash Timeout — how long the captured crash data remains active, controlled by a slider (0–60 seconds).
    • No Timeout (0) — crash data persists indefinitely until the next crash is detected and overwrites it. The LED will flash briefly (600ms) on capture to confirm detection, then turn off. Use this when you want the data always available regardless of how long ago the crash happened.
    • Timed (1–60s) — crash data is cleared after the specified number of seconds. The LED stays on for the full duration and turns off when the timeout expires.
  • Timeout LED — select a LED colour (None / RED / BLUE / GREEN / AMBER) to illuminate on your button box. Behaviour depends on the timeout setting — see above.

When a crash is active, buttons with crash fallback messages configured will use those messages in preference to their normal messages.

Incident Capture

Works identically to Crash Capture but for lower-severity incidents. If a car's incident delta meets or exceeds the Incident Detection Points threshold but does not reach the Crash Threshold, it is captured as an incident — the two events are mutually exclusive for any single detection.

  • Detection Points — minimum incident delta to trigger incident capture.
  • Incident Timeout — controls how long incident data remains active (0–60 seconds).
    • No Timeout (0) — incident data persists until the next incident overwrites it. LED flashes briefly (600ms) on capture to confirm, then turns off.
    • Timed (1–60s) — incident data cleared after the specified seconds. LED stays on for the full duration.
  • Timeout LED — LED colour while an incident is active.

Top X Cars Approaching

Tracks the top X cars by race position and alerts you when one of them is approaching from behind and is more than one full lap ahead of your position.

  • Top — how many leading cars to monitor (e.g. 10 = top 10). Default is 10.
  • Approach (s) — gap in seconds at which the alert triggers. If a leader is within this many seconds behind you, the LED activates. Default is 30.
  • Approach LED — LED colour to illuminate when a top-X car is approaching.

Note: The LED will ONLY activate when the approaching car is more than 1 full lap ahead. Cars on the same lap will never trigger the alert.

Back to top