Sim Hub User Help

SimHub – Game configuration & troubleshooting (simple guide)

1. Manual game configuration

Some games need extra steps so SimHub can read their telemetry.

  • Open SimHub

  • Go to the Games tab

  • Select your game

  • If that game needs setup, SimHub will show instructions directly there (what file to edit, what plugin to enable, etc.).

Follow those in-app instructions first. They’re always written for PC versions of the games.

2. Automatic game configuration

For some games, SimHub can set things up for you.

If SimHub detects the game is installed and it supports auto-config, you’ll see a message like:

“Install plugin / Configure game”

Click that button and let SimHub do the changes for you (it will install plugins or change config files as needed). It may also change custompluginvariables.json  file

3. Consoles (Xbox / PlayStation) – important notes

  • SimHub is a PC app. You must have a PC running SimHub.

  • Consoles send telemetry over the network to your PC.

To connect a console game to SimHub:

  1. Follow the normal manual instructions for that game.

  2. Wherever the instructions say to use 127.0.0.1 (localhost), replace it with your PC’s local IP address (for example 192.168.0.12).

    • See: “How to find your computer local IP”.

  3. Make sure your firewall allows incoming traffic on the ports that game uses.

  4. All general troubleshooting tips below still apply.

Console games known to work (no guarantee):

  • Forza Motorsport 7

  • Forza Horizon 5 (not working on Xbox Series X due to game bug)

  • F1 games with UDP telemetry

  • Project CARS 2 (UDP mode)

  • Gran Turismo 7 and GT Sport on PS4/PS5

Troubleshooting

4. Check if SimHub is actually connected

  1. Start your game and enter a race (not just menus).

  2. Alt-Tab to SimHub:

    • At the top, SimHub should show “Game connected” when the telemetry is working.

    • Many games only show as connected once you are on track, not in menus.

If it doesn’t say “Game connected”, continue with the checklist.

5. General troubleshooting checklist

Work through these items one by one:

  1. PC vs console

    • Instructions in SimHub are written for PC.

    • If you’re on console, remember to:

      • Replace 127.0.0.1 with your PC’s local IP.

      • Open the firewall for incoming UDP/TCP traffic.

  2. Only counts when in session

    • Some games (Assetto Corsa, Codemasters F1, etc.) only send telemetry when you are in a race / on track, not in menus.

  3. Other telemetry tools

    • Avoid running multiple UDP telemetry / dash apps at the same time (SimHub, other dashboards, motion software etc.).

    • For games like F1 or Forza, UDP traffic can’t always be shared easily. See SimHub’s “Sharing UDP data with other applications” if you really need multiple apps.

  4. Game legality

    • Cracked / non-legit versions often don’t send telemetry correctly.

    • Steam / official store versions are strongly recommended.

  5. Restart everything

    • Reboot:

      • Your PC

      • Your router / modem

    • Then try again.

  6. Antivirus / firewall

    • Antivirus and firewalls can block telemetry.

    • Temporarily disable antivirus/firewall and restart:

      • SimHub

      • The game

    • If it suddenly works, you’ll need to add proper exceptions later.

  7. Run SimHub as admin

    • Some games (or launchers like Steam / Content Manager) start the game as administrator.

    • If the game runs as admin and SimHub does not, SimHub may not see the telemetry.

    • In SimHub Settings, enable “Run SimHub as administrator”.

  8. Xbox Game Pass versions

    • Game Pass versions sometimes have telemetry locked.

    • For Forza titles, use the Windows 8 AppContainer Loopback Utility to allow local network communication.

  9. VPN software

    • VPNs can capture or block UDP traffic.

    • Disable or uninstall VPN software temporarily and test again.

  10. Change the UDP port (UDP games like F1 / Forza / Dirt, etc.)

  • With the game closed, go into SimHub and:

    • Change the UDP port for that game (for example to 29000).

    • Let SimHub re-configure the game automatically, or update the game settings manually.

  • Then start the game again and test.

6. Game-specific notes

Assetto Corsa (PC)

  • Some mods can break AC’s shared memory.

    • Test using official Kunos cars and tracks first.

  • Some launchers (like Content Manager) can start AC as administrator. In that case:

    • Run SimHub as administrator too.

  • If opponents don’t show on the map or leaderboard:

    • Make sure the CrewChief plugin is installed and enabled in AC settings.

  • Content Manager is only supported when using the “Official” or “AppId” start modes. Other modes may modify game files and break detection.

    • If files are corrupted, use Steam’s Verify / Repair function for AC.

