This guide covers the pvrserver module in AlphaGSM.
pvrserver is currently PASSED in the checked-in support tracker on the
documented Ubuntu 24.04 Linux baseline. The validated Linux lane uses the
shared steamcmd-linux Docker runtime, and the current GitHub integration
lane validates both process and Docker runtimes for this module while local
runs remain process-backed by default unless you opt into the Docker backend.
Requirements
- Docker for the primary validated runtime path
screen only if you intentionally run the legacy host-process path- SteamCMD runtime libraries (
lib32gcc-s1, lib32stdc++6, libc++1)
- Python packages from
requirements.txt
On current Ubuntu 24.04 hosts, Pavlov VR's Linux dedicated binary needs the
LLVM C++ runtime on the host process path and will fail before readiness if
libc++.so.1 is missing. The shared AlphaGSM steamcmd-linux Docker image
already provides this runtime, so the current smoke and integration lifecycle
validation for pvrserver should run on the Docker runtime backend first. For
host-process runs, install libc++1 first.
Some host installs may also still need the unversioned libc++.so loader
name, so keep the compatibility symlink in place after installing libc++1:
sudo apt install libc++1
sudo ln -sf /lib/x86_64-linux-gnu/libc++.so.1 /lib/x86_64-linux-gnu/libc++.so
Quick Start
Create the server:
alphagsm mypvrserve create pvrserver
Run setup:
alphagsm mypvrserve setup
Start it:
alphagsm mypvrserve start
Check it:
alphagsm mypvrserve status
Stop it:
alphagsm mypvrserve stop
Setup Details
Setup configures:
- the game port (default 7777)
- the status/query helper port (fixed at game port + 400, so 8177 by default)
- the install directory
- SteamCMD downloads the server files
Useful Commands
alphagsm mypvrserve update
alphagsm mypvrserve backup
Notes
- Module name:
pvrserver
- Default game port: 7777
- Default status/query helper port: 8177
Server variables
After create pvrserver, inspect or change these with set:
alphagsm myserver set --list
alphagsm myserver set KEY --describe
alphagsm myserver set KEY VALUE
| Key |
Aliases |
Type |
What it does |
dir |
— |
string |
Install directory for the server. |
exe_name |
— |
string |
Server executable filename. |
map |
gamemap, startmap, level, worldname |
string |
Initial map or workshop scenario. |
port |
gameport |
integer |
Primary gameplay port. |
queryport |
— |
integer |
Derived status-helper port (game port + 400). |
Developer Notes
Run File
- Executable:
PavlovServer.sh
- Location:
<install_dir>/PavlovServer.sh
- Engine: Custom (SteamCMD)
- SteamCMD App ID:
622970
Smoke and integration validation now track readiness through alphagsm info --json
returning protocol udp on Pavlov's status-helper port (port + 400) instead
of waiting for screen-log markers, and the supported validation path uses the
steamcmd-linux Docker runtime image rather than the host process path.
Fresh smoke and focused integration reruns on 2026-05-29 now prove the current
Docker-primary path end to end. AlphaGSM tolerates the known SteamCMD
false-negative where app 622970 reports state is 0x602 after update job
even though PavlovServer.sh is already present, and the supported runtime
path uses the steamcmd-linux Docker image plus the runtime-aware stop hook
for graceful alphagsm stop.
The checked-in module, smoke test, integration test, and docs are now aligned
to the real generic UDP helper-port contract: query, info, and info --json succeed through Pavlov VR's fixed status port at port + 400, so the
older A2S-specific blocker text no longer applies.
Server Configuration
Maps and Mods
- Map directory: Check game documentation
- Mod directory: Check game documentation
- Workshop support: No