Docs / Race Control
Troubleshooting
What to check when the self-test fails, commands don't arrive, a screen stays silent or an overlay stays empty.
Still stuck? In race control, Report an issue sends your note with the session’s state. Or write to support@pacelaps.com.
The self-test fails
Left-click the agent’s icon: the status window names the step that failed.
| The agent says | Do this |
|---|---|
| iRacing isn’t running or telemetry is off | Start iRacing and load the session. In iRacing’s app.ini, irsdkEnableMem must be 1 (the default). |
| Not in a session | Join the session in iRacing first, then Activate. |
| Not a league session and no league selected | A hosted session: enter your league id in the agent’s Settings. |
| League … is not registered | Register the league in Race Control, or check the league id. |
| The operator is not a steward of the league | Pair the agent with the account of one of the league’s stewards. |
| The server did not answer the clock pings | Check the internet connection, and that no firewall blocks the agent. |
| No cars in the session | Wait until the session has loaded, then Activate again. |
| Not an admin in this session | Get session admin rights from the league, or keep the agent as view only (replays only). |
| A key binding would fire while typing | Move chat macros and controls off plain keys (letters, digits, #, + and space). |
No reply to !help in chat |
Check your session admin rights. If iRacing runs as administrator, start the agent as administrator too. |
Agents stay ready, no session
- League session: a session from an earlier race may still be open. Close it on the league’s overview with Close session.
- Hosted session: a steward opens it first with New session, and the agent needs your league id in its Settings.
Commands don’t arrive in iRacing
- Race control’s Live card shows each command and what iRacing did with it.
- Check that an agent is in the session (green icon) and that race control’s header shows an executor.
- Use borderless windowed mode in iRacing.
- If commands keep failing, untick Type without bringing iRacing to the front in the agent’s settings and Activate again.
The agent’s icon is red
Hover over the icon to see why. If Race Control can’t be reached, there is nothing to do: the agent sends what it collected once the connection is back.
No sound on the driver page
- Press Enable sound on the driver page once. Browsers only play sound after you’ve clicked a page.
- Check the volume, and the mute switch on phones.
The overlay stays empty in OBS
- The banner overlay is empty between calls. That’s how it should look; a call appears on top of your stream.
- New overlay URLs and Turn off stop the old URLs. Copy the current URL from your driver page into OBS.
- To hear the banner’s sound in your stream, tick Control audio via OBS in the browser source.
A screen shows calls late
Race control’s Drivers’ screens card lists late screens. Usually it’s the screen’s connection. If many screens are late, raise Synchronized display lead in Settings: calls then go out earlier, and every screen still shows them at the same moment.