Skip to content

Update Guide: SCP:SL #70

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
coderrquitsreality wants to merge 3 commits into
base: master
Choose a base branch
from
Open

Update Guide: SCP:SL #70

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
c19086c
Update Guide: SCP:SL
coderrquitsreality Jun 26, 2026
f14573a
Project Zomboid: Add Linux Guide (#73)
coderrquitsreality Aug 10, 2026
f6bc2b3
SVC: Added troubleshooting (#72)
coderrquitsreality Aug 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 5 additions & 14 deletions content/playit-scpsl-server.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,18 +14,13 @@ Requirements:
Resources:
> SCP: Secret Laboratory Server Info - [en.scpslgame.com](https://en.scpslgame.com/index.php/Server_Info)

## Prefer to watch a video?
{{< youtube id="fkc6BuURkG0">}}

## Getting started
### Locate the server files

Right click on **SCP: Secret Laboratory Dedicated Server**, and navigate to **Manage → Browse local files**.

{{< image src="post-img/playit-scpsl-browsefiles.png" alt="Browse local files" >}}

Inside, you'll see the following file structure:

{{< image src="post-img/playit-scpsl-serverfiles.png" alt="Server files" >}}

> Server config files can be found here:
Expand All @@ -38,30 +33,27 @@ To launch the server, double click on `LocalAdmin.exe`.
This will ask for a little bit of setup, but it's pretty easy.

The default port is `TCP/UDP 7777`, it can stay like that. You can just press enter and go to the next step

{{< image src="post-img/playit-scpsl-serverconsole_port.png" alt="Server console setup" >}}

It will then ask if you want to edit the configuration. The default configuration is fine, and you can edit them if you want. For the simplicity of this guide, we will just choose `keep`.

{{< image src="post-img/playit-scpsl-serverconsole_config.png" alt="Server console setup" >}}

For `Do you want to save the configuration only for THIS server` we will choose `this`. This keeps different server configs sepaarated, if you plan on running different servers.

{{< image src="post-img/playit-scpsl-serverconsole_config-this_local.png" alt="Server console setup" >}}

Your server should now be running. The console output should look like this:

{{< image src="post-img/playit-scpsl-serverconsole_running.png" alt="Server console" >}}

### Tunnel setup
> Here, we'll use the SCP: Secret Laboratory tunnel preset.
> This server uses `UDP 7777`, which means that all users can create this tunnel type.
> Since the game uses both `TCP` and `UDP`, we will create a `TCP/UDP` tunnel. However, since TCP is not available to free users anymore, [playit premium](https://playit.gg/account/billing/shop/premium) is required.

Add an [agent](https://playit.gg/account/agents) if you haven't done that yet.
Configure the tunnel as follows:

```text
Tunnel Type: SCP: Secret Laboratory
Tunnel Type: TCP/UDP (protocol)
Port Count: 1
Local Port: 7777
```

{{< image src="post-img/playit-scpsl-tunnelconfig.png" alt="Tunnel setup" >}}
Expand All @@ -75,5 +67,4 @@ Inside of SCP: Secret Laboratory, go to **Servers** and then click on **Direct C
Enter your tunnel information from earlier into here, and then click **Connect**.

{{< image src="post-img/playit-scpsl-serverlist_directconnect.png" alt="Connecting to the server" >}}

{{< image src="post-img/playit-scpsl-serverlist_directconnect-filled.png" alt="Connecting to the server" >}}
{{< image src="post-img/playit-scpsl-serverlist_directconnect-filled.png" alt="Connecting to the server" >}}
183 changes: 183 additions & 0 deletions content/project-zomboid-linux.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,183 @@
+++
title = "Setting up Project Zomboid on Linux"
tags = ["project zomboid", "pz", "guide"]
description_file = "descriptions/project-zomboid-steam-dedicated-server.txt"
+++

### Server
For this to work, we will be using [SteamCMD](https://developer.valvesoftware.com/wiki/SteamCMD) - here's how to set it up.
We will be using Ubuntu Server 26.04 for this portion of the guide.
From your terminal, enter these commands - to install SteamCMD, the multiverse repository and x86 packages must be enabled.

**Ubuntu**
```bash
sudo add-apt-repository multiverse; sudo dpkg --add-architecture i386; sudo apt update
sudo apt install steamcmd
```

### Setup
You need a place to store the server - create a new directory, for example `projectzomboid`
```bash
mkdir ~/projectzomboid
```

Start installing the server from [SteamCMD](https://developer.valvesoftware.com/wiki/SteamCMD) using this command:
```bash
/usr/games/steamcmd +force_install_dir ~/projectzomboid +login anonymous +app_update 380870 validate +quit
```
This will tell SteamCMD to start installing the Project Zomboid server inside of `~/projectzomboid`.

> If you get `ERROR! Failed to install app '380870' (Missing configuration)`, you should try adding `+@sSteamCmdForcePlatformType linux` to the command:

```bash
/usr/games/steamcmd +@sSteamCmdForcePlatformType linux +force_install_dir ~/projectzomboid +login anonymous +app_update 380870 validate +quit
```

## Using playit.gg to share the server

Create and claim a new **playit.gg agent**, then create the tunnel.

Project Zomboid normally uses the following ports:

* `16261` - Main Port
* `16262` - Secondary UDP Port

We will adjust these to work with playit.gg.

## Create the Tunnel

Create and configure your tunnel as follows:

* **Type:** Project Zomboid

{{< image src="post-img/playit-pz-addtunnel.png" alt="playit tunnel config" >}}

At this point, the tunnel will be active, but the game server will **not yet be reachable**. This is because the local server ports must match the tunnel's assigned public ports.

## Configure Server Ports

Although it will work without matching ports, we recommend that you do.
Navigate to your Project Zomboid server configuration folder:

```bash
cd /root/Zomboid/Server
```

Inside, you will find files like:

```bash
server@playit:~/projectzomboid$ sudo ls /root/Zomboid/Server
servertest.ini servertest_SandboxVars.lua servertest_spawnpoints.lua servertest_spawnregions.lua
```

## Starting the server
Your file structure will look like this:

```bash
server@playit:~/projectzomboid$ ls
ProjectZomboid64 java libpzexe_jni64.so libsteamwebrtc.so linux64 pzexe.jar start-server.sh steam_appid.txt steamclient.so
ProjectZomboid64.json jre64 libsteam_api.so license media serialize.lua stdlib.lua steamapps
```

Run `start-server.sh` as root. We need to start the server in order to generate the configuration files for further setup.
```bash
sudo bash ./start-server.sh
```

When your server is fully started, you should see this in the console:

```bash
LOG : Network f:0 st:761,732> *** SERVER STARTED ****
LOG : Network f:0 st:761,734> *** Steam is enabled
LOG : Lua f:0 st:761,744> LuaNet: Initializing...
LOG : Lua f:0 st:761,749> LuaNet: Registering server listener...
LOG : Lua f:0 st:761,749> LuaNet: Initialization [DONE], triggering events for 'LuaNet.onInitAdd'.

### Edit `servertest.ini`

Open `servertest.ini` and locate:

```ini
# Default starting port for player data. If UDP, this is this one of two ports used. Min: 0 Max: 65535 Default: 16261
DefaultPort=16261

# Min: 0 Max: 65535 Default: 16262
UDPPort=16262
```

By default, these options start on line 57.
You can jump right to this line by using the `+57` argument.

```bash
sudo nano -l +57 /root/Zomboid/Server/servertest.ini
```
Change this to match the **public port assigned by playit.gg**.

**Example:**
```ini
# Default starting port for player data. If UDP, this is this one of two ports used. Min: 0 Max: 65535 Default: 16261
DefaultPort=10233

# Min: 0 Max: 65535 Default: 16262
UDPPort=10234
```
Save the file.

## Connecting to the Server

1. Start the Project Zomboid server
2. Open your playit.gg tunnel
3. Copy the **numeric IP address and port**

{{< image src="post-img/playit-pz-tunneladdress.png" alt="playit tunnel address" >}}

**Example:**

```text
147.185.221.181:10233
```

### Join the Project Zomboid server

1. Launch **Project Zomboid**
2. Click **Join**
3. Enter the tunnel IP and port on the right‑hand side
4. Under **Connection Options**, make sure:

```text
Use Steam Relay = unchecked
```

{{< image src="post-img/playit-pz-joinserver.png" alt="Adding the server" >}}

5. Click **Add**
6. Select the server from the list

{{< image src="post-img/playit-pz-serverlist.png" alt="Joining the server" >}}

{{< image src="post-img/playit-pz-connecting.png" alt="Joining the server" >}}

## Server Is Live

The game server will now:

* Serve all game assets
* Apply server settings
* Store player data

To modify server settings, see the **[Project Zomboid Server Wiki](https://pzwiki.net/wiki/Dedicated_server)**.

## Troubleshooting

### Closed Port Warning
{{< image src="post-img/playit-pz-warningclosedport.png" alt="Warning: Closed Port" >}}

If you see a **closed port** warning:

* Double‑check that **Use Steam Relay** is **disabled** in the server list
* Confirm `DefaultPort` and `UDPPort`* match the playit.gg tunnel ports

If using a custom UDP tunnel, `UDPPort` does not apply to you.

## Done
Your Project Zomboid server should now be up and shared using playit.
Loading