FAQ

How to get started with it?

See Getting Started page.

How much does it cost?

For our current offer, please visit our pricing page.

Do I need to build a launcher application?

Definitely not! PatchKit is a drop-in solution. If you have your game, just upload it, and you will be supplied with a launcher application. Download it and share it with anyone you want.

How can I upload my game?

First, you have to create application entry using the Panel. Once you’ve done it you can:

After being uploaded your file contents will be processed. You will see a progress bar of this operation. Just wait a moment to see if everything is all right.

How can I publish my game?

After uploading and processing your version, you will see a red Publish button in your draft version view. Just click it and confirm your intent. You will be notified when your version is published and ready to be downloaded!

Where can my players download my game?

The only way your players can download your game is by sharing the launcher application with them. The launcher application can be downloaded by you on your application’s page, or you can share a publish download link with your players. This can be found on your application’s page as well.

Will my players need to re-download my game when a new version is published?

Definitely not! PatchKit is heavily dependent on binary diffs. For every version, you’re publishing there’s a binary diff generated on our servers. It will be downloaded and applied by your players as soon as they launch your game. The procedure is really fast and in most cases, they don’t need to wait longer than several seconds based on network and PC performance.

How to prepare a version patch?

You don’t have to do that at all. Just upload your new version’s ZIP file to the panel, and PatchKit will take care of the rest. Other ways of uploading your versions is by using our command-line tools or Unity extension.

My patch size is quite big. Why?

There may be several reasons:

  1. You’ve made some significant changes, and there’s no way around it.
  2. You’ve uploaded a wrong game by mistake.
  3. You’ve renamed your files or directories. PatchKit currently does not support this kind of scenario very well.

Every time I launch my application, it re-downloads some of the files.

That usually means that your build includes files that are being modified by your application. Log files maybe? Make sure to remove those before sending the build.

Launcher assumes that any installed file has changed its contents may be corrupted, and it’s safer to re-download it. It takes the same action if a file is missing, but ignores any files created after the installation procedure.

If your use case requires to modify files that are included in the build, try generating those on the first launch or install a template somewhere more buried in the directory tree to make a copy later.

How big games can PatchKit handle?

There’s no hard limit to that. PatchKit is designed to handle applications of any size. It has been tested with tiny few-megabytes games and with huge ones (100 gigabytes and more).

What is the difference between runner and launcher?

  • Runner - a small application used for downloading the newest version of the launcher.

  • Launcher - a bigger application used for downloading the newest version of target software.

Why do we need a runner?

Runner allows us to release any potential updates for the launcher. It doesn’t use any patching algorithms to update the launcher - it simply redownloads the whole launcher to keep it as simple as possible.

I’d like to use PatchKit behind a firewall. Which domain names and ports should I add to my whitelist?

You should whitelist all *.patchkit.net domains (using a wildcard). Make sure to open the following ports:

  • Outgoing TCP 80
  • Outgoing TCP 443

It’s highly recommended to open these ports as well for the best performance possible:

  • Outgoing TCP 9292 to any *.patchkit.net
  • Outgoing UDP 443 to any IP

What arguments are passed by runner/launcher to my application?

  1. Built-in arguments pairs starting with a + character. It can look like +key value. If your application is relying on a passed argument list, make sure to ignore these pairs.
  2. Custom arguments provided by you. These are added right after the built-in argument list.

When I try to run the launcher I see “Windows protected your PC” popup

This popup is generated by Microsoft Windows SmartScreen to prevent unknown application from running. It can be easily omitted by clicking on the More Info link and the Run anyway button.

To prevent this message from displaying, either:

  • Sign your code with a code signing certificate
  • Leave it be - after some time SmartScreen learns that this application is not harmful and it won’t be shown to the new users
Did this page help you? If you have any questions, please use the chatbox on the bottom-right or use our contact form.

Copyright © 2015 - 2021 Upsoft
All Rights Reserved.