Skip to content

About

Two-player co-op mod for HITMAN World of Assassination. Fan-made, by Jordan Rodrigues.

Topics

Resources

Stars

7 stars

Watchers

0 watching

Forks

Repository files navigation

HITMAN Co-op

Two-player co-op for HITMAN World of Assassination. Made by Jordan Rodrigues.

Join the HITMAN Co-op Discord

This is a fan mod. It's not made or supported by IO Interactive and has nothing to do with them. HITMAN is their trademark. You use it at your own risk, so please read the disclaimer first.

You and a friend play the same mission at the same time. You can see each other walking around the level and the NPCs are shared between both games. If you knock a guard out, he's knocked out for your friend too. Same with kills, alerts and where people are walking. Bodies, doors and items are shared as well, so if your friend dumps a body in a closet, your guards won't find it either.

There's also some stuff to help you plan things together: you can mark targets, there's a small radar, quick signals, chat, and a ready check with a 3-2-1 countdown for when you both want to take out a target at the same moment.

It's free, it's open source, and I keep updating it.

0.14.0: the milestone

Download 0.14.0. Both players need it (it doesn't connect to 0.13.x). If you have 0.13.2 it updates itself the next time you start the game.

This is the biggest update so far. It has everything from the six 0.13.9x betas (a new setup that installs Tailscale for you, no more antivirus "trojan" alarms from the old installer, shared body drags, NPCs animated the same in both games, signed updates) and a new round of fixes from your bug reports. But the main change is in how bugs get found and fixed from now on.

A new way of logging

Until now the log only kept what its level allowed. The moments right before a crash, or before an NPC got stuck, were usually missing. Then the only thing to do was turn on verbose logging and try to make the bug happen again.

0.14.0 adds a flight recorder. The mod now keeps the last several thousand detailed events in memory all the time, at any log level:

  • every NPC that changed hands between the two games, and why
  • every event the game sends
  • every scripted step of the mission
  • every item given to your partner's copy
  • the NPCs around you, every 20 seconds

All of it is written out with every crash, and into every bug report (HitmanCoop-blackbox.txt). One bug report from each player is now enough to replay what both games did, side by side, without asking anyone to reproduce anything.

Crash reports changed too:

  • They name the mod's own functions.
  • They show the exact instruction that failed, and what the mod was doing at that moment.
  • They end with the last 40 events.

Faults the mod catches and survives are written down too, so they get fixed even if nobody noticed. This is how the two crashes in 0.14.0 were found: from two players' crash files, traced to the exact line in minutes.

Also in 0.14.0

  • Two crashes fixed:
    • the partner's game crashing when you drew a rifle;
    • the partner's game crashing when you quit to the menu.
  • NPCs facing the wrong way (walking north while facing south) on one player's screen: every shared NPC is now pinned every frame to exactly how it stands in the other game.
  • Guards stuck with a "?" after a noise: an NPC that hears something you throw, or that your game starts something with, is now run by your game until it's done. NPCs that are searching or alarmed no longer switch between the two games halfway through.
  • Missions getting stuck (the Hawke's Bay NDA): a scripted step one player does, like signing a paper or sabotaging something, now happens in both games, so targets react for both of you.
  • The setup now tunes the game itself for co-op. HITMAN reconnects to IOI's servers on its own instead of freezing the mission with a "connection lost" box. There's a tick box for it, and uninstalling puts it back.

All the changes are in the changelog and installer/WHATSNEW.txt.

Discord

There's a HITMAN Co-op Discord now. You can find someone to play with (by platform and region), hop in the two-player voice rooms, get help installing, report bugs, suggest stuff and see what I'm working on. New releases get posted there first, and you can share clips of your best double hits. Honestly it's the quickest way to get a bug fixed.

Team applications are open until 30 November 2026. I'm looking for moderators, testers, contributors and people to host events. You can apply here.

A note on AI

I want to be upfront about this. I used an AI coding assistant (Claude) while making this mod and it helped me a lot. I'm a single developer, I'm young, and I'm still in school. Building something this big alone, single-handedly, just wasn't going to happen any other way, and I wanted to get it out as soon as I could so people could actually play it.

The idea is mine. I designed how it works, paid for the AI plans and usage myself, and tested every build in the game more times than I can count. A lot of the fixes came straight from bug reports people sent in. HITMAN was never made for multiplayer, so getting two games to agree on every guard, body and door meant breaking things over and over, reading logs and figuring out what the game was actually doing.

I know some people don't want to use mods made with AI, and that's okay. Nobody has to use this. If you do try it, I'd love to hear what you think, good or bad. Criticism on any part of it is welcome. If something breaks, I'll fix it as fast as I can. So far there have been six updates in the first week, almost all of them from player reports.

Other people have tried co-op for HITMAN before me (there's even an early multiplayer experiment called Hitmen inside ZHMModSDK), so I'm not claiming to be the first. This is just my go at it.

What's in it

The mission

  • Your friend shows up in your game as their 47, moving exactly how they move, in whatever disguise they have on. If they're wearing one of 47's own suits you'll see them in normal clothes instead (putting the suit on the copy crashes the game), so look for their name tag.
  • NPCs are shared: kills, knockouts, alert levels and where they walk. A guard your friend is holding stops reacting in your game, so you can both take someone down at once without the other takedown getting noticed.
  • Bodies your friend drags off or hides in a closet get hidden in your game too.
  • Doors and items are shared. If your friend picks something up it disappears for you, and what they're holding shows in their hand.
  • Pause together, restart together, and start together (your mission waits until your friend has loaded in).
  • Your friend's copy can't be seen by the AI or hurt. Their own game decides what happens to them.
  • It updates itself. New versions download in the background and get used the next time you start the game, and you're shown what changed.

Working as a team

  • Marks: aim and press the middle mouse button. Press it twice fast to mark danger, and again later to remove it. Marks stick to the person you marked.
  • Signals over your head (OK, wait, help, look here).
  • Ready check, 3-2-1 countdown, "where are you?", "come to me" and regroup (teleports you behind your friend).
  • Chat and eight quick messages you can change.

Keeping track of your friend

  • A HUD with ping, distance, how alert the NPCs near them are, their disguise, and whether they're in a menu, loading or away.
  • A name tag over their head (it goes orange or red when they're in trouble) and an arrow at the edge of the screen when they're off it.
  • Radar, compass, kill feed, Silent Assassin tracking for the team and a summary at the end.

Connecting

  • Join codes through a small relay server, or straight by IP (LAN, Tailscale, port forwarding).
  • It adapts to bad connections and reconnects by itself if you drop.
  • It never uses IO Interactive's, Steam's or Epic's servers. It works with the game online or offline.

You can also rebind every hotkey, move and resize the HUD, switch to feet, turn on colour-blind colours, and there's a streamer mode that hides join codes and IP addresses.

What you need

  • HITMAN World of Assassination on Steam or Epic, on Windows. The Game Pass / Microsoft Store version can't be modded.
  • Both of you need the same version of HITMAN Co-op.
  • You play at a location you both own. If your friend only has some of the locations, you can play those together. The mod never takes anyone somewhere they didn't start themselves.
  • It's made for game version 3.290.1. If the game updates and something co-op needs is missing, co-op just stays off instead of breaking anything, until there's a fixed version.

How to install

Both of you do this. It takes about a minute.

  1. Close the game.
  2. Go to the Releases page and download HitmanCoop-Setup-<version>.exe. That's the only file you need.
  3. Run it and click INSTALL. It finds HITMAN on Steam or Epic on its own and installs the mod loader (ZHMModSDK) and the mod. If it can't find the game, click Browse and pick your HITMAN 3 folder.
  4. Start the game and press ~ (the key under Esc). CO-OP shows up at the top.

Windows SmartScreen will probably say "Windows protected your PC" because the setup isn't signed by a company. Click More info and then Run anyway. The SHA-256 of the setup is on the Releases page if you want to check it.

If you'd rather use a zip, download HitmanCoop-<version>.zip, extract all of it and run HitmanCoop-Setup.exe from there. To remove the mod, go to Settings > Apps > HITMAN Co-op > Uninstall, or run the setup again and click UNINSTALL. Your saves aren't touched either way.

On Linux or the Steam Deck, extract HitmanCoop-<version>-linux.tar.gz and run bash installer.sh.

How to play together

  1. Both of you start a mission at the same location.
  2. The host presses ~, opens CO-OP and clicks HOST. They get a join code (it's copied for them) or they can give their IP address.
  3. The friend presses ~, opens CO-OP, types the code under "Join a friend" and clicks JOIN. They get taken into the host's mission.
  4. Once the HUD says you're in the mission together, you're good.

The CO-OP window has tabs for Play, Chat, Mission (stats, your co-op record, notification history), Settings, Hotkeys and About (help and the "Copy diagnostics" button for bug reports).

Playing over the internet

If you're not on the same Wi-Fi, I'd use Tailscale. It's free, it takes a few minutes and you don't have to touch your router. It puts both PCs on a little private network so the friend can join the host directly.

  1. Both of you install Tailscale and sign in.
  2. The host invites the friend from the Tailscale admin page (Invite users), or shares their PC with them under Machines.
  3. The host starts a mission, opens CO-OP and clicks HOST. Their Tailscale address (starts with 100.) is shown in the Play tab. Send that to your friend.
  4. The friend accepts the invite, starts a mission at the same location, types that 100.x.x.x address under "Join a friend" and clicks JOIN.

For Tailscale, LAN or IP connections the host has to tick "Also allow direct IP connections through Windows Firewall" in the setup (just run the setup again if you didn't). Join codes don't need it.

If it won't connect, check that Tailscale shows both PCs as connected, that the host ticked that firewall box, and that you're both at the same location.

Other ways:

  • Same network: the friend joins the host's local address, shown in the Play tab.
  • Join codes: you both set the same co-op server under Settings > Connection and the host gets a six-letter code. There's no public server built in, but one of you can run one pretty easily (see below). It only passes packets between the two games.
  • Port forwarding: the host forwards UDP port 47047 to their PC and the friend joins their public IP.

Streaming? Turn on streamer mode under Settings > Connection so your codes and addresses never show on screen. There's also Test-Connection.exe in the zip if you want to check that two PCs can reach each other before starting the game.

Running your own co-op server

The relay is one Python 3 file with no dependencies, in server/. Put it on anything with a public IP (a cheap VPS is fine) and open UDP port 47100.

# Linux, as a service that starts on boot:
sudo sh server/install-linux.sh

# or with Docker:
docker build -t hitmancoop-relay server/
docker run -d --restart=always -p 47100:47100/udp hitmancoop-relay

# or just run it:
python3 -I server/relay.py --port 47100

Then you both put your.server.address:47100 as the co-op server in Settings.

Hotkeys

What Key
Mark what you're aiming at (twice fast for danger, again to remove) Middle mouse
Quick messages 1-8 Num 1 to Num 8
Regroup Num 0
Where are you? Num 9
Ready check / say you're ready Num .
3-2-1 countdown Num +
OK / wait / help Num / , Num * , Num -
Come to me, look here, hide HUD or radar, screenshot mode not set

Num Lock has to be on. You can change any of them in the Hotkeys tab: click Change and press a key (hold Ctrl, Shift or Alt for a combo). If a key is used twice it shows up red.

Everything else is in the Settings tab and gets saved to Retail\mods\HitmanCoop.ini.

If something goes wrong

  • No CO-OP button: press ~ (it's ^ on some keyboards). If still nothing, reinstall with the setup.
  • "Different HITMAN Co-op versions": you both need the same release.
  • Can't connect by IP: the host's firewall or router is blocking UDP 47047. Use a join code, Tailscale or forward the port.
  • "Co-op can't run on this game version": the game got updated. Wait for (or grab) the matching release.
  • Can't see your friend's 47: if they're in one of 47's suits they show up in normal clothes, so look for the name tag or the radar dot. If there's no name tag at all, restart the mission together. If it keeps happening, send me the diagnostics (they have a "Partner's 47" line that says why).
  • "You are in a different mission" or "different difficulties": start the same mission on the same difficulty.

To report a bug, open an issue or post in #bug-reports on the Discord. In the CO-OP window go to About and click Save bug report on both PCs. It makes one zip with the logs, the flight recorder, any crash report and the diagnostics (no IP addresses in any of it). Attach both zips. Please don't post HitmanCoop-crash.dmp unless you're asked: it holds the game's memory.

Still stuck? Ask in #install-help on the Discord or post it in #bug-reports. Someone there has probably run into it already.

FAQ

Can I get banned? HITMAN doesn't have an anti-cheat like EasyAntiCheat or BattlEye. This runs through ZHMModSDK, which is the normal HITMAN mod loader. It changes the game in memory while it runs, never the game's program on disk. The only game file the setup touches is one line of the settings file (Retail\thumbs.dat, so the game reconnects by itself). You can untick that, and it's put back when you uninstall. It's still a mod though, so read the disclaimer.

Does it mess with the online stuff? No. It never talks to IO Interactive's servers, co-op goes over its own connection, and your game logs in like normal. When the game starts it checks this GitHub page for a new version (you can turn that off under CO-OP > About). It works with the game offline too, so if you're worried about your profile or leaderboards, just play co-op offline.

Do I need Peacock? No. I haven't tested it together with Peacock yet either, so if you try it, let me know how it goes.

What's new

0.14.0 is the milestone release (see the top of this page). Every version is in the changelog.

Building it yourself

See BUILDING.md. Short version (Visual Studio 2022, CMake, PowerShell):

./tools/fetch-sdk.ps1
cmake -S . -B _build -G "Visual Studio 17 2022" -A x64 -DZHMMODSDK_DEVPKG_DIR="$PWD/_deps/devpkg"
cmake --build _build --config RelWithDebInfo
cmake --install _build --config RelWithDebInfo --prefix _build/install
./tools/check-dll.ps1
./tools/package.ps1

The core part (protocol, networking, session and sync logic) doesn't need the game and builds and tests on its own:

cmake -S core -B core/build -G "Visual Studio 17 2022" -A x64
cmake --build core/build --config Release
core/build/Release/coop_tests.exe
python -I server/test_relay.py

Founding team

These are the people with the Founding Team role on my Discord server. They helped me get this mod to where it is now, and I really appreciate them.

  • Aerial Bot: sent me a huge amount of bug reports and suggestions, was one of the first people to join the Discord, and put their hand up to help moderate it too. Thank you!

The Founding Team role isn't given out any more. Want to help? Team applications are open until 30 November 2026.

Support the developer

Donating is completely optional. The mod is free and it stays free, and nothing is locked behind paying. Please only donate if you really like what I've made and you feel it's worth it to you. If not, that's totally fine. Starring the repo, telling a friend or sending a bug report helps just as much.

If you do want to:

UPI (India)

UPI QR code
Scan it with any UPI app or pay to jordanrodrigues021@okhdfcbank

Steam gift card (works from any country)

Add me on Steam with friend code 1300893237 (Friends > Add a Friend) or this invite link, then send a Digital Gift Card of any amount. Steam might make you wait a few days after adding me before it lets you send one.

Amazon gift card

Send an amazon.in e-gift card to jordanrodrigues021@gmail.com. It has to be from amazon.in, cards from other Amazon stores usually don't work in India.

If you want to help some other way, just email me or message me on Steam.

Thanks a lot for reading this far.

Credits and licence

Made by Jordan Rodrigues, with a lot of help from the people above. Full credits are in CREDITS.md. It's built on ZHMModSDK by OrfeasZ and contributors.

Licensed under the GPL-3.0, see LICENSE.

About

Two-player co-op mod for HITMAN World of Assassination. Fan-made, by Jordan Rodrigues.

Topics

Resources

Stars

7 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages