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

Openplanet doesn't work

The usual suspect is because you're missing the 64 bit version of the Visual Studio C++ runtime. You can download it here. 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.

In the rare case that installing the runtime didn't work for you, there can be many causes, but the most common ones are:

  • Openplanet installed to the wrong instance of Trackmania. (This sometimes happens if you have the game through Epic Games Store!) See below for details on how to find the right install path.
  • 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 or firewall software.
  • Interfering overlays, such as ReShade, MSI Afterburner, Overwolf, Geforce Experience, etc.
  • A corrupt installation of Openplanet.

You can try turning off some of these interfering programs on your computer before starting ManiaPlanet, which might solve the problem.

Sometimes Trackmania (2020) might be installed twice by Uplay and Epic Games Launcher. In that case, check where Openplanet has been installed and run that instance instead or reinstall Openplanet to the directory, where the usually launching Trackmania has been installed to.

Note: You can double-check where the used Trackmania instance is located: Once Trackmania is started, open the task manager and right-click Trackmania and select to open its file path.

Another reason for this could be ManiaPlanet is blocking Openplanet temporarily. This can happen in circumstances where Openplanet has been proven to cause issues in ManiaPlanet such as instability. If this is the case, you can find status updates about it on Discord or the ManiaPlanet forums.

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 ManiaPlanet installation directory. If it does, 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 looks 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 logfile at all, check if there's a dinput8.dll file next to ManiaPlanet.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 logfile 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 ManiaPlanet:

TrackMania Turbo crashes sometimes

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

Linux compatibility

Openplanet for Trackmania (2020) seems to have problems starting right now under Wine. This is due to a problem with the game's DRM. I might work on resolving this at some point, but I can't guarantee a fix right now.

Openplanet for Maniaplanet is reported to work perfectly fine with Wine. To make it run properly, open winecfg and add dinput8 to the list of overrides under the Libraries tab, so that it's listed as a "native, builtin" library. If you start the game now, it should work!

If you're playing on Steam using Proton, you'll have to follow some different steps. Right click the game in Steam and go to Properties. Select Launch Options, and type in: WINEDLLOVERRIDES="dinput8=n,b" this will make the game start with the hook ready to be loaded.

You will probably also need to install the VC runtime into Proton's game wineprefix. To do that, you can either use Protontricks, or do something like the following:

# Change the AppID 228760 (TM2 Canyon) if needed
export WINEPREFIX=~/.steam/steam/steamapps/compatdata/228760/pfx

# Change the Proton version 5.0 if needed
export WINEPATH="~/.steam/steam/steamapps/common/Proton 5.0/dist/bin/wine64"

wine ~/Downloads/VC_redist.x64.exe

Note 1: If you install the VC redist in Proton's game wineprefix, you'll likely have to re-do it again when the game updates on Steam.

Note 2: I don't officially provide support for Linux/Wine, but I'm willing to help troubleshoot if you run into any issues.

Edited 38 days ago by