Below are some common issues you might be having, and ways to solve them.
The game doesn't start
You're likely 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.
After following the installer's instructions, you might have to restart your PC before it'll work.
The game works but Openplanet doesn't start/can't be accessed
Almost all issues are caused by the following things - check these first:
Are you playing in offline mode? Openplanet requires the game to be played in online mode to be able to check your access level and permissions. This might change in the future, but for now make sure Ubisoft Connect is not in offline mode, and the login procedure in the game's startup flow is successful.
Are you on a laptop and
F3doesn't seem to do anything? Try pressing
F3at the same time - laptops often have different primary actions bound to the function keys, so this might already be what you're looking for.
Otherwise, 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.
Restart your computer, especially right after installing the Visual Studio C++ runtime in the previous step.
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.exeand select to open its file location. Specifically if you've installed Trackmania (2020) through Epic Games (but also sometimes when only using Ubisoft Connect), there's a chance it installed the game twice (once in Epic, once in Ubisoft Connect).
In the rare case that none 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
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 works on one of my Trackmania installations, but not on the other
If you have multiple Trackmania installations (e.g. Steam and Ubisoft Connect), updating Openplanet can occasionally lead to issues with one of the two Openplanet installations.
- Start the Trackmania installation where Openplanet doesn't start correctly. An installer should pop up, telling you to update Openplanet. If it doesn't, you can manually download the latest version of Openplanet and run that instead.
- Follow the instructions in the installer, but pay special attention to the installation path. It may point to your other Trackmania installation, so installing the update wouldn't actually affect your currently running game. If necessary, change the path to the correct
- Install the update and restart your game. If Openplanet still does not work, there might be a deeper issue - check the top of the page and follow the instructions there to troubleshoot what's going wrong.
Openplanet starts but plugins can't be installed
If you can't seem to install any plugins, check your Openplanet logs (open the Logs window under the main Openplanet button in the top left of the overlay).
ScriptEngine PluginManager Unable to load plugin 'UltimateMedals' because the zip file doesn't exist!
If you see errors like these, it's very likely that this is caused by permission issues in your user folder.
In the Windows Explorer, navigate to
C:\Users, right-click your user's directory and open its Properties. Switch to the Security tab and make sure that your active user (or if that doesn't show up, the Authenticated Users entry) has full control over the directory.
Once that's done, restart Trackmania, and the problem should be fixed.
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".
For information about compatibility on Linux (via eg. Wine), check this page.