iRacing

SimHub reads iRacing’s memory telemetry. Make sure it’s enabled:

  • Open:
    Documents\iRacing\app.ini

  • In the [Misc] section, set:

[Misc]
...
irsdkEnableMem=1      ; enable memory based telemetry
irsdkLog360Hz=0       ; Log some telemetry at 360 Hz rather than at 60 Hz
...

  • irsdkEnableMem must be 1.

  • irsdkLog360Hz should be 0 for normal use.

Codemasters games (F1, Dirt, Grid, etc.)

  • Some other apps edit the hardware_settings_config.xml file for their own telemetry.

  • In that case, you may need to give SimHub its own UDP port.

Config file location (example path):

{Documents}\My Games\{GameName}\hardwaresettings\hardware_settings_config.xml
Example:
C:\Users\YourName\Documents\My Games\F1 2017\hardwaresettings\hardware_settings_config.xml

If another app is using the default port:

  1. Change the UDP port in SimHub for that game.

  2. Update the game’s UDP settings (either in-game menus or by editing the XML).

  3. Make sure only one app is listening on that port.

The page shows example XML for:

  • DiRT 4

  • DiRT Rally

  • DiRT Rally 2.0

  • F1 2015

  • F1 2016

  • Grid Autosport

(Your version will look similar—just check IP, port, and “enabled=true”.)

Forza Horizon 5 / Forza Horizon 4 / Forza Motorsport 7

  • Non-legit versions of Forza will not work.

  • Forza Horizon “Steam edition” has broken telemetry – only the Windows Store version is supported.

  • Forza uses UDP, so all the general UDP tips apply (ports, firewall, VPN, etc.).

Extra requirement for Windows Store versions:

  1. Install the Windows 8 AppContainer Loopback Utility.

  2. Run the utility.

  3. Find Forza Horizon 4 / Forza Horizon 5 / Motorsport 7 in the list.

  4. Tick the checkbox for the game and click Apply.

If the utility shows a serious error, it usually means Windows networking is corrupted. On that wiki they say the only reliable fix they found is a Windows reinstall.

Project CARS

  • Project CARS’ UDP telemetry cannot be shared between apps.

  • SimHub uses UDP for things like leaderboard and advanced info.

  • If another tool is already using the Project CARS UDP channel, SimHub may not receive anything.

rFactor 2

If SimHub can’t automatically enable the plugin:

  1. Go to:
    ...\steamapps\common\rFactor 2\UserData\player\CustomPluginVariables.JSON

  2. Make a backup copy, then delete the original file.

  3. Start rFactor 2 again so it can generate a fresh CustomPluginVariables.JSON.

  4. If the file is not recreated:

    • Download the default file from: CustomPluginVariables.zip (SimHub wiki link).

    • Copy it into the UserData\player folder.

  5. Then try SimHub’s automatic setup again.

DiRT 3

  • Telemetry works natively only on DiRT 3 GFWL Edition.

  • DiRT 3 Complete Edition has broken telemetry and may crash at start/end of race.

Fixes mentioned:

  • Community fix: DiRTTelemetryErrorFix (GitHub project).

  • Permanent patch: Dirt3TelemetryFixPatcher.zip from SimHub’s site.

ETS2 / ATS (Euro Truck Simulator 2 / American Truck Simulator)

  • The telemetry plugin only works with the 64-bit game version.

    • In Steam, make sure you launch the x64 version and make it default.

  • At game startup you should see an SDK warning:

    • Press OK, do not disable it, or the plugin won’t run.

  • Install Visual C++ Redistributable 2012 x64 (VS2012):
    The link in the wiki goes to Microsoft’s official download page.

  • Other telemetry apps using a forked plugin can conflict — remove them if SimHub won’t connect.

  • Avoid beta versions of the games; some betas break the telemetry plugin.

GT7 / GT Sport (PS4 / PS5)

  • Open your firewall for these UDP ports on your PC:

    • GT7: 33739 and 33740

    • GT Sport: 33339 and 33340

  • If SimHub still doesn’t connect after you start a race:

    1. Open your console’s network settings and note its IP address.

    2. In SimHub’s game settings for GT7/GT Sport, enter your console’s IP manually.