This guide walks you through every step needed to join your Project Zomboid server hosted with Legion Hosting — from finding your connection details in GPanel to adding the server to your Favorites list in the game.
IP:Port as a single string in the IP field will fail. Read Step 3 carefully.
Prerequisites
- An active Project Zomboid server with Legion Hosting
- Project Zomboid installed through Steam
- Your server's IP address and port number (find these in GPanel — see How to Find Your Server IP and Port)
- The server's password, if one has been set
- Your game version must match the server's version (covered in Step 5)
Step 1 — Confirm Your Server Is Running
- Log in to GPanel.
- Click your Project Zomboid server from the server list.
- On the Console tab, confirm the status indicator shows Running.
- If the status shows Offline, click Start and wait for the console to stop scrolling before attempting to connect. Full startup typically takes 60–90 seconds.
Step 2 — Note Your IP Address and Port Separately
GPanel displays your connection address in the format IP:Port, for example 198.51.100.42:16261. You need to write down each part separately before going into the game.
| Part | Example | Where to Find It |
|---|---|---|
| IP Address | 198.51.100.42 |
Everything before the colon in the GPanel address field |
| Port | 16261 |
Everything after the colon in the GPanel address field |
Step 3 — Add the Server to Favorites in Project Zomboid
The Favorites list is the most reliable way to connect. It stores your server details so you do not have to enter them every time.
Build 42 (B42)
- Launch Project Zomboid. On the main menu, click Join Server.
- Select the Favorites tab at the top.
- Click Add Server (or the + button).
- Fill in the fields:
- IP / Host: Enter the IP address only — e.g.
198.51.100.42. Do not include the port here. - Port: Enter the port number only — e.g.
16261. - Password: Enter the server password if one is set.
- Description: Optional nickname for the server in your list.
- IP / Host: Enter the IP address only — e.g.
- Click Add to save, then double-click the server entry (or select it and click Connect).
Build 41 (B41)
- Launch Project Zomboid. On the main menu, click Join.
- Select the Favorites tab.
- Click Add.
- Fill in the fields:
- IP: Enter the IP address only — e.g.
198.51.100.42. - Port: Enter the port number only — e.g.
16261. - Server Name: Any label you like.
- Password: Enter the server password if one is set.
- IP: Enter the IP address only — e.g.
- Click OK, select your server from the Favorites list, then click Connect.
IP:Port together in the IP field. The game sends only what is in the IP field to the server. Entering 198.51.100.42:16261 in the IP box will cause a connection failure because the port number will be treated as part of the hostname.
Step 4 — Launch the Correct Multiplayer Executable (B42)
Build 42 requires you to launch multiplayer using a specific method. If you launch the game incorrectly, the Join Server screen may not appear or Steam authentication will fail.
Option A — Use the Steam Launch Option (Recommended)
- In Steam, right-click Project Zomboid and choose Properties.
- Under General, find the Launch Options field.
- Enter:
-nosteamonly if instructed by your server admin. For standard play, leave Launch Options blank. - Click Play. On the launcher dialog that appears, choose Play Project Zomboid (build 42 mp) or the equivalent multiplayer option.
- On the main menu, confirm the bottom of the screen shows (steam) next to the build number. This confirms Steam authentication is active, which is required for server connection.
Option B — Run b42mp.bat Directly
If the Steam launcher does not show a multiplayer option, you can launch multiplayer directly:
- Open your Steam library, right-click Project Zomboid, and go to Manage > Browse Local Files.
- In the game folder, locate the file
b42mp.bat(Windows) orb42mp.sh(Linux/Mac). - Double-click
b42mp.batto launch the game in multiplayer mode. - Again, confirm the main menu shows (steam) at the bottom before attempting to join a server.
Step 5 — Match Your Game Version to the Server
A version mismatch is one of the most frequent causes of connection rejection. When the game receives an update, your client version changes immediately but your server version only changes when you manually update it in GPanel — or vice versa. Both must run the same build.
Check the Server Version
- In GPanel, go to your server's Console tab.
- Look through the recent startup log for a line that reads something like
Build 42.x.xorBuild 41.x.x. - Alternatively, check the Startup tab — the installed version is often shown next to the Steam branch selector.
Switch Your Steam Client to the Correct Branch
If the server runs Build 41 but your Steam client has already updated to Build 42 (or a specific beta branch), you need to opt into the matching branch:
- In Steam, right-click Project Zomboid and choose Properties.
- Click the Betas tab.
- Open the Beta Participation drop-down.
- Select the branch that matches your server:
- None — Latest stable release (currently Build 42)
- b41multiplayer — Build 41 stable multiplayer branch
- Other named branches as offered by the developer
- Close Properties. Steam will download the correct version automatically.
- Wait for the download to complete before launching the game.
Step 6 — Use Steam Relay if Direct UDP Fails
Project Zomboid uses UDP for its connection. If your network blocks UDP traffic — for example, certain university or corporate networks — you may be unable to connect directly. Steam Relay routes your connection through Steam's servers as a fallback.
- In Steam, click Steam in the top menu bar, then choose Settings.
- Go to Remote Play (or in some versions, In-Home Streaming > Advanced).
- For connection routing, check Steam's network settings under Downloads > ensure you are not forcing a specific region that is far from the server.
- If you have a firewall or VPN active, try temporarily disabling it to test whether that is blocking UDP port 16261.
- As a final fallback, Steam may automatically attempt relay routing. If prompted in the game's connection dialog to allow relay, accept it.
Verification
- After clicking Connect, the game will show a loading screen or a character creation screen if it is your first time joining.
- Once loaded into the world, press Esc and confirm your character name and server name appear correctly.
- Open the in-game map (M) or check your coordinates to confirm you are in an active world session.
- If other players are on the server, you should see their names in the player list (Tab or P depending on version).
Troubleshooting
Connection failed / timed out
- Confirm the server status in GPanel shows Running, not Offline or Starting.
- Verify the IP and port are in separate fields. The IP field must contain only the IP address — no colon, no port number.
- Make sure the port in the game matches the port shown in GPanel exactly. Do not assume the default
16261if GPanel shows a different value. - Check that your firewall or antivirus is not blocking UDP traffic on the server's port.
Version mismatch error on connection
- The game client and server must be on the same build. Check the server's build in GPanel console logs.
- Switch to the matching Steam beta branch as described in Step 5.
- After switching branches, allow Steam to finish downloading before launching the game.
The game launched but there is no "Join Server" option on the menu
- You are likely running the single-player executable. Exit and relaunch using
b42mp.bator select the multiplayer launch option from the Steam dialog. - Confirm the main menu shows (steam) at the bottom of the screen.
The main menu does not show "(steam)" — it shows "(nosteam)"
- You launched with the
-nosteamflag or using the nosteam executable. The server must also be running in nosteam mode for this to work. - For most Legion Hosting servers, remove
-nosteamfrom your Steam launch options and relaunch using the standard multiplayer method.
Server shows in Favorites but connection drops immediately
- The server may have just restarted. Wait 60–90 seconds and try again.
- If a password is set, confirm you are entering it correctly — passwords are case-sensitive.
- Check the GPanel console for error messages that appear at the moment you try to connect, such as banned IP or max players reached.
High latency or rubber-banding after connecting
- If you are connecting via Steam Relay, this is expected. Try switching to a direct connection (ensure UDP port 16261 is not blocked at your end).
- If on a direct connection, check the server's Console in GPanel for high CPU or memory usage that could indicate the server is overloaded.
Still cannot connect after following all steps
Open a support ticket and include:
- Your server's IP and port from GPanel
- The game build version (shown on the main menu)
- The exact error message you see when the connection fails
- A screenshot of your Favorites entry showing the IP and Port fields