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 ThresholdDetection Incident Points, threshold, iReporter captures that car's details and makes them available as message variables.

• Crash ThresholdDetection (points)Incident 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.box Behaviourwhen dependsa oncrash is active.
• Crash Capture Detection Logging — when ticked, every crash detection event is written to the timeoutlog settingfile —as seea above.[Crash Capture Detection Event] entry, recording the car number, driver name, direction, and lap. This is separate from button press logging and lets you review every detection regardless of whether a button was pressed.

When a crash is active, buttons withthat crashhave fallbacka messagesCrash Fallback message configured will usesend thosethat messagesfallback inmessage preferenceif tothe theirbutton normalis messages.pressed and no crash is currently detected.

Incident Capture

Works identically to Crash Capture but for lower-severity incidents. IfAn aevent car'sis captured as an incident only when the incident point delta meets or exceeds the Incident Detection Points threshold butand doesis notstrictly reachbelow the Crash Threshold,Detection itIncident isPoints threshold. This ensures that crash-level events are never captured as anincidents, incident —and the two eventsdetections are always mutually exclusive for any single detection.exclusive.

• Incident Detection Points — minimum incident delta to trigger incident capture. Should be set lower than the Crash Detection threshold.
• 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.
• Incident Capture Logging — when ticked, every incident detection event is written to the log file as an [Incident Capture Detection Event] entry. Crash-level events will never appear here.

TopBlue XFlag Cars ApproachingHelper

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. This helps you anticipate and respond to blue flag situations before they become an issue.

• Top [ ] Cars Approaching Within [ ] seconds behind — configure how many leading cars to monitor (e.g.and how close they need to be to trigger the alert. For example, setting Top 10 =and 30 seconds will activate the LED when any of the top 10).10 Defaultcars is 10.
• Approach (s) — gap in seconds at which the alert triggers. If a leader isare within this many30 seconds behind you,you theand LEDat activates.least Defaultone isfull 30.lap ahead.
• Approach LED — LED colour to illuminate on your button box when a top-Xqualifying carleader is approaching.

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