Skip to content
TwistedJenius edited this page Oct 26, 2020 · 2 revisions

Issues happen! Sometimes it's a crash, other times it's a configuration problem. This page collects some of the more common issues you may run into while using Launchpad, and suggested fixes.

If this page has opened automatically for you, Launchpad has most likely crashed on startup. If you're on Windows, it's almost guaranteed to be missing GTK libraries. See the first answer down below.

Launchpad crashes on startup

In almost all cases, this is due to missing system libraries. Launchpad requires a recent version of Mono on Linux and Mac, and .NET 4.6 on Windows.

Furthermore, it also requires the GTK+ and GTK# libraries on all platforms. On Linux and Mac, these are usually bundled with Mono and should require no further installation. On Windows, you must install the GTK#2 libraries, available here. A reboot may be required after the libraries have been installed.

If you are experiencing the above issue, and you are not a developer, please report it to the developer of the game or software you are using. They must bundle the above installer with their own for a smooth experience.

Launchpad fails to download the game

If the download fails completely, you may not have enabled the distributions of files for this directory. Make sure that you have placed a ".provides" file in the platform directory as instructed in the quickstart guide. If you are sure that your files are correctly uploaded, make sure that the server allows anonymous accounts to read files from the server.

Launchpad fails to patch the game

Verify that you've uploaded all of the changed files, along with the new manifest and game version file to your server. The files on your server must always match the ones in the current manifest.

Launchpad can't connect to my server

Make sure you've correctly entered the URL to your server and that the folder visible at that URL is the root of the Launchpad installation. Furthermore, double-check that you have correctly opened the ports of your server.

The download speed is very slow

In most cases, a low download speed is due to throttling from the server. If you use CloudFlare or another DDOS protection service, they may be limiting or testing the connection to make sure it's not from a malicious source. Depending on your upload bandwidth, tweaking your download buffer size may produce improved results - this is available as a configurable value in the configuration file, where it should be set as a power of two. You should not go below 4096.