From 63b6f77c156272ccb8d31f06300fd7ed8cb2e8b1 Mon Sep 17 00:00:00 2001 From: coderrquitsreality <71231168+coderrquitsreality@users.noreply.github.com> Date: Mon, 3 Aug 2026 02:09:08 -0400 Subject: [PATCH 1/4] Project Zomboid: Add Linux Guide --- content/project-zomboid-linux.md | 193 ++++++++++++++++++ .../project-zomboid-steam-dedicated-server.md | 165 +-------------- content/project-zomboid-windows.md | 164 +++++++++++++++ 3 files changed, 363 insertions(+), 159 deletions(-) create mode 100644 content/project-zomboid-linux.md create mode 100644 content/project-zomboid-windows.md diff --git a/content/project-zomboid-linux.md b/content/project-zomboid-linux.md new file mode 100644 index 0000000..a28ca87 --- /dev/null +++ b/content/project-zomboid-linux.md @@ -0,0 +1,193 @@ ++++ +title = "Setting up Project Zomboid on Linux" +tags = ["project zomboid", "pz", "guide"] +description_file = "descriptions/project-zomboid-steam-dedicated-server.txt" ++++ + +## Prefer to watch a video? +{{< youtube id="ClPNlTIkYb0">}} + +### 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 24.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 +``` + +**Debian** +```bash +sudo apt update; sudo apt install software-properties-common; sudo apt-add-repository non-free; 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: + +```text +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 +``` + +### 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. + +## 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 +```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'. +``` + +## 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. \ No newline at end of file diff --git a/content/project-zomboid-steam-dedicated-server.md b/content/project-zomboid-steam-dedicated-server.md index 060c45c..8b55dc4 100644 --- a/content/project-zomboid-steam-dedicated-server.md +++ b/content/project-zomboid-steam-dedicated-server.md @@ -1,164 +1,11 @@ +++ -title = "Project Zomboid Dedicated Server Guide" +title = "Setting up Project Zomboid with playit.gg" tags = ["project zomboid", "pz", "guide"] -description_file = "descriptions/project-zomboid-steam-dedicated-server.txt" +description_file = "descriptions/project-zomboid-landing.txt" +++ -## Prefer to watch a video? -{{< youtube id="ClPNlTIkYb0">}} +There are two versions of this guide, depending on the type of operating system you are using. -## Setting Everything Up - -Assuming you already own Project Zomboid on Steam, you already have access to the dedicated server software. - -1. Open your **Steam Library** -2. Search for **Project Zomboid** (the server is usually hidden until searched) -3. Install **Project Zomboid Dedicated Server** - -{{< image src="post-img/playit-pz-steam.png" alt="PZ on Steam" >}} - -## Verify the Server Runs - -After installing the server: - -1. **Do not launch it from Steam** -2. Right‑click **Project Zomboid Dedicated Server** -3. Select **Manage → Browse local files** - -{{< image src="post-img/playit-pz-steambrowsefiles.png" alt="PZ on Steam Options" >}} - -The server directory will look similar to this: - -{{< image src="post-img/playit-pz-serverfiles.png" alt="PZ Server Files" >}} - -Both the 32‑bit and 64‑bit versions work: - -* `StartServer32.bat` -* `StartServer64.bat` - -Double‑click either file to start the server once. After it finishes initialization, you can close it. - -## Using playit.gg to Share the Server - -Create and claim a new **playit.gg agent**, then create your first 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 - -Navigate to your Project Zomboid server configuration folder: - -```text -C:\Users\User\Zomboid\Server -``` - -Inside, you will find files like: - -{{< image src="post-img/playit-pz-configfiles.png" alt="PZ Server Config Files" >}} - -### Edit `servertest.ini` - -Open `servertest.ini` and locate: - -```ini -DefaultPort=16261 -``` - -Change this to match the **public port assigned by playit.gg**. - -**Example:** - -```ini -DefaultPort=10233 -``` -{{< image src="post-img/playit-pz-configfile.png" alt="PZ Config File" >}} - -The project zomboid tunnel type will assign you two ports, these ports are sequential so if your public port is `10233`, the second port will be `10234`. - -Update `UDPPort` to match your second port. - -```ini -UDPPort=16262 -``` - -Change it to: - -```ini -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. +## Platform Guides + - Windows: {{< link "project-zomboid-windows.md" >}} + - Linux: {{< link "project-zomboid-linux.md" >}} \ No newline at end of file diff --git a/content/project-zomboid-windows.md b/content/project-zomboid-windows.md new file mode 100644 index 0000000..d6bf86c --- /dev/null +++ b/content/project-zomboid-windows.md @@ -0,0 +1,164 @@ ++++ +title = "Setting up Project Zomboid on Windows" +tags = ["project zomboid", "pz", "guide"] +description_file = "descriptions/project-zomboid-steam-dedicated-server.txt" ++++ + +## Prefer to watch a video? +{{< youtube id="ClPNlTIkYb0">}} + +## Setting Everything Up + +Assuming you already own Project Zomboid on Steam, you already have access to the dedicated server software. + +1. Open your **Steam Library** +2. Search for **Project Zomboid** (the server is usually hidden until searched) +3. Install **Project Zomboid Dedicated Server** + +{{< image src="post-img/playit-pz-steam.png" alt="PZ on Steam" >}} + +## Verify the Server Runs + +After installing the server: + +1. **Do not launch it from Steam** +2. Right‑click **Project Zomboid Dedicated Server** +3. Select **Manage → Browse local files** + +{{< image src="post-img/playit-pz-steambrowsefiles.png" alt="PZ on Steam Options" >}} + +The server directory will look similar to this: + +{{< image src="post-img/playit-pz-serverfiles.png" alt="PZ Server Files" >}} + +Both the 32‑bit and 64‑bit versions work: + +* `StartServer32.bat` +* `StartServer64.bat` + +Double‑click either file to start the server once. After it finishes initialization, you can close it. + +## Using playit.gg to Share the Server + +Create and claim a new **playit.gg agent**, then create your first 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 + +Navigate to your Project Zomboid server configuration folder: + +```text +C:\Users\User\Zomboid\Server +``` + +Inside, you will find files like: + +{{< image src="post-img/playit-pz-configfiles.png" alt="PZ Server Config Files" >}} + +### Edit `servertest.ini` + +Open `servertest.ini` and locate: + +```ini +DefaultPort=16261 +``` + +Change this to match the **public port assigned by playit.gg**. + +**Example:** + +```ini +DefaultPort=10233 +``` +{{< image src="post-img/playit-pz-configfile.png" alt="PZ Config File" >}} + +The project zomboid tunnel type will assign you two ports, these ports are sequential so if your public port is `10233`, the second port will be `10234`. + +Update `UDPPort` to match your second port. + +```ini +UDPPort=16262 +``` + +Change it to: + +```ini +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. \ No newline at end of file From 445ed4ccf44969cec88f411db8265edefb7e62fc Mon Sep 17 00:00:00 2001 From: coderrquitsreality <71231168+coderrquitsreality@users.noreply.github.com> Date: Mon, 3 Aug 2026 02:10:51 -0400 Subject: [PATCH 2/4] Project Zomboid: Add Linux Guide Added descriptors --- descriptions/project-zomboid-landing.txt | 1 + descriptions/project-zomboid-steam-dedicated-server.txt | 2 +- 2 files changed, 2 insertions(+), 1 deletion(-) create mode 100644 descriptions/project-zomboid-landing.txt diff --git a/descriptions/project-zomboid-landing.txt b/descriptions/project-zomboid-landing.txt new file mode 100644 index 0000000..c6a6272 --- /dev/null +++ b/descriptions/project-zomboid-landing.txt @@ -0,0 +1 @@ +How to host a Project Zomboid server \ No newline at end of file diff --git a/descriptions/project-zomboid-steam-dedicated-server.txt b/descriptions/project-zomboid-steam-dedicated-server.txt index d1bb9c3..0594c2a 100644 --- a/descriptions/project-zomboid-steam-dedicated-server.txt +++ b/descriptions/project-zomboid-steam-dedicated-server.txt @@ -1 +1 @@ -Set up and configure a Project Zomboid dedicated server using playit.gg for easy access and port management. \ No newline at end of file +This guide will walk you through how to host a Project Zomboid server through playit.gg \ No newline at end of file From b1084a18f0a0e9d0f46449ff38f14743d9d17316 Mon Sep 17 00:00:00 2001 From: coderrquitsreality <71231168+coderrquitsreality@users.noreply.github.com> Date: Wed, 5 Aug 2026 08:41:41 -0400 Subject: [PATCH 3/4] Project Zomboid: Instruction Revision server files dont exist until installation --- content/project-zomboid-linux.md | 59 ++++++++++++++------------------ 1 file changed, 26 insertions(+), 33 deletions(-) diff --git a/content/project-zomboid-linux.md b/content/project-zomboid-linux.md index a28ca87..3ed6da9 100644 --- a/content/project-zomboid-linux.md +++ b/content/project-zomboid-linux.md @@ -9,7 +9,7 @@ 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 24.04 for this portion of the guide. +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** @@ -18,12 +18,6 @@ sudo add-apt-repository multiverse; sudo dpkg --add-architecture i386; sudo apt sudo apt install steamcmd ``` -**Debian** -```bash -sudo apt update; sudo apt install software-properties-common; sudo apt-add-repository non-free; 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 @@ -68,7 +62,7 @@ At this point, the tunnel will be active, but the game server will **not yet be Although it will work without matching ports, we recommend that you do. Navigate to your Project Zomboid server configuration folder: -```text +```bash cd /root/Zomboid/Server ``` @@ -79,6 +73,29 @@ 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: @@ -109,30 +126,6 @@ UDPPort=10234 ``` Save the file. -## 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 -```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'. -``` - ## Connecting to the Server 1. Start the Project Zomboid server @@ -190,4 +183,4 @@ If you see a **closed port** warning: 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. \ No newline at end of file +Your Project Zomboid server should now be up and shared using playit. From 0b26e9af4f2a3d8bd38d6904f72f1d1f84b4477e Mon Sep 17 00:00:00 2001 From: coderrquitsreality <71231168+coderrquitsreality@users.noreply.github.com> Date: Wed, 5 Aug 2026 23:23:13 -0400 Subject: [PATCH 4/4] Project Zomboid: Remove Video Guide --- content/project-zomboid-linux.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/content/project-zomboid-linux.md b/content/project-zomboid-linux.md index 3ed6da9..21dc977 100644 --- a/content/project-zomboid-linux.md +++ b/content/project-zomboid-linux.md @@ -4,9 +4,6 @@ tags = ["project zomboid", "pz", "guide"] description_file = "descriptions/project-zomboid-steam-dedicated-server.txt" +++ -## Prefer to watch a video? -{{< youtube id="ClPNlTIkYb0">}} - ### 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.