Documentation

Troubleshooting

Below are some common issues you might be having, and ways to solve them.

Openplanet doesn't work

Almost all issues are caused by the following two things - check these first:

  1. The usual suspect is because you're missing the 64 bit version of the Visual Studio C++ runtime. Do not skip this! Don't assume you already have this installed on your system! If Openplanet doesn't work, this is very likely the cause. Download it from here - you can find the runtime elsewhere online but downloading from this link ensures that you don't accidentally install a different unsupported version.

  2. If you've installed Trackmania (2020) through Epic Games, there's a good chance it installed the game twice (once in Epic, once in Ubisoft Connect). Openplanet needs to be installed in the same directory as the game you're actually running. You can double-check where the used Trackmania instance is located: Once Trackmania is started, open the task manager, right-click Trackmania.exe and select to open its file location.

In the rare case that neither of those apply to you, there can be a variety of other causes for issues, but the most common ones are:

  • Using an older unsupported version of Windows, such as Windows 7 or older. (Consider upgrading, as Microsoft dropped support for Windows 7!)
  • Interfering third-party applications, such as anti-virus, firewall software or overlays such as ReShade, MSI Afterburner, Overwolf, Geforce Experience, etc. - you can try turning off some of these interfering programs on your computer before starting Trackmania, which might solve the problem.
  • A corrupt installation of Openplanet.

If none of the above seem to apply, you can start doing some more technical troubleshooting. First of all, check if there is an OpenplanetHook.log file in your Trackmania installation directory. If there is, make sure there are no errors at the end of the file. A successful startup might look like this:

[22:35:12] Finding libs path
[22:35:12] Updating PATH to add: 'D:\Games\Trackmania\Openplanet\Lib'
[22:35:12] Attaching DLL to: 'D:\Games\Trackmania\Trackmania.exe'
[22:35:12] Module handle: 00007FF9E2A50000
[22:35:14] DirectInput8Create

A failed startup could look like this:

[22:36:05] Finding libs path
[22:36:05] Updating PATH to add: 'D:\Games\Trackmania\Openplanet\Lib'
[22:36:05] Attaching DLL to: 'D:\Games\Trackmania\Trackmania.exe'
[22:36:05] Failed to load Openplanet module, error 126
[22:36:05] Module handle: 0000000000000000
[22:36:05] DirectInput8Create
[22:36:05] Openplanet.dll is not loaded yet!
[22:36:05] Couldn't find DinputInit function!

From here you could look up the error or ask for more advice on Discord. If there is no log file at all, check if there's a dinput8.dll file next to Trackmania.exe. If there is not, your installation is corrupt and you should try re-installing Openplanet. If there is, there's probably some anti-virus software blocking Openplanet from loading.

Next, you should check your main Openplanet log file located at: C:\Users\<Your Username>\OpenplanetNext\Openplanet.log, where OpenplanetNext could also be Openplanet4 or OpenplanetTurbo, depending on the game. Check if there are any obvious errors there, and ask for help if you can't figure it out.

You can ask for additional help on Discord.

Openplanet compatibility

Openplanet is compatible with a variety of flavours of Trackmania:

TrackMania Turbo crashes

Some crashes in Turbo have been linked to the Ubisoft Connect overlay. This can be disabled from the Ubisoft Connect client. Go to Settings -> General and untick both "Enable in-game overlay for supported games" and "Display FPS counter in game".

Linux compatibility

For information about compatibility on Linux (via eg. Wine), check this page.


Page updated 3 months ago by tooInfinite