Handshake

The Reactor handshake makes sure that all players in a game of modded Among Us are running the same version of mods. If you reached this page, you may have run into an issue with the handshake or you want to enable it for your own mods.

For Players

Most mods require you all players you play with to install the mod. To check that all players have the correct version, the handshake is used. The handshake will make sure that players who join have the same version of the mod installed as you.

To make sure people without mods don't join your modded game, the public/private slider and the public lobby is disabled on servers that are not aware of the mod handshake, like the official servers. Usually there are custom servers installed by your mod that allow you to create a public lobby there.

To play a modded game, either find some friends willing to play with you, or look in the public game menu of a custom server. Joining a game from the public server list on official servers doesn't work, almost all of the lobbies you find there are of unmodded games. Alternatively, join the Discord of the mod you installed, they usually have a matchmaking section where you can find other players.

For Server Operators

If you run an Impostor Server, you need to install some plugins to take full advantage of the custom handshake.

To prepare your Impostor server for modded game matchmaking, you need to install and set up the following plugins:

• Impostor.Http version 0.2.0 or newer.
• Reactor.Impostor version 2.0.0 or newer.
• Reactor.Impostor.Http which you can download from the Reactor.Impostor Github. Use the same version as Reactor.Impostor.

Impostor.Http requires you to install ASP.NET Core. See the readme of Impostor.Http for details on how to configure this plugin and how to use the HTTP matchmaking functions of Impostor.

For Mod Developers

If your mod requires all players to have the mod installed in order to play, you need to do the following two things:

1. If you don't already have one, add a dependency on the most recent version of Reactor to your .csproj file: <PackageReference Include="Reactor" Version="2.0.0" />.
2. In your main class, add the following attribute: [ReactorModFlags(ModFlags.RequireOnAllClients))].
3. Make sure that each release of your mod that is incompatible with the rest has a different version number and if you are forking someone else's mod, that you are using a different plugin id. The handshake relies on your mod's plugin id and version number to determine which mods are installed on each side.

Now Reactor should register your mod as a mod that requires a handshake to match.

If you run into issues after reading this document, please join our Discord