GBSU (Gang Beasts Server Utility)

This mod allows you to connect to a Gang Beasts server in recent versions (through LAN or Internet) by utilizing developer methods found in the game assembly.

NOTICE: This is not a "Cement" mod, and we don't want to be affiliated with their developers. This mod is standalone, and will work best on its own!

Features

• LAN (ethernet switches at LAN parties) and Online (port forwarding, Zerotier, Wireguard) multiplayer
• Custom score handling made by the server (we don't want to use the game's score handler)

Installation

1. Check your game version in the "Settings" menu in-game. If the version is 1.17.39_WS_8af7688, we fully support it.
2. Check whether your game is Mono or IL2CPP: Go to 'Gang Beasts_Data'
   • If you have a folder called MonoBleedingEdge or the Gang Beasts_Data/Managed folder contains a file called 'Assembly-CSharp.dll': your game is Mono. Continue to Mono instructions.
   • If you have a il2cpp_data folder: your game is IL2CPP. Continue to IL2CPP instructions.

Mono

1. Download the latest BepInEx 5 stable release for Mono x64. As of March 2025, we recommend getting BepInEx_win_x64_5.4.23.2.zip
2. Extract the zip file contents into your root game folder (where the Gang Beasts.exe file is, and not in the 'Gang Beasts_Data' folder!)
3. Launch the game once.
4. Get the mod from our releases page.
5. Put the .dll file in the BepInEx/plugins folder.
6. Launch the game with launch arguments -ip 1.2.3.4 and -port 5999 with the IP address and port of the server you want to host or connect to.
   • To set those arguments on Steam, please refer to this guide.
7. You're good to go! Learn how to use the mod in usage.

IL2CPP

WIP: You're currently out of luck! The mod doesn't support your game version at the moment. It will be ported to MelonLoader in the future. Try downgrading your game by getting older versions in Steam Betas or by using DepotDownloader.

Usage

Press Right Shift to open the mod GUI. Because of how the game is made, you need to be very careful when executing the steps else you will need to restart it. (will be fixed in future versions)

Server (host)

Setting up the server

1. Open the Gang Beasts_Data folder in the "server" game instance files.
2. Create two new folders: Config/Rotation
3. Download the one of the config files and place it inside the Rotation folder.
4. Rename the file to config.json

Configuring your custom server settings

• If you set "random": true, the map order will be randomized.
• Some maps may have different names in-game compared to their actual titles. Make sure to refer to the allmaps configs for the map names.

Launching the server

Once the config file is in place, host your server by pressing the Host button in the mod menu. Don't pay attention to what's displayed on the game. It will be an infinite loading screen after the first round.

Client (player)

1. In the game menu, choose Online.
2. If you're planning to team up with friends, make sure your server config is set to the gang gamemode and choose a shared color. Otherwise, use a different color than your friends.
3. Open the mod menu and press Join.

Troubleshooting

I press the Host/Join button and nothing works!

1. Make sure you're in Online mode if you're joining a server.
2. Make sure you're in the Main Menu if you're hosting a server.
3. Make sure you've passed the -ip and port arguments correctly to the game.
4. Is the host port accessible? Behind NAT? Use a tunneling software like Zerotier or port-forward.

On Linux, my game doesn't load with the mod

If you're running Linux, I suggest using the Windows version of the game and running it with Wine/Proton. Then launch the game with the WINEDLLOVERRIDES="winhttp.dll=n,b" environment variable set.

On Steam, simply put WINEDLLOVERRIDES="winhttp.dll=n,b" %command% in your launch arguments.

If it's still not working, try using winecfg for your prefix or protontricks and go to the libraries tab in Wine Configuration. Simply add winhttp as an override and check if it's correctly set as "native, then builtin" (or "n,b").

Contact us

Need help?

Ask us on Matrix.

Feature requests or bug reports

Want a new feature? Found a bug? Open an issue!. Please note that a Gaboule account is required. This will change once Forgejo supports federation. Alternatively, feel free to reach out to us for general feedback or questions.

Developer information

• The mod is made for BepInEx 5
• The targeted Unity version is 2020.3.5f1
• The TFM is netstandard2.0
• The mod is built using .NET SDK 9.0.103