The Admin Tool

Before you can start updating your game, you have to perform some initialization tasks. The whole documentation assumes you are working on Windows, so commands and everything else refers to its environment. If you are on a different OS don't worry: the process is the same, very minor changes in commandline commands are needed.

Requirements

You will need a web server that can server files over HTTP. The Launcher's downloader does access files through direct URLs, like: http://yourIP/yourFolder/yourFile.exe, so make sure that your files host can serve them correctly! You also will need the P.A.T.C.H. - Updating System package.

Initialization

Go on Window > P.A.T.C.H. > Admin Tool or press Alt + Shift + P: this will initialize the workspace. If you now click on Window > P.A.T.C.H. > Go to Workspace folder or press Alt + Shift + O the workspace will open and you will see some new folders: App, Builds, Patches, Updater.

Commandline equivalent

Run the command .\MHLab.Patch.Admin.exe --init: this will initialize the workspace. You will find an App folder in the same folder. The App folder will contains your game's current files.

The first version

Now you just need to build your game. Once you done and built files are available, move all of them to the App folder. Go to Admin Tool > Builds and hit Initial build button.

Commandline equivalent

Run the command .\MHLab.Patch.Admin.exe --build

After the computation, you will notice new files and folder spawned in your Builds folder:

• 0.1.0 folder, it contains your game's files with some metadata about the version number
• builds_index.json file, it contains metadata about all versions
• build_0.1.0.json file, it contains metadata about the specific version

Upload the first build

It's a good time to upload files! Upload 0.1.0 folder, builds_index.json and build_0.1.0.json files on your web server.

Hint

To test if your files are reachable by the Launcher, just navigate over them with a normal web browser. Assuming we uploaded files at http://127.0.0.1/MyGame/, we will navigate on http://127.0.0.1/MyGame/Builds/builds_index.json. It should return a JSON string.

The second version

When you made enough changes to your game and you want to deploy a new version, just build your game again and put it in App folder. Go to Admin Tool > Builds again. This time you can notice that more options exist. Before proceeding, you should take a look at Release type. It regulates how the version number is increased and contains three options:

• Patch release: with an previous version number of 2.3.6, a patch release will change the version number to 2.3.7. It is used for very little changes, hotfixes and similar stuff.
• Minor release: with an previous version number of 2.3.6, a minor release will change the version number to 2.4.0. It is used for minor changes or additions to the existing functionalities.
• Major release: with an previous version number of 2.3.6, a major release will change the version number to 3.0.0. It is used for major changes/additions to the existing functionalities or for changes/additions that break the backward compatibility.

Pick a release type accordingly to your needs and hit Build new version button. Again, after some computation the process will complete and you will find in your Builds folder a new version.

Generating a patch

At this point you have two versions of your game.