then connect to race47-staging.craftedc.art

Requirements

Game edition

Full versions of the Steam and Epic Games Store editions of HITMAN World of Assassination (otherwise known as HITMAN 3) are supported.

The Microsoft Store edition, or demo/starter editions, are untested and may not work, and support will not be provided.

Operating system

race47 works fine on both Windows, and Linux via Wine/Proton.

Installation instructions

race47 requires installing a mod (Race47Client) onto HITMAN. Even if you are familiar with ZHMModSDK, please double-check that the version you have installed matches the version required for the mod.

Install ZHMModSDK

Grab ZHMModSDK-Release.zip from ZHMModSDK v4.0.0-rc.3. The exact version of ZHMModSDK does matter, since it needs to match the version that the Race47Client mod was made for. This can change between mod updates!

To install, extract the contents of the ZIP file into the Retail folder, within your HITMAN installation folder.

On Windows, this defaults to C:\Program Files (x86)\Steam\steamapps\common\HITMAN 3\Retail for Steam, or C:\Program Files\EpicGames\HITMAN3\Retail for Epic.

On Linux, this defaults to ~/.local/share/Steam/steamapps/common/HITMAN 3/Retail for Steam.

Further information about installing ZHMModSDK is available in the README, should you need it. On Linux, if not using recent versions of Proton, you may need to follow these extra steps as well.

Install the Race47Client mod

TODO

Getting in-game

Launch the game, but don't skip past the "PRESS [ Return ]/A TO PLAY" screen just yet. We need to configure a couple things first.

Enable mods

Open the ZHMModSDK overlay, which can be done by pressing the ~ key (or ^ on QWERTZ keyboards), then open the "MODS" window and enable the following mods:

Connect to the race47 server

By default, skipping past the title screen will connect to the official HITMAN servers, but race47 has its own server you need to connect to instead. The OnlineTools mod lets us change which server we connect to.

  1. Open the "OnlineTools" window from the ZHMModSDK overlay
  2. Add a new domain for race47-staging.craftedc.art
  3. Make sure "Always Send Authorization Header" is checked
  4. Then hit the apply button next to the race47 domain (you'll need to do this on each launch, if you want to play with race47)
  5. Close the ZHMModSDK overlay, and continue past the title screen

If all works, you should see a notification in the top right of your screen welcoming you to the race47 server. You can also open the "RACE47" menu from the ZHMModSDK overlay to check if things are working there.