Message Variables Reference
Overview
Variables are placeholders wrapped in curly braces that are substituted with live iRacing data when a button is pressed. They can be used in any message field and in the Speak Text field.
If a variable is used in a message but has no current value, the entire message line is suppressed (or replaced by the fallback message if one is configured).
For full details on using conditionals such as {IF:CRASH}...{ENDIF}, see the Using Conditionals in Messages page.
Your Car
| Variable | Description |
|---|---|
{CAR#} | Your car number |
{CARTYPE} | Your car model / type |
{CARLAP} | Your current lap (with decimal fraction) |
{DRIVER} | Your driver name |
{FLAG} | Current flag colour (e.g. Green, Yellow, Red, Black, Checkered) |
Crash Variables
Available only when a crash is currently active (within the crash timeout window, or any time if No Timeout is set)window).
| Variable | Description |
|---|---|
{CRASHCAR} | Car number of the crashed car |
{CRASHNAME} | Driver name of the crashed car |
{CRASHDIR} | Relative direction of the crash ( |
{CRASHLAP} | Lap number at which the crash occurred |
Incident Variables
Available only when an incident is currently active (within the incident timeout window, or any time if No Timeout is set)window).
| Variable | Description |
|---|---|
{INCCAR} | Car number involved in the incident |
{INCNAME} | Driver name involved in the incident |
{INCDIR} | Relative direction of the incident |
{INCLAP} | Lap number at which the incident occurred |
Cars Around You
| Variable | Description |
|---|---|
{CARAHEAD} / {CARAHEAD1} | Car number of the 1st car ahead |
{CARAHEAD2} | Car number of the 2nd car ahead |
{CARAHEAD3} | Car number of the 3rd car ahead |
{NAMEAHEAD} / {NAMEAHEAD1} | Driver name of the 1st car ahead |
{NAMEAHEAD2} | Driver name of the 2nd car ahead |
{NAMEAHEAD3} | Driver name of the 3rd car ahead |
{CARBEHIND} / {CARBEHIND1} | Car number of the 1st car behind |
{CARBEHIND2} | Car number of the 2nd car behind |
{CARBEHIND3} | Car number of the 3rd car behind |
{NAMEBEHIND} / {NAMEBEHIND1} | Driver name of the 1st car behind |
{NAMEBEHIND2} | Driver name of the 2nd car behind |
{NAMEBEHIND3} | Driver name of the 3rd car behind |
{CLOSECAR1} | Closest car number (any direction) |
{CLOSECAR2} | 2nd closest car number |
{CLOSECAR3} | 3rd closest car number |
{CLOSENAME1} | Closest driver name (any direction) |
{CLOSENAME2} | 2nd closest driver name |
{CLOSENAME3} | 3rd closest driver name |
{GAPHEAD} / {GAPHEAD1} | Gap in seconds to 1st car ahead |
{GAPHEAD2} | Gap in seconds to 2nd car ahead |
{GAPHEAD3} | Gap in seconds to 3rd car ahead |
{GAPBEHIND} / {GAPBEHIND1} | Gap in seconds to 1st car behind |
{GAPBEHIND2} | Gap in seconds to 2nd car behind |
{GAPBEHIND3} | Gap in seconds to 3rd car behind |
{TOPX} | Comma-separated list of top X race leaders by position (e.g. #3, #11, #27) |
Timing Controls
| Variable | Description |
|---|---|
{PAUSE:N} | Insert a pause of N milliseconds between message segments |
Skip Marker — ~
Enter ~ (tilde) alone in a message slot to skip that slot entirely. No keystrokes are sent.
Conditional BlocksStatements
WrapiReporter partsupports a simplified conditional syntax that lets you include or suppress parts of a message inbased aon live race data. The syntax uses parentheses rather than curly braces, keeping it visually distinct from variables.
For full documentation including AND / OR compound conditions, examples, and the current supported condition sotypes, it is only included whensee the conditiondedicated is true. The closing tag is always {ENDIF}.page:
{IF:CONDITION}text shown when true{ENDIF}
Multiple conditions can appear in the same message. See the Using Conditionals in Messages → page for full details, all supported conditions, and worked examples.