Game Updater Manual

From Bohemia Interactive Community
Jump to navigation Jump to search

Foreword

This page contains all necessary data to install and use Game Updater (hereafter, GU). Game Updater aims to improve the experience of switching between branches of the game by avoiding the fuss of additional downloads every time you change. More information can be found here: Game Updater.

Notes

Firstly, you need to have Arma 3 Tools installed correctly. Installation manual can be found here: Arma 3 Tools Installation.

How to install

  1. Run Arma 3 Tools from Steam
  2. Find Game Updater on the main form
    a3ct mainForm.jpg

Then, from Game Updater itself, on the first startup, click ok in the message box telling you GU is not installed and:

  1. Type your Steam credentials (leave Steam Guard Code empty) and click "Ok"
    a3ct gu steamAcc.jpg
  2. A console window appears, to check your Steam account
    a3ct gu guardCode.jpg
    1. If your account is protected by Steam Guard, it will ask you the code that you will find in your emails (sent automatically)
    2. Type the given code and hit ENTER
  3. After a few seconds, the time to check your Steam license, the console window will close itself and the main form of GU should appears
  4. Congratulations, GU is installed and ready to work

Notes

In case of mistake on the Steam logging info, you will need to run "Delete user data.bat", located in the directory "Arma 3 Tools\Game Updater"

How to use it?

Parameters

Once it's installed, there are two forms in which you should have a look.

Options

From the main form of GU, click on "options"

a3ct gu options.jpg

  • "Select Branch" allows you to select what branch you want to use to install or update
    • In case you want to install, either legacy or RC branch, a access code will be asked. If it is incorrect, the update process will fail.
    • The text-box of the access code is disabled when the branch is password free.
  • "Play sound when the update is done"
  • "Check local content"
    • If checked, It will check for errors or corrupted files in the existing data. The update process will be a bit longer but it's the safer method.
    • Otherwise, it will just download the modified data from your version to the newer, without any check on existing files.

a3ct gu mainForm.jpg

In the main form, the only available option is the path to the installation to add or update. By default, this is "...\YourSteamPath\steamapps\common\Arma 3 [development]", change it if needed.

Notes

Be careful on your installation path when you change the branch. The main form give you some information about the version found in the selected directory (based on the executable).

The update process

  1. Run Game Updater
  2. Double check the branch and the installation path
  3. Click on Update


If Steam client is running live (started and on online mode), it will ask you to continue or not

  1. A message box is displayed, click yes to proceed (by clicking "No", the main form will be displayed)
  2. Here you are, just wait until the end of the update process
    a3ct gu update.jpeg
  3. Once the update done, you can open the installation directory or just exit Game Updater.

Notes

  • Game Updater has some child processes, ran in asynchronous mode, to get better stability and performances. This is why the information displayed are not in real time. The delay can be from seconds to minutes.
  • If for some reason the update fails, check out the output and the step
  • You can send Game Updater to the notification zone during the update. A balloon tool tip will be displayed as soon as the update process is completed
  • You can cancel the update at any time, "Resume update" is handled.
  • Update steps are:
    • Preparing: Prepare account info and game data
    • Starting: Check parameters and run child processes
    • Validating: Validate the local data if option is set to "Yes"
    • Preallocating: Reservation of the disk space needed
    • Downloading: Download of the new files
    • Success: Self explained

Logs

There are two log files, stored in "Arma 3 Tools\Logs":

  1. GameUpdaterYYYY-MM-DD.rpt: Main log of Game Updater
  2. GameUpdaterChildYYYY-MM-DD.rpt: For child processes

Additional logs from Steam can be find in "Arma 3 Tools\Game Updater\logs", the most relevant is "stderr.txt", filled in case of error